| Command | Objectif |
|---|
copilot | Lancez l’interface utilisateur interactive. |
copilot help [topic] | Affichez les informations d’aide. Les rubriques d’aide incluent : , , , , et . |
copilot init | Initialisez les instructions personnalisées de Copilot pour ce référentiel. |
copilot update | Téléchargez et installez la dernière version. |
copilot version | Affichez les informations de version et recherchez les mises à jour. |
copilot login | Authentifiez-vous avec Copilot via le flux de dispositif OAuth. Accepte de spécifier l’URL de l’hôte GitHub (par défaut : ). |
copilot logout | Déconnectez-vous de GitHub et supprimez les informations d’identification stockées. |
copilot plugin | Gérez les plug-ins et les places de marché de plug-ins. |
| Shortcut | Objectif |
|---|
@ FILENAME | Incluez le contenu du fichier dans le contexte. |
| CtrlX puis | Après avoir commencé à saisir un prompt, cela vous permet d’exécuter une commande slash. Par exemple, si vous souhaitez modifier le modèle sans avoir à retaper votre prompt. |
| Échap | Annulez l’opération actuelle. |
! COMMAND | Exécutez une commande dans votre shell local, en contournant Copilot. |
| CtrlC | Annuler l’opération / effacer la saisie. Appuyez deux fois pour quitter. |
| CtrlD | Arrêt. |
| CtrlL | Effacez l’écran. |
| MajTab | Alternez entre le mode standard, plan et pilote automatique. |
| Shortcut | Objectif |
|---|
| ctrl+o | Lorsqu’il n’y a rien dans l’entrée du prompt, cela développe les éléments récents dans la chronologie des réponses de Copilot pour afficher plus de détails. |
| ctrl+e | Lorsqu’il n’y a rien dans l’entrée du prompt, cela développe tous les éléments dans la chronologie des réponses de Copilot. |
| ctrl+t | Développer/réduire l’affichage du raisonnement dans les réponses. |
| Shortcut | Objectif |
|---|
| CtrlUn | Passez au début de la ligne (lors de la saisie). |
| CtrlB | Passez au caractère précédent. |
| CtrlE | Passez à la fin de la ligne (lors de la saisie). |
| CtrlF | Passez au caractère suivant. |
| CtrlG | Modifiez l’invite dans un éditeur externe. |
| CtrlH | Supprimez le caractère précédent. |
| CtrlK | Supprimez depuis le curseur jusqu’à la fin de la ligne. |
| CtrlU | Supprimer depuis le curseur jusqu'au début de la ligne. |
| CtrlW | Supprimez le mot précédent. |
| Accueil | Passez au début de la ligne actuelle. |
| Fin | Déplacez-vous à la fin de la ligne actuelle. |
| CtrlDébut | Accédez au début du texte. |
| CtrlFin | Passez à la fin du texte. |
| Meta←→ | Déplacez le curseur par un mot. |
| ↑↓ | Naviguez dans l’historique des commandes. |
| Command | Objectif |
|---|
/add-dir PATH | Ajoutez un répertoire à la liste autorisée pour l’accès aux fichiers. |
/agent | Parcourez et sélectionnez parmi les agents disponibles (le cas échéant). |
| , | Activez toutes les autorisations (outils, chemins et URL). |
| , | Effacez l’historique des conversations. |
/compact | Résumez l’historique des conversations pour réduire l’utilisation de la fenêtre de contexte. |
/context | Afficher l’utilisation et la visualisation des jetons de fenêtre de contexte. |
| , | Modifiez le répertoire de travail ou affichez le répertoire actif. |
/delegate [PROMPT] | Déléguer les modifications à un référentiel distant avec une requête de tirage générée par l’IA. |
/diff | Passez en revue les modifications apportées dans le répertoire actif. |
| , | Quittez l’interface CLI. |
/experimental [on|off] | Activer/désactiver les fonctionnalités expérimentales. |
/feedback | Fournissez des commentaires sur l’interface CLI. |
/fleet [PROMPT] | Activez l’exécution parallèle des sous-éléments d’une tâche. Consultez « AUTOTITLE ». |
/help | Affichez l’aide pour les commandes interactives. |
/ide | Connectez-vous à un espace de travail IDE. |
/init | Initialisez les instructions personnalisées et les fonctionnalités agentiques de Copilot pour ce référentiel. |
/list-dirs | Affichez tous les répertoires pour lesquels l’accès au fichier a été autorisé. |
/login | Connectez-vous à Copilot. |
/logout | Déconnectez-vous de Copilot. |
/lsp [show|test|reload|help] [SERVER-NAME] | Gérez la configuration du serveur de langue. |
/mcp [show|add|edit|delete|disable|enable] [SERVER-NAME] | Gérez la configuration du serveur MCP. |
| , | Sélectionnez le modèle IA que vous souhaitez utiliser. |
/plan [PROMPT] | Créez un plan d’implémentation avant de coder. |
/plugin [marketplace|install|uninstall|update|list] [ARGS...] | Gérez les plug-ins et les places de marché de plug-ins. |
/rename NAME | Renommez la session active (alias pour ). |
/reset-allowed-tools | Réinitialisez la liste des outils autorisés. |
/resume [SESSION-ID] | Basculez vers une autre session en choisissant dans une liste (spécifiez éventuellement un ID de session). |
/review [PROMPT] | Exécutez l’agent de révision de code pour analyser les modifications. |
/session [checkpoints [n]|files|plan|rename NAME] | Afficher les informations de session et un résumé de l’espace de travail. Utilisez les sous-commandes pour plus d’informations. |
/share [file|gist] [PATH] | Partagez la session dans un fichier Markdown ou GitHub gist. |
/skills [list|info|add|remove|reload] [ARGS...] | Gérez les compétences afin d'améliorer les capacités. |
/terminal-setup | Configurez le terminal pour la prise en charge des entrées multilignes (MajEntrée et CtrlEntrée). |
/theme [show|set|list] [auto|THEME-ID] | Affichez ou configurez le thème du terminal. |
/usage | Affichez les métriques et statistiques d’utilisation de session. |
/user [show|list|switch] | Gérez l’utilisateur actuel GitHub. |
Pour obtenir la liste complète des commandes de barre oblique disponibles, entrez dans l’interface interactive de l’interface CLI.
| Choix | Objectif |
|---|
--acp | Démarrez le serveur de protocole client agent. |
--add-dir PATH | Ajoutez un répertoire à la liste autorisée pour l’accès aux fichiers (peut être utilisé plusieurs fois). |
--add-github-mcp-tool TOOL | Ajoutez un outil permettant d’activer le serveur GitHub MCP, au lieu du sous-ensemble CLI par défaut (peut être utilisé plusieurs fois). Utiliser pour tous les outils. |
--add-github-mcp-toolset TOOLSET | Ajoutez un ensemble d’outils pour activer le serveur GitHub MCP, au lieu du sous-ensemble CLI par défaut (peut être utilisé plusieurs fois). Utiliser pour tous les ensembles d’outils. |
--additional-mcp-config JSON | Ajoutez un serveur MCP pour cette session uniquement. La configuration du serveur peut être fournie sous la forme d’une chaîne JSON ou d’un chemin d’accès de fichier (préfixe avec ). Optimisez la configuration de . Remplace toute configuration de serveur MCP installée avec le même nom. |
--agent AGENT | Spécifiez un assistant personnalisé à utiliser. |
--allow-all | Activez toutes les autorisations (équivalentes à ). |
--allow-all-paths | Désactivez la vérification du chemin d’accès du fichier et autorisez l’accès à n’importe quel chemin d’accès. |
--allow-all-tools | Autoriser l’exécution automatique de tous les outils sans confirmation. Obligatoire lors de l’utilisation de l’interface CLI par programmation (env : ). |
--allow-all-urls | Autoriser l’accès à toutes les URL sans confirmation. |
--allow-tool [TOOLS...] | Les outils que l’interface CLI dispose de l’autorisation d’utiliser. Ne demande pas l’autorisation. |
--allow-url [URLS...] | Autoriser l’accès à des URL ou domaines spécifiques. |
--alt-screen [VALUE] | Utilisez la mémoire tampon d’écran de remplacement du terminal ( ou ). |
--autopilot | Activez la poursuite de l’autopilot en mode prompt. Consultez « AUTOTITLE ». |
--available-tools [TOOLS...] | Seuls ces outils seront disponibles pour le modèle. |
--banner | Affichez la bannière de démarrage. |
--bash-env [VALUE] | Activez la prise en charge de pour les interpréteurs de commandes Bash ( ou ). |
--config-dir PATH | Définissez le répertoire de configuration (par défaut : ). |
--continue | Reprendre la session la plus récente. |
--deny-tool [TOOLS...] | Les outils que l’interface CLI n’a pas l’autorisation d’utiliser. Ne demande pas l’autorisation. |
--deny-url [URLS...] | Refuser l’accès à des URL ou domaines spécifiques est prioritaire sur . |
--disable-builtin-mcps | Désactivez tous les serveurs MCP intégrés (actuellement : ). |
--disable-mcp-server SERVER-NAME | Désactivez un serveur MCP spécifique (peut être utilisé plusieurs fois). |
--disable-parallel-tools-execution | Désactivez l’exécution parallèle d’outils (LLM peut toujours effectuer des appels d’outils parallèles, mais ils seront exécutés séquentiellement). |
--disallow-temp-dir | Empêchez l’accès automatique au répertoire temporaire système. |
--enable-all-github-mcp-tools | Activez tous GitHub outils serveur MCP, au lieu du sous-ensemble CLI par défaut. Remplace les options et . |
--excluded-tools [TOOLS...] | Ces outils ne seront pas disponibles pour le modèle. |
--experimental | Activer les fonctionnalités expérimentales (utiliser pour désactiver). |
| , | Afficher l'aide. |
| , | Démarrez une session interactive et exécutez automatiquement cette invite. |
--log-dir DIRECTORY | Définissez le répertoire du fichier journal (par défaut : ). |
--log-level LEVEL | Définissez le niveau de journalisation (choix : , , , , , , ). |
--max-autopilot-continues COUNT | Nombre maximal de messages de continuation en mode Autopilot (valeur par défaut : illimitée). Consultez « AUTOTITLE ». |
--model MODEL | Définissez le modèle IA que vous souhaitez utiliser. |
--no-alt-screen | Désactivez la mémoire tampon d’écran de remplacement du terminal. |
--no-ask-user | Désactivez l’outil (l’agent fonctionne de manière autonome sans poser de questions). |
--no-auto-update | Désactivez le téléchargement automatique des mises à jour CLI. |
--no-bash-env | Désactivez la prise en charge de pour les interpréteurs de commandes Bash. |
--no-color | Désactivez toutes les sorties de couleur. |
--no-custom-instructions | Désactivez le chargement d'instructions personnalisées de et des fichiers associés. |
--no-experimental | Désactivez les fonctionnalités expérimentales. |
| , | Exécutez un prompt de manière programmatique (quitte après l’exécution). |
--plain-diff | Désactivez le rendu des différences enrichies (mise en surbrillance de la syntaxe via l’outil de différences spécifié par votre configuration Git). |
--resume [SESSION-ID] | Reprenez une session interactive précédente en choisissant dans une liste (spécifiez éventuellement un ID de session). |
| , | Affichez uniquement la réponse de l’agent (sans statistiques d’utilisation), utile pour l’écriture de scripts avec . |
--screen-reader | Activez les optimisations du lecteur d’écran. |
--share [PATH] | Partagez une session dans un fichier Markdown après l’achèvement d’une session programmatique (chemin d’accès par défaut : ). |
--share-gist | Partagez une session dans un gist secret GitHub après l’exécution d’une session programmatique. |
--stream MODE | Activer ou désactiver le mode de diffusion en continu (choix de mode : ou ). |
| , | Afficher les informations de version. |
--yolo | Activez toutes les autorisations (équivalentes à ). |
Pour obtenir la liste complète des commandes et des options, exécutez .
Les options et acceptent les modèles d’autorisation au format . L’argument est facultatif : l'omission concerne tous les outils de ce type.
| Type | Descriptif | Exemples de modèles |
|---|
shell | Exécution de commandes shell | , , |
write | Création ou modification de fichier | , |
read | Lectures de fichiers ou de répertoires | , |
| SERVER-NAME | Appel de l’outil serveur MCP | , |
url | Accès URL via web-fetch ou via le shell | , |
memory | Stockage des faits dans la mémoire de l’agent | memory |
Pour les règles, le suffixe correspond à la tige de commande suivie d’un espace, ce qui empêche les correspondances partielles. Par exemple, correspond et ne correspond pas.
Les règles de refus sont toujours prioritaires sur les règles d’autorisation, même lorsque est défini.
# Allow all git commands except git push
copilot --allow-tool 'shell(git:*)' --deny-tool 'shell(git push)'
# Allow a specific MCP server tool
copilot --allow-tool 'MyMCP(create_issue)'
# Allow all tools from a server
copilot --allow-tool 'MyMCP'
| Variable | Descriptif |
|---|
COPILOT_MODEL | Définissez le modèle IA. |
COPILOT_ALLOW_ALL | Définir sur pour autoriser toutes les autorisations automatiquement (équivalent à ). |
COPILOT_AUTO_UPDATE | Définissez sur pour désactiver les mises à jour automatiques. |
COPILOT_CUSTOM_INSTRUCTIONS_DIRS | Liste séparée par des virgules de répertoires supplémentaires pour obtenir des instructions personnalisées. |
COPILOT_SKILLS_DIRS | Liste séparée par des virgules de répertoires supplémentaires pour les compétences. |
COPILOT_EDITOR | Commande de l’éditeur pour la modification interactive (cochée après et ). Par défaut, si aucun n’est défini. |
COPILOT_GITHUB_TOKEN | Jeton d’authentification. Prend la priorité sur et . |
GH_TOKEN | Jeton d’authentification. Est prioritaire sur . |
GITHUB_TOKEN | Jeton d’authentification. |
XDG_CONFIG_HOME | Remplacez le répertoire de configuration. Par défaut : . |
XDG_STATE_HOME | Remplacez le répertoire d’état. Par défaut : . |
USE_BUILTIN_RIPGREP | Définir à , pour utiliser le ripgrep du système au lieu de la version groupée. |
PLAIN_DIFF | Définissez sur pour désactiver le rendu des différences enrichies. |
COLORFGBG | Solution de repli pour la détection de terminal à arrière-plan clair/foncé. |
COPILOT_CLI_ENABLED_FEATURE_FLAGS | Liste séparée par des virgules des indicateurs de fonctionnalité à activer (par exemple). |
Les paramètres utilisateur sont stockés dans . Les paramètres au niveau du projet peuvent être placés dans le référentiel (validés) ou (remplacements personnels, ajouter à ). Les paramètres se propagent de l'utilisateur au projet au niveau local, avec des étendues plus spécifiques prenant le pas sur des étendues plus générales. Les indicateurs de ligne de commande et les variables d’environnement sont toujours prioritaires.
| Clé | Type | Par défaut | Descriptif |
|---|
allowed_urls | string[] | [] | URL ou domaines autorisés sans invite. |
alt_screen | boolean | false | Utilisez la mémoire tampon d’écran de remplacement du terminal. |
auto_update | boolean | true | Téléchargez automatiquement les mises à jour cli. |
banner | "always" | "once" | "never" | "once" | Fréquence d’affichage de bannière animée. |
bash_env | boolean | false | Activez la prise en charge des interpréteurs de commandes bash. |
beep | boolean | true | Émettez un bip sonore lorsque l'attention est nécessaire. |
compact_paste | boolean | true | Convertissez les collages de données volumineux en éléments compacts. |
custom_agents.default_local_only | boolean | false | Utilisez uniquement des agents personnalisés locaux. |
denied_urls | string[] | [] | URL ou domaines bloqués (précédence sur ). |
experimental | boolean | false | Activer les fonctionnalités expérimentales. |
include_coauthor | boolean | true | Ajoutez une bande-annonce aux validations Git effectuées par l’agent. |
launch_messages | string[] | [] | Messages personnalisés affichés de manière aléatoire au démarrage. |
log_level | "none" | "error" | "warning" | "info" | "debug" | "all" | "default" | "default" | Niveau de verbosité de la journalisation. |
model | string | varies | Modèle IA à utiliser (voir la commande). |
reasoning_effort | "low" | "medium" | "high" | "xhigh" | "medium" | Niveau d’effort de raisonnement pour la pensée approfondie. Les niveaux supérieurs utilisent davantage de calcul. |
render_markdown | boolean | true | Affichez Markdown dans la sortie du terminal. |
screen_reader | boolean | false | Activez les optimisations du lecteur d’écran. |
stream | boolean | true | Activez les réponses de diffusion en continu. |
store_token_plaintext | boolean | false | Stockez les jetons d’authentification en texte clair dans le fichier config lorsqu’aucun trousseau système n’est disponible. |
streamer_mode | boolean | false | Masquer les noms de modèles d’aperçu et les informations sur le quota (utile lors de l’enregistrement). |
theme | "auto" | "dark" | "light" | "auto" | Thème de couleur du terminal. |
trusted_folders | string[] | [] | Dossiers ayant un accès aux fichiers pré-autorisé. |
update_terminal_title | boolean | true | Afficher l’intention actuelle dans le titre du terminal. |
Les hooks sont des commandes externes qui s’exécutent à des points de cycle de vie spécifiques pendant une session, ce qui permet l’automatisation personnalisée, les contrôles de sécurité et les intégrations. Les fichiers de configuration de "hook" sont chargés automatiquement depuis de votre référentiel.
Les fichiers de configuration de hook utilisent le format JSON avec la version :
{
"version": 1,
"hooks": {
"preToolUse": [
{
"type": "command",
"bash": "your-bash-command",
"powershell": "your-powershell-command",
"cwd": "optional/working/directory",
"env": { "VAR": "value" },
"timeoutSec": 30
}
]
}
}
| Champ | Type | Obligatoire | Descriptif |
|---|
type | "command" | Oui | Doit être . |
bash | ficelle | L'un de | Commande Shell pour Unix. |
powershell | ficelle | L'un de | Commande Shell pour Windows. |
cwd | ficelle | Non | Répertoire de travail de la commande (par rapport à la racine du référentiel ou absolu). |
env | objet | Non | Variables d’environnement à définir (prend en charge l’expansion des variables). |
timeoutSec | nombre | Non | Délai d’expiration en secondes. Par défaut : . |
| Événement | Se déclenche quand | Sortie traitée |
|---|
sessionStart | Une session nouvelle ou reprise commence. | Non |
sessionEnd | La session se termine. | Non |
userPromptSubmitted | L’utilisateur envoie une invite. | Non |
preToolUse | Avant l’exécution de chaque outil. | Oui : peut autoriser, refuser ou modifier. |
postToolUse | Une fois chaque outil terminé. | Non |
agentStop | L’agent principal termine un tour. | Oui : peut bloquer et forcer la continuation. |
subagentStop | Un sous-agent s'achève. | Oui : peut bloquer et forcer la continuation. |
errorOccurred | Une erreur se produit pendant l’exécution. | Non |
Le hook peut contrôler l’exécution de l’outil en écrivant un objet JSON dans stdout.
| Champ | Valeurs | Descriptif |
|---|
permissionDecision | , , | Indique si l’outil s’exécute. La sortie vide utilise le comportement par défaut. |
permissionDecisionReason | ficelle | Raison indiquée à l’agent. Obligatoire lorsque la décision est . |
modifiedArgs | objet | Remplacez les arguments de l’outil à utiliser au lieu des arguments d’origine. |
| Champ | Valeurs | Descriptif |
|---|
decision | , | oblige un autre agent à réagir en utilisant comme invite. |
reason | ficelle | Demander le tour suivant quand est . |
| Nom de l’outil | Descriptif |
|---|
bash | Exécuter des commandes shell (Unix). |
powershell | Exécuter des commandes shell (Windows). |
view | Lire le contenu du fichier. |
edit | Modifiez le contenu du fichier. |
create | Créez des fichiers. |
glob | Recherchez des fichiers par modèle. |
grep | Rechercher le contenu du fichier. |
web_fetch | Récupérer des pages web. |
task | Exécutez des tâches de sous-agent. |
Si plusieurs hooks du même type sont configurés, ils s'exécutent dans l'ordre. Pour , si un crochet retourne , l’outil est bloqué. Les échecs de hook (codes de sortie non nuls ou délais d’expiration) sont enregistrés et ignorés. Ils ne bloquent jamais l’exécution de l’agent.
Les serveurs MCP fournissent des outils supplémentaires à l’agent CLI. Configurer des serveurs persistants dans . Permet d’ajouter des serveurs pour une seule session.
| Type | Descriptif | Champs obligatoires |
|---|
local / stdio | Processus local de communication via stdin/stdout. | , |
http | Serveur distant utilisant le transport HTTP par diffusion en continu. | url |
sse | Un serveur distant utilisant le transport d'événements envoyés par le serveur. | url |
| Champ | Obligatoire | Descriptif |
|---|
command | Oui | Commande pour démarrer le serveur. |
args | Oui | Arguments de commande (tableau). |
tools | Oui | Outils à activer : pour tous ou une liste de noms d’outils spécifiques. |
env | Non | Variables d'environnement. Prend en charge , et expansion. |
cwd | Non | Répertoire de travail du serveur. |
timeout | Non | Délai d’expiration des appels de l’outil en millisecondes. |
type | Non | ou . Par défaut : . |
| Champ | Obligatoire | Descriptif |
|---|
type | Oui | ou . |
url | Oui | URL du serveur. |
tools | Oui | Outils à activer. |
headers | Non | En-têtes HTTP. Prend en charge l’expansion des variables. |
oauthClientId | Non | ID client OAuth statique (ignore l’inscription dynamique). |
oauthPublicClient | Non | Indique si le client OAuth est public. Par défaut : . |
timeout | Non | Délai d’expiration des appels de l’outil en millisecondes. |
Contrôlez la façon dont la sortie de l’outil MCP est traitée à l’aide du champ dans la configuration d’un serveur.
| Mode | Descriptif |
|---|
none | Aucun filtrage. |
markdown | Formater la sortie en Markdown. |
hidden_characters | Supprimez les caractères masqués ou de contrôle. Default. |
L’interface CLI inclut des serveurs MCP intégrés disponibles sans configuration supplémentaire.
| Serveur | Descriptif |
|---|
github-mcp-server | GitHub Intégration de l’API : problèmes, pull requests, commits, recherche de code et GitHub Actions. |
playwright | Automatisation du navigateur : naviguez, cliquez, tapez, capture d’écran et gestion des formulaires. |
fetch | Requêtes HTTP via l’outil . |
time | Utilitaires de temps : et . |
Permet de désactiver tous les serveurs intégrés ou de désactiver un serveur spécifique.
Les compétences sont des fichiers Markdown qui étendent ce que l’interface CLI peut faire. Chaque compétence se trouve dans son propre répertoire contenant un fichier. Lorsqu’elle est appelée (via ou automatiquement par l’agent), le contenu de la compétence est injecté dans la conversation.
| Champ | Type | Obligatoire | Descriptif |
|---|
name | ficelle | Oui | Identificateur unique de la compétence. Lettres, chiffres et traits d’union uniquement. 64 caractères maximum. |
description | ficelle | Oui | Que fait la compétence et quand l’utiliser. Nombre maximal de 1024 caractères. |
allowed-tools | chaîne ou chaîne[] | Non | Liste séparée par des virgules ou tableau YAML d’outils qui sont automatiquement autorisés lorsque la compétence est active. Utiliser pour tous les outils. |
user-invocable | booléen | Non | Indique si les utilisateurs peuvent appeler la compétence avec . Par défaut : . |
disable-model-invocation | booléen | Non | Empêcher l'agent d'activer automatiquement cette fonctionnalité. Par défaut : . |
Les compétences sont chargées à partir de ces emplacements dans l’ordre de priorité (les premières victoires trouvées pour les noms en double).
| Emplacement | Étendue | Descriptif |
|---|
.github/skills/ | Projet | Compétences spécifiques au projet. |
.agents/skills/ | Projet | Autre emplacement du projet. |
.claude/skills/ | Projet | Emplacement compatible avec Claude. |
| Parent | Inherited | Prise en charge de l’annuaire parent monorepo. |
~/.copilot/skills/ | Personnel | Compétences personnelles pour tous les projets. |
~/.claude/skills/ | Personnel | Lieu personnel compatible avec Claude. |
| Répertoires de plug-in | Plug-in | Compétences des plug-ins installés. |
COPILOT_SKILLS_DIRS | Coutume | Répertoires supplémentaires (séparés par des virgules). |
Les commandes sont une alternative aux compétences stockées en tant que fichiers individuels dans . Le nom de la commande est dérivé du nom de fichier. Les fichiers de commande utilisent un format simplifié (aucun champ requis) et prennent en charge , et . Les commandes ont une priorité inférieure à celle des compétences portant le même nom.
Les agents personnalisés sont des agents IA spécialisés définis dans les fichiers Markdown. Le nom de fichier (moins l’extension) devient l’ID de l’agent. Utilisez ou comme extension de fichier.
| Agent | Modèle par défaut | Descriptif |
|---|
code-review | claude-sonnet-4.5 | Révision de code signal-à-bruit élevée. Analyse les différences pour les bogues, les problèmes de sécurité et les erreurs logiques. |
explore | claude-haiku-4.5 | Exploration de base de code rapide. Recherche des fichiers, lit le code et répond aux questions. Retourne des réponses ciblées inférieures à 300 mots. Peut s'exécuter en parallèle. |
general-purpose | claude-sonnet-4.5 | Agent de capacité complète pour les tâches multi-étapes complexes. S’exécute dans une fenêtre contextuelle distincte. |
research | claude-sonnet-4.6 | Agent de recherche approfondie. Génère un rapport basé sur des informations dans votre base de code, dans des référentiels pertinents et sur le web. |
task | claude-haiku-4.5 | Exécution de commandes (tests, builds, lints). Retourne un résumé bref en cas de réussite, et la sortie complète en cas d’échec. |
| Champ | Type | Obligatoire | Descriptif |
|---|
description | ficelle | Oui | Description affichée dans la liste des agents et l'outil . |
infer | booléen | Non | Autoriser la délégation automatique par l’agent principal. Par défaut : . |
mcp-servers | objet | Non | Serveurs MCP à connecter. Utilise le même schéma que . |
model | ficelle | Non | Modèle IA pour cet agent. Lorsqu’il n’est pas défini, hérite du modèle de l’agent externe. |
name | ficelle | Non | Nom d'affichage. La valeur par défaut est le nom de fichier. |
tools | chaîne de caractères[] | Non | Outils disponibles pour l’agent. Valeur par défaut : (tous les outils). |
| Étendue | Emplacement |
|---|
| Projet | ou |
| Utilisateur | ou |
| Plug-in | <plugin>/agents/ |
Les agents au niveau du projet sont prioritaires sur les agents au niveau de l’utilisateur. Les agents de plug-in ont la priorité la plus basse.
Lorsque l’interface CLI demande l’autorisation d’exécuter une opération, vous pouvez répondre avec les clés suivantes.
| Clé | Résultat |
|---|
y | Autorisez cette requête spécifique une seule fois. |
n | Refuser cette demande spécifique une seule fois. |
! | Autorisez toutes les demandes similaires pour le reste de la session. |
# | Refuser toutes les demandes similaires pour le reste de la session. |
? | Affichez des informations détaillées sur la demande. |
Les approbations de session sont réinitialisées lorsque vous exécutez ou démarrez une nouvelle session.
| Flag | Niveau | Descriptif |
|---|
AUTOPILOT_MODE | experimental | Mode d’opération autonome. |
BACKGROUND_AGENTS | staff | Exécutez des agents en arrière-plan. |
QUEUED_COMMANDS | staff | Commandes en file pendant l’exécution de l’agent. |
LSP_TOOLS | on | Outils du Language Server Protocol. |
PLAN_COMMAND | on | Mode de planification interactive. |
AGENTIC_MEMORY | on | Mémoire persistante entre les sessions. |
CUSTOM_AGENTS | on | Définitions d’agent personnalisées. |