Paramètres et raccourcis
Les paramètres s’ouvrent avec le bouton en forme d’engrenage de la barre de titre. Sous macOS, le menu de l’application propose aussi « Paramètres… » (⌘,) ; sous Windows et Linux, appuyez sur Alt et choisissez Fichier ▸ Paramètres… La fenêtre des paramètres comporte huit catégories : Général, Apparence, Terminal, Vue de conversation, Comportement, Avancé, Agents et Raccourcis. Ce chapitre décrit chaque réglage et se termine par les raccourcis clavier par défaut. Les paramètres sont partagés entre l’application de bureau et les clients navigateur qui y sont connectés.

1. Général
| Réglage | Description |
|---|---|
| Langue | Langue de l’interface. « Auto (système) » suit la langue du système ; onze langues sont disponibles |
| Son de notification | Son des notifications (activé par défaut) |
| System notifications | Active ou désactive les notifications système (activé par défaut). Si le système n’a pas encore autorisé les notifications, « Allow notifications » demande l’autorisation ; si elles sont bloquées, les étapes propres à votre système s’affichent |
| Commande shell | Application de bureau macOS uniquement : « Installer la commande ‘vela’ » ajoute vela <project-path> à votre shell ; cette commande ouvre un projet dans VelaTerm. « Désinstaller la commande ‘vela’ » la supprime |
| Vela Skills | « Install » (puis « Reinstall ») installe les compétences VelaTerm pour Claude Code et Codex, telles que /vspawn et $vspawn. Démarrez une nouvelle session Codex si Codex ne les affiche pas. Voir Commandes de session, §2 |
2. Apparence
| Réglage | Description |
|---|---|
| Accent | Couleur d’accentuation : « Suivre le thème » ou l’une des quatre couleurs proposées |
| Densité | « Compacte », « Normale » (par défaut) ou « Aérée » |
| Volets | Style des volets : « Sans bord » (par défaut) ou « Carte » |
| Séparateur | « Fin » (par défaut) ou « Visible » |
| Barre latérale | « Arbre » (par défaut) ou « Compacte » |
| Interface font | Police de l’interface |
| Interface size | Taille de police de l’interface ; « Auto » suit la densité |
Le thème clair et le thème sombre se choisissent dans la barre de titre (suivre le système, sombre, clair), et non ici. Les sessions Claude en cours d’exécution dans la vue terminal suivent le changement de thème sans redémarrage.
3. Terminal
| Réglage | Description |
|---|---|
| Collage d’image | « Coller le chemin » (par défaut) enregistre une image collée dans un fichier temporaire et insère son chemin. « Collage natif » permet à Claude Code ou à Codex de lire l’image dans le presse-papiers ; cette option n’est disponible que dans l’application de bureau locale |
| Suggestions de commandes | « Automatiques », « Avec Tab » ou « Désactivées ». S’applique immédiatement, y compris aux terminaux déjà ouverts ; masqué lorsque la fonction n’est pas prise en charge. Voir Suggestions de commandes |
| Shell par défaut | Shell des nouveaux terminaux. Affiché sous Windows, où plusieurs shells sont disponibles ; macOS et Linux utilisent toujours le shell du système |
| Terminal font | Police du terminal |
| Terminal size | Taille de police du terminal (13 par défaut). ⌘+ / ⌘- / ⌘0 permettent de la modifier en cours de travail |
| Interligne du terminal | Interligne du terminal (1,2× par défaut) |
4. Vue de conversation
Ces paramètres s’appliquent à la vue conversation des sessions d’agent ; voir Vue conversation.
| Réglage | Description |
|---|---|
| Police de la conversation, Taille de police de la conversation, Interligne de la conversation | Typographie de la conversation, indépendante des réglages du terminal (taille par défaut : 13,5 ; interligne par défaut : 1,2×) |
| Barre d’outils de saisie | Contrôles affichés à côté de la zone de message, et leur ordre : Modèle, Effort de réflexion, Mode de collaboration, Mode d’autorisation, Mode rapide, Vitesse, Ton, Serveurs MCP, Tâches en arrière-plan, Compte et Crédits de réinitialisation Codex. Chaque contrôle dispose d’un interrupteur ; les flèches permettent de réordonner les contrôles activés. Modèle, Effort de réflexion, Mode de collaboration et Mode d’autorisation sont activés par défaut |
Les contrôles que l’agent ou le modèle actuel ne prend pas en charge ne sont pas affichés. Un contrôle pris en charge reste visible lorsque sa fonction est temporairement indisponible, par exemple Serveurs MCP et Tâches en arrière-plan lorsque le processus de l’agent est arrêté.
Les contrôles désactivés, ainsi que ceux qui ne tiennent pas à côté de la zone de message, se trouvent dans le menu Plus ; vous pouvez ainsi utiliser tout contrôle pris en charge sans l’activer au préalable ici. Le menu Plus n’est pas affiché lorsque tous les contrôles pris en charge sont activés et tiennent dans la barre. Un contrôle désactivé puis réactivé est placé à la fin de la ligne. Sur mobile, les contrôles désactivés apparaissent sur une seconde ligne.
5. Comportement
| Réglage | Description |
|---|---|
| Onglets | « Unique » (par défaut) réutilise l’onglet actif lorsque vous ouvrez une session d’agent et maintient l’onglet précédent en arrière-plan. « Multiples » ouvre chaque session dans son propre onglet |
| Ajout dynamique au filtre d’état | Lorsqu’un filtre d’état de la barre latérale est actif, les sessions qui commencent à correspondre y sont ajoutées (activé par défaut) |
| Background limit | Affiché en mode Unique : nombre maximal d’onglets en arrière-plan (8, 16, 32 ou 64 ; 32 par défaut). Au-delà de cette limite, l’onglet inactif le plus ancien en arrière-plan est fermé |
| Confirm before spawn | Affiche une carte de confirmation avant le démarrage d’une session enfant (activé par défaut) ; voir Création de sessions et collaboration dans Git, §4 |
| Usage auto-refresh | Maintient à jour l’utilisation du compte dans le panneau Infos (activé par défaut) |
| Usage refresh | Intervalle d’actualisation : 30 s, 1 min, 2 min ou 5 min (5 min par défaut) |
| Reprendre après réinitialisation | Reprend automatiquement une tâche Claude ou Codex après la réinitialisation d’une limite d’utilisation de cinq heures ou hebdomadaire (activé par défaut) |
| Nettoyer automatiquement les images collées | Supprime les fichiers temporaires des images collées à la fermeture de l’application, ainsi que les fichiers datant de plus de 24 heures au démarrage (activé par défaut). « Nettoyer maintenant » les supprime immédiatement |
Contexte des références de session détermine la façon dont vrefer --ask (et la compétence vask) transmet la conversation d’une autre session à l’agent qui répond. « Transcription intégrale » (par défaut) transmet toute la conversation. « Résumer d’abord » la condense au préalable avec l’« Agent de synthèse », le modèle et l’effort sélectionnés ici. Voir Commandes de session, §5.
6. Avancé
| Réglage | Description |
|---|---|
| Moteur de rendu du terminal | « DOM » (par défaut) ou « WebGL ». Conservez la valeur par défaut, sauf si vous avez une raison précise de la modifier |
| Redessiner au changement d’onglet | Redessine entièrement un terminal lorsque vous revenez à son onglet (désactivé par défaut). Activez ce réglage si l’affichage des interfaces de terminal est parfois altéré après un changement d’onglet |
| Sortie prioritaire au premier plan | Préserve la réactivité de la saisie lorsque des agents d’autres onglets produisent une grande quantité de sortie (activé par défaut) |
| Enregistrer les journaux de session | Enregistre la sortie de terminal des sessions d’agent dans un fichier journal (désactivé par défaut). Lorsque ce réglage est activé, les sessions archivées peuvent être rejouées et la recherche globale porte aussi sur la sortie des terminaux. Les sessions de terminal classiques ne sont jamais enregistrées |
7. Agents
Les « Valeurs par défaut des nouvelles sessions » s’appliquent aux sessions nouvellement créées de l’agent sélectionné. Les réglages définis pour une session donnée sont prioritaires, à l’exception du chemin de l’exécutable, qui s’applique toujours à l’ensemble du type d’agent.

| Réglage | Description |
|---|---|
| Type d’agent | Agent dont vous modifiez les valeurs par défaut |
| Chemin de l’exécutable (facultatif) | Chemin complet de l’exécutable de l’agent. Lorsque ce champ est vide, la commande est recherchée dans le PATH. Il est renseigné automatiquement après une installation en un clic réussie |
| Arguments de lancement (optionnel) | Arguments de ligne de commande par défaut, par exemple --model opus |
| Permission | Autorisation par défaut des nouvelles sessions. Claude, Codex et OpenCode proposent leurs modes nommés ; la plupart des autres agents proposent « Défaut » et « YOLO » (ignorer toutes les confirmations de permission) ; Pi ne demande aucune autorisation. Voir Sessions d’agent IA, §6 |
| Vue par défaut | Pour Claude, Codex, OpenCode, Pi et OMP : « Vue conversation » (par défaut) ou « Vue terminal » pour les nouvelles sessions. Les sessions existantes conservent leur vue |
8. Raccourcis

Cliquez sur la combinaison de touches d’une action, puis appuyez sur la nouvelle combinaison ; Échap annule la modification. Une combinaison se compose d’une lettre associée à ⌘ (dans l’application de bureau macOS) ou à Ctrl, éventuellement avec Maj et Option/Alt. Si la combinaison est déjà utilisée, le message indique l’action concernée. « Rétablir les valeurs par défaut » réinitialise tous les raccourcis.
| Action | Application de bureau macOS | Windows, Linux |
|---|---|---|
| Ouvrir un projet | ⌘O | Ctrl+Alt+O |
| Nouveau terminal | ⌘T | Ctrl+Alt+T |
| Nouvelle session d’agent | ⌘N | Ctrl+Alt+N |
| Nouvel onglet navigateur (application de bureau uniquement) | ⌘⇧B | Ctrl+Alt+B |
| Diviser à droite | ⌘D | Ctrl+Alt+D |
| Diviser en bas | ⌘⇧D | Ctrl+Alt+E |
| Fermer le volet / l’onglet | ⌘W | Ctrl+Alt+W |
| Rechercher dans le terminal | ⌘F | Ctrl+Alt+F |
| Rechercher dans toutes les sessions | ⌘⇧F | Ctrl+Alt+G |
| Enregistrer le document | ⌘S | Ctrl+S |
Navigateurs web standard. Lorsque vous utilisez VelaTerm dans un navigateur web standard (accès distant par URL), le navigateur lui-même utilise de nombreuses combinaisons avec ⌘ et Ctrl ; les raccourcis Windows et Linux ci-dessus s’appliquent donc sur tous les systèmes, et la page des paramètres les présente ainsi. Les navigateurs sous macOS font exception : la division à droite et la division en bas y restent ⌘D et ⌘⇧D. Les fenêtres de connexion à distance de l’application de bureau utilisent les raccourcis de l’application de bureau.
Touches fixes, non modifiables : ⌘1–9 permet de changer d’onglet, et ⌘+ / ⌘- / ⌘0 modifie ou réinitialise la taille de police du terminal (Ctrl sous Windows, sous Linux et dans les navigateurs).
9. Sélecteur de nouvelle session d’agent
« Nouvelle session d’agent » ouvre une liste de types d’agent et de préréglages enregistrés, avec recherche (« Rechercher des agents et des préréglages »). Les choix utilisés récemment apparaissent en premier et portent la mention « Dernier choix ».
Le sélecteur indique l’emplacement où la session sera créée. Lorsqu’une session enregistrée est active, choisissez « Même niveau » pour créer la nouvelle session à côté d’elle, ou « Session enfant » pour la créer sous elle. Lorsque le champ de recherche a le focus :
- Tab bascule entre « Même niveau » et « Session enfant ».
- ↑ et ↓ sélectionnent un résultat ; Entrée crée la session.
- Maj+Tab déplace le focus vers le contrôle précédent ; Échap ferme le sélecteur.
Vous pouvez aussi cliquer sur un résultat et choisir « Créer ». Si aucun projet n’est disponible, sélectionnez-en un ou utilisez d’abord « Ouvrir un projet ».
Le sélecteur dispose de sa propre adresse, qui conserve la cible, la position, le texte recherché et la sélection. Copier le lien, actualiser la page ou utiliser les boutons Précédent et Suivant restaure le sélecteur sans créer de session. Si la création échoue, le sélecteur reste ouvert pour vous permettre de réessayer.
10. Autres touches
| Emplacement | Touche | Action |
|---|---|---|
| Vue conversation | Entrée / Maj+Entrée | Envoyer / aller à la ligne |
| Vue conversation, pendant que l’agent travaille | ⌥Entrée (Alt+Entrée) | Ajouter le message au tour en cours |
| Vue conversation, pendant que l’agent travaille | ⌘Entrée (Ctrl+Entrée) | Arrêter le tour et envoyer ce message |
| Vue conversation, pendant que l’agent travaille | Échap | Arrêter le tour |
| Carte de confirmation de création de session | ⌘Entrée (Ctrl+Entrée) | Démarrer la session |
| Barre d’onglets | Clic avec le bouton central | Fermer l’onglet |
| Barre latérale | ⌘/Ctrl-clic, Maj-clic | Sélectionner plusieurs sessions, ou une plage |