Manuel de l’utilisateur

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.

Paramètres · Apparence

1. Général

RéglageDescription
LangueLangue de l’interface. « Auto (système) » suit la langue du système ; onze langues sont disponibles
Son de notificationSon des notifications (activé par défaut)
System notificationsActive 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 shellApplication 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églageDescription
AccentCouleur d’accentuation : « Suivre le thème » ou l’une des quatre couleurs proposées
Densité« Compacte », « Normale » (par défaut) ou « Aérée »
VoletsStyle 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 fontPolice de l’interface
Interface sizeTaille 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églageDescription
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éfautShell des nouveaux terminaux. Affiché sous Windows, où plusieurs shells sont disponibles ; macOS et Linux utilisent toujours le shell du système
Terminal fontPolice du terminal
Terminal sizeTaille de police du terminal (13 par défaut). ⌘+ / ⌘- / ⌘0 permettent de la modifier en cours de travail
Interligne du terminalInterligne 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églageDescription
Police de la conversation, Taille de police de la conversation, Interligne de la conversationTypographie 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 saisieContrô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églageDescription
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’étatLorsqu’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 limitAffiché 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 spawnAffiche 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-refreshMaintient à jour l’utilisation du compte dans le panneau Infos (activé par défaut)
Usage refreshIntervalle d’actualisation : 30 s, 1 min, 2 min ou 5 min (5 min par défaut)
Reprendre après réinitialisationReprend 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éesSupprime 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églageDescription
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’ongletRedessine 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 planPré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 sessionEnregistre 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.

Paramètres · Agents

RéglageDescription
Type d’agentAgent 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
PermissionAutorisation 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éfautPour 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

Paramètres · 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.

ActionApplication de bureau macOSWindows, Linux
Ouvrir un projet⌘OCtrl+Alt+O
Nouveau terminal⌘TCtrl+Alt+T
Nouvelle session d’agent⌘NCtrl+Alt+N
Nouvel onglet navigateur (application de bureau uniquement)⌘⇧BCtrl+Alt+B
Diviser à droite⌘DCtrl+Alt+D
Diviser en bas⌘⇧DCtrl+Alt+E
Fermer le volet / l’onglet⌘WCtrl+Alt+W
Rechercher dans le terminal⌘FCtrl+Alt+F
Rechercher dans toutes les sessions⌘⇧FCtrl+Alt+G
Enregistrer le document⌘SCtrl+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

EmplacementToucheAction
Vue conversationEntrée / Maj+EntréeEnvoyer / 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ÉchapArrêter le tour
Carte de confirmation de création de session⌘Entrée (Ctrl+Entrée)Démarrer la session
Barre d’ongletsClic avec le bouton centralFermer l’onglet
Barre latérale⌘/Ctrl-clic, Maj-clicSélectionner plusieurs sessions, ou une plage