> ## Documentation Index
> Fetch the complete documentation index at: https://cli.fuxicode.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.
# Référence CLI
> Référence complète pour l'interface de ligne de commande Fuxi Code, incluant les commandes et les drapeaux.
Commandes CLI
Vous pouvez démarrer des sessions, traiter du contenu, reprendre des conversations et gérer les mises à jour avec ces commandes :
| Commande | Description | Exemple |
| :------------------------------ | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :---------------------------------------------------------- |
| `fuxi` | Démarrer une session interactive | `fuxi` |
| `fuxi "query"` | Démarrer une session interactive avec une invite initiale | `fuxi "explain this project"` |
| `fuxi -p "query"` | Interroger via SDK, puis quitter | `fuxi -p "explain this function"` |
| `cat file \| fuxi -p "query"` | Traiter le contenu canalisé | `cat logs.txt \| fuxi -p "explain"` |
| `fuxi -c` | Continuer la conversation la plus récente dans le répertoire courant | `fuxi -c` |
| `fuxi -c -p "query"` | Continuer via SDK | `fuxi -c -p "Check for type errors"` |
| `fuxi -r "" "query"` | Reprendre une session par ID ou nom | `fuxi -r "auth-refactor" "Finish this PR"` |
| `fuxi update` | Mettre à jour vers la dernière version | `fuxi update` |
| `fuxi gateway` | Démarrer le serveur [passerelle d'applications Fuxi](/fr/fuxi-apps-gateway) auto-hébergé, pour les administrateurs déployant SSO et la politique devant Fuxi Code sur Amazon Bedrock, Google Cloud's Agent Platform, ou Microsoft Foundry. Nécessite `--config` pointant vers un [`gateway.yaml`](/fr/fuxi-apps-gateway-config). Disponible dans Fuxi Code v2.1.195 et ultérieur. | `fuxi gateway --config gateway.yaml` |
| `fuxi install [version]` | Installer ou réinstaller le binaire natif. Accepte une version comme `2.1.118`, ou `stable` ou `latest`. Voir [Installer une version spécifique](/fr/setup#install-a-specific-version) | `fuxi install stable` |
| `fuxi auth login` | Se connecter à votre compte Anthropic. Utilisez `--email` pour pré-remplir votre adresse e-mail, `--sso` pour forcer l'authentification SSO, et `--console` pour vous connecter avec Anthropic Console pour la facturation de l'utilisation de l'API au lieu d'un abonnement Fuxi | `fuxi auth login --console` |
| `fuxi auth logout` | Se déconnecter de votre compte Anthropic | `fuxi auth logout` |
| `fuxi auth status` | Afficher l'état d'authentification en JSON. Utilisez `--text` pour une sortie lisible par l'homme. Quitte avec le code 0 si connecté, 1 sinon | `fuxi auth status` |
| `fuxi agents` | Ouvrir la [vue agent](/fr/agent-view) pour surveiller et dispatcher les sessions d'arrière-plan parallèles. Utilisez `--cwd ` pour afficher uniquement les sessions démarrées sous ce répertoire, ou `--json` pour imprimer les sessions actives en tant que tableau JSON pour les scripts (`--json --all` inclut également les sessions d'arrière-plan terminées). Passez `--permission-mode`, `--model`, `--effort`, ou `--agent` pour définir les [valeurs par défaut pour les sessions dispatched](/fr/agent-view#permission-mode-model-and-effort). Accepte `--settings`, `--add-dir`, `--plugin-dir`, et `--mcp-config` comme la commande `fuxi` de niveau supérieur. L'ouverture de la vue agent nécessite un terminal interactif | `fuxi agents --json` |
| `fuxi attach ` | Attacher à une [session d'arrière-plan](/fr/agent-view#manage-sessions-from-the-shell) dans ce terminal | `fuxi attach 7c5dcf5d` |
| `fuxi auto-mode defaults` | Imprimer les règles du classificateur [mode auto](/fr/permission-modes#eliminate-prompts-with-auto-mode) intégrées en JSON. Utilisez `fuxi auto-mode config` pour voir votre configuration effective avec les paramètres appliqués | `fuxi auto-mode defaults > rules.json` |
| `fuxi daemon status` | Imprimer l'état du [superviseur](/fr/agent-view#the-supervisor-process) de session d'arrière-plan, la version, le répertoire socket, et le nombre de workers pour les diagnostics. Quitte avec 1 si le superviseur n'est pas en cours d'exécution | `fuxi daemon status` |
| `fuxi daemon stop --any` | Arrêter le [superviseur](/fr/agent-view#the-supervisor-process) de session d'arrière-plan et les sessions qu'il héberge. Passez `--keep-workers` pour laisser les sessions d'arrière-plan en cours d'exécution afin que le superviseur suivant se reconnecte à elles. `--any` confirme l'arrêt d'un superviseur à la demande, qui est la valeur par défaut. Utilisez ceci pour récupérer d'un [superviseur qui ne répond pas](/fr/agent-view#agent-view-says-the-background-service-did-not-respond) | `fuxi daemon stop --any --keep-workers` |
| `fuxi doctor` | Imprimer les diagnostics d'installation et de paramètres en lecture seule depuis le terminal sans démarrer une session, y compris la vérification de la santé de l'installation, les erreurs de validation du fichier de paramètres, et l'éligibilité au contrôle à distance. Pour la vérification de configuration en session qui peut également appliquer des correctifs, exécutez [`/doctor`](/fr/commands#all-commands) | `fuxi doctor` |
| `fuxi logs ` | Imprimer la sortie récente d'une [session d'arrière-plan](/fr/agent-view#manage-sessions-from-the-shell) | `fuxi logs 7c5dcf5d` |
| `fuxi mcp` | Configurer les serveurs Model Context Protocol (MCP) | Voir la [documentation Fuxi Code MCP](/fr/mcp). |
| `fuxi mcp login ` | {/* min-version: 2.1.186 */}Exécuter le flux OAuth d'un serveur MCP configuré sans ouvrir le panneau interactif `/mcp`. Fonctionne pour les serveurs HTTP, SSE et fuxi.ai connector. Ajoutez `--no-browser` sur SSH pour imprimer l'URL d'autorisation au lieu d'ouvrir un navigateur, puis collez l'URL de redirection à l'invite. Nécessite Fuxi Code v2.1.186 ou ultérieur. Voir [S'authentifier à partir de la ligne de commande](/fr/mcp#authenticate-from-the-command-line) | `fuxi mcp login sentry` |
| `fuxi mcp logout ` | {/* min-version: 2.1.186 */}Effacer les identifiants OAuth stockés pour un serveur MCP. Nécessite Fuxi Code v2.1.186 ou ultérieur | `fuxi mcp logout sentry` |
| `fuxi plugin` | Gérer les [plugins](/fr/plugins) Fuxi Code. Alias : `fuxi plugins`. Voir la [référence des plugins](/fr/plugins-reference#cli-commands-reference) pour les sous-commandes | `fuxi plugin install code-review@fuxi-plugins-official` |
| `fuxi project purge [path]` | Supprimer tout l'état local de Fuxi Code pour un projet : transcriptions, listes de tâches, journaux de débogage, historique des modifications de fichiers, lignes d'historique des invites, et l'entrée du projet dans `~/.fuxi.json`. Omettez `[path]` pour choisir dans une liste interactive. Drapeaux : `--dry-run` pour prévisualiser, `-y`/`--yes` pour ignorer la confirmation, `-i`/`--interactive` pour confirmer chaque élément, `--all` pour chaque projet. Voir [Effacer les données locales](/fr/fuxi-directory#clear-local-data) | `fuxi project purge ~/work/repo --dry-run` |
| `fuxi remote-control` | Démarrer un serveur [Remote Control](/fr/remote-control) pour contrôler Fuxi Code depuis Fuxi.ai ou l'application Fuxi. S'exécute en mode serveur (pas de session interactive locale). Voir [Drapeaux du mode serveur](/fr/remote-control#start-a-remote-control-session) | `fuxi remote-control --name "My Project"` |
| `fuxi respawn ` | Redémarrer une [session d'arrière-plan](/fr/agent-view#manage-sessions-from-the-shell), en cours d'exécution ou arrêtée, avec sa conversation intacte. Utilisez `--all` pour redémarrer chaque session en cours d'exécution, par exemple pour récupérer un binaire Fuxi Code mis à jour | `fuxi respawn 7c5dcf5d` |
| `fuxi rm ` | Supprimer une [session d'arrière-plan](/fr/agent-view#manage-sessions-from-the-shell) de la liste. La transcription de la conversation reste sur votre machine locale, disponible via `fuxi --resume` | `fuxi rm 7c5dcf5d` |
| `fuxi setup-token` | Générer un jeton OAuth de longue durée pour CI et les scripts. Imprime le jeton sur le terminal sans l'enregistrer. Nécessite un abonnement Fuxi. Voir [Générer un jeton de longue durée](/fr/authentication#generate-a-long-lived-token) | `fuxi setup-token` |
| `fuxi stop ` | Arrêter une [session d'arrière-plan](/fr/agent-view#manage-sessions-from-the-shell). Accepte également `fuxi kill` | `fuxi stop 7c5dcf5d` |
| `fuxi ultrareview [target]` | Exécuter [ultrareview](/fr/ultrareview#run-ultrareview-non-interactively) de manière non interactive. Imprime les résultats sur stdout et quitte avec 0 en cas de succès ou 1 en cas d'échec. Utilisez `--json` pour la charge utile brute et `--timeout ` pour remplacer la valeur par défaut de 30 minutes | `fuxi ultrareview 1234 --json` |
Si vous tapez mal une sous-commande, Fuxi Code suggère la correspondance la plus proche et quitte sans démarrer une session. Par exemple, `fuxi udpate` imprime `Did you mean fuxi update?`.
{/* min-version: 2.1.199 */}À partir de v2.1.199, `fuxi --dangerously-skip-permissions daemon ` exécute la sous-commande `daemon`. Les versions antérieures traitaient `daemon ` comme l'invite pour une nouvelle session interactive, donc la sous-commande ne s'exécutait jamais quand le drapeau venait en premier, une configuration courante quand `fuxi` est aliasé pour inclure le drapeau. Seul un `--dangerously-skip-permissions` ou `--allow-dangerously-skip-permissions` en tête achemine vers `daemon` de cette façon ; tout autre drapeau en tête démarre toujours une session interactive.
Drapeaux CLI
Personnalisez le comportement de Fuxi Code avec ces drapeaux de ligne de commande. `fuxi --help` ne répertorie pas tous les drapeaux, donc l'absence d'un drapeau dans `--help` ne signifie pas qu'il n'est pas disponible.
| Drapeau | Description | Exemple |
| :---------------------------------------------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :-------------------------------------------------------------------------------------------------- |
| `--add-dir` | Ajouter des répertoires de travail supplémentaires pour que Fuxi y accède et modifie les fichiers. Accorde l'accès aux fichiers ; la plupart de la configuration `.fuxi/` est [non découverte](/fr/permissions#additional-directories-grant-file-access-not-configuration) à partir de ces répertoires. Valide que chaque chemin existe en tant que répertoire. Pour conserver ces répertoires entre les sessions, définissez [`permissions.additionalDirectories`](/fr/settings#permission-settings) dans les paramètres | `fuxi --add-dir ../apps ../lib` |
| `--advisor ` | Activer l'[outil advisor](/fr/advisor) côté serveur pour cette session avec un alias de modèle : `opus`, `sonnet`, ou `fable` ({/* min-version: 2.1.170 */}v2.1.170+), ou un ID de modèle complet. Prend la priorité sur le paramètre `advisorModel` pour la session | `fuxi --advisor opus` |
| `--agent` | Spécifier un agent pour la session actuelle (remplace le paramètre `agent`) | `fuxi --agent my-custom-agent` |
| `--agents` | Définir des subagents personnalisés dynamiquement via JSON. Utilise les mêmes noms de champs que le [frontmatter](/fr/sub-agents#supported-frontmatter-fields) des subagents, plus un champ `prompt` pour les instructions de l'agent | `fuxi --agents '{"reviewer":{"description":"Reviews code","prompt":"You are a code reviewer"}}'` |
| `--allow-dangerously-skip-permissions` | Ajouter `bypassPermissions` au cycle du mode `Shift+Tab` sans commencer dedans. Permet de commencer dans un mode différent comme `plan` et de basculer vers `bypassPermissions` plus tard. Voir [modes de permission](/fr/permission-modes#skip-all-checks-with-bypasspermissions-mode) | `fuxi --permission-mode plan --allow-dangerously-skip-permissions` |
| `--allowedTools`, `--allowed-tools` | Outils qui s'exécutent sans demander la permission. Voir [syntaxe des règles de permission](/fr/settings#permission-rule-syntax) pour la correspondance de motifs. Pour restreindre les outils disponibles, utilisez `--tools` à la place | `"Bash(git log *)" "Bash(git diff *)" "Read"` |
| `--append-subagent-system-prompt` | {/* min-version: 2.1.205 */}Ajouter du texte personnalisé à la fin de l'invite système de chaque [subagent](/fr/sub-agents), y compris les subagents imbriqués. S'applique uniquement en mode non interactif avec `-p`. Nécessite Fuxi Code v2.1.205 ou ultérieur | `fuxi -p --append-subagent-system-prompt "Cite file paths in every answer" "query"` |
| `--append-system-prompt` | Ajouter du texte personnalisé à la fin de l'invite système par défaut | `fuxi --append-system-prompt "Always use TypeScript"` |
| `--append-system-prompt-file` | Charger du texte d'invite système supplémentaire à partir d'un fichier et l'ajouter à l'invite par défaut | `fuxi --append-system-prompt-file ./extra-rules.txt` |
| `--ax-screen-reader` | {/* min-version: 2.1.181 */}Afficher une sortie accessible aux lecteurs d'écran : texte plat sans bordures décoratives ni animations. Force le rendu classique, donc le paramètre [`tui`](/fr/settings#available-settings) n'a aucun effet ; les [sessions en arrière-plan](/fr/agent-view) attachées restent rendues en plein écran. Prend la priorité sur [`FUXI_AX_SCREEN_READER`](/fr/env-vars) et le paramètre [`axScreenReader`](/fr/settings#available-settings). Nécessite Fuxi Code v2.1.181 ou ultérieur | `fuxi --ax-screen-reader` |
| `--bare` | Mode minimal : ignorer la découverte automatique des hooks, skills, plugins, serveurs MCP, mémoire automatique et FUXI.md afin que les appels scriptés démarrent plus rapidement. Fuxi a accès aux outils Bash, lecture de fichier et édition de fichier. Définit [`FUXI_CODE_SIMPLE`](/fr/env-vars). Voir [mode bare](/fr/headless#start-faster-with-bare-mode) | `fuxi --bare -p "query"` |
| `--betas` | En-têtes bêta à inclure dans les requêtes API (utilisateurs de clé API uniquement) | `fuxi --betas interleaved-thinking` |
| `--bg`, `--background` | Démarrer la session en tant qu'[agent en arrière-plan](/fr/agent-view) et revenir immédiatement. Affiche l'ID de session et les commandes de gestion. Combinez avec `--exec` pour exécuter une commande shell en tant que travail en arrière-plan au lieu d'une session Fuxi, ou avec `--agent` pour exécuter un subagent spécifique. {/* min-version: 2.1.198 */}Ne peut pas être combiné avec `-p`/`--print` ; voir la [référence d'erreur](/fr/errors#command-line-errors) | `fuxi --bg "investigate the flaky test"` |
| `--channels` | (Aperçu de recherche) Serveurs MCP dont les notifications de [canal](/fr/channels) Fuxi doit écouter dans cette session. Liste séparée par des espaces d'entrées `plugin:@`. Nécessite l'authentification Fuxi.ai | `fuxi --channels plugin:my-notifier@my-marketplace` |
| `--chrome` | Activer l'[intégration du navigateur Chrome](/fr/chrome) pour l'automatisation web et les tests | `fuxi --chrome` |
| `--cloud` | Créer une nouvelle [session web](/fr/fuxi-code-on-the-web) sur fuxi.ai avec la description de tâche fournie | `fuxi --cloud "Fix the login bug"` |
| `--continue`, `-c` | Charger la conversation la plus récente dans le répertoire courant. Inclut les sessions qui ont ajouté ce répertoire avec `/add-dir` | `fuxi --continue` |
| `--dangerously-load-development-channels` | Activer les [canaux](/fr/channels-reference#test-during-the-research-preview) qui ne sont pas sur la liste d'approbation, pour le développement local. Accepte les entrées `plugin:@` et `server:`. Demande une confirmation | `fuxi --dangerously-load-development-channels server:webhook` |
| `--dangerously-skip-permissions` | Ignorer les invites de permission. Équivalent à `--permission-mode bypassPermissions`. Voir [modes de permission](/fr/permission-modes#skip-all-checks-with-bypasspermissions-mode) pour ce que cela ignore et n'ignore pas | `fuxi --dangerously-skip-permissions` |
| `--debug` | Activer le mode débogage avec filtrage de catégorie optionnel (par exemple, `"api,hooks"` ou `"!statsig,!file"`) | `fuxi --debug "api,mcp"` |
| `--debug-file ` | Écrire les journaux de débogage dans un chemin de fichier spécifique. Active implicitement le mode débogage. Prend la priorité sur `FUXI_CODE_DEBUG_LOGS_DIR` | `fuxi --debug-file /tmp/fuxi-debug.log` |
| `--disable-slash-commands` | Désactiver tous les skills et commandes pour cette session | `fuxi --disable-slash-commands` |
| `--disallowedTools`, `--disallowed-tools` | Règles de refus. Un nom d'outil nu supprime cet outil du contexte du modèle : `"Edit"` supprime Edit, `"*"` supprime tous les outils, et `"mcp__*"` supprime tous les outils MCP. Une règle délimitée telle que `Bash(rm *)` laisse l'outil disponible et refuse uniquement les appels correspondants | `"Bash(git log *)" "Bash(git diff *)" "Edit"` |
| `--effort` | Définir le [niveau d'effort](/fr/model-config#adjust-effort-level) pour la session actuelle. Options : `low`, `medium`, `high`, `xhigh`, `max`, ou {/* min-version: 2.1.203 */}}`ultracode`. Les niveaux disponibles dépendent du modèle. `ultracode` démarre la session au niveau d'effort `xhigh` avec [ultracode](/fr/workflows#let-fuxi-decide-with-ultracode) activé, et nécessite Fuxi Code v2.1.203 ou ultérieur. Remplace le paramètre [`effortLevel`](/fr/settings#available-settings) pour cette session et ne persiste pas | `fuxi --effort high` |
| `--enable-auto-mode` | {/* max-version: 2.1.110 */}Supprimé dans v2.1.111. Le mode auto est maintenant dans le cycle `Shift+Tab` par défaut ; utilisez `--permission-mode auto` pour commencer dedans | `fuxi --permission-mode auto` |
| `--exclude-dynamic-system-prompt-sections` | Déplacer les sections par machine de l'invite système (répertoire de travail, informations d'environnement, chemins de mémoire, statut git) dans le premier message utilisateur. Améliore la réutilisation du cache d'invite sur différents utilisateurs et machines exécutant la même tâche. S'applique uniquement avec l'invite système par défaut ; ignoré lorsque `--system-prompt` ou `--system-prompt-file` est défini. À utiliser avec `-p` pour les charges de travail scriptées multi-utilisateurs | `fuxi -p --exclude-dynamic-system-prompt-sections "query"` |
| `--exec` | Exécuter une commande shell en tant que travail en arrière-plan soutenu par PTY au lieu de démarrer une session Fuxi. À utiliser avec `--bg` pour lancer depuis le shell | `fuxi --bg --exec 'pytest -x'` |
| `--fallback-model` | Activer le basculement automatique vers le ou les modèles spécifiés lorsque le modèle principal est surchargé ou non disponible, par exemple un modèle retiré. Accepte une liste séparée par des virgules essayée dans l'ordre. Voir [Chaînes de modèles de secours](/fr/model-config#fallback-model-chains). Pour conserver une chaîne entre les sessions, utilisez le paramètre [`fallbackModel`](/fr/settings#available-settings), que ce drapeau remplace | `fuxi --fallback-model sonnet,haiku` |
| `--fork-session` | Lors de la reprise, créer un nouvel ID de session au lieu de réutiliser l'original (à utiliser avec `--resume` ou `--continue`) | `fuxi --resume abc123 --fork-session` |
| `--from-pr` | Reprendre les sessions liées à une demande de tirage spécifique. Accepte un numéro de PR, une URL GitHub ou GitHub Enterprise PR, une URL de demande de fusion GitLab, ou une URL de demande de tirage Bitbucket. Les sessions sont automatiquement liées lorsque Fuxi crée la demande de tirage | `fuxi --from-pr 123` |
| `--ide` | Se connecter automatiquement à l'IDE au démarrage s'il y a exactement un IDE valide disponible | `fuxi --ide` |
| `--init` | Exécuter les hooks d'[initialisation](/fr/hooks#setup) avec le matcher `init` avant la session (mode impression uniquement) | `fuxi -p --init "query"` |
| `--init-only` | Exécuter les hooks d'[initialisation](/fr/hooks#setup) et `SessionStart`, puis quitter sans démarrer une conversation | `fuxi --init-only` |
| `--include-hook-events` | Inclure tous les événements du cycle de vie des hooks dans le flux de sortie. Nécessite `--output-format stream-json` | `fuxi -p --output-format stream-json --verbose --include-hook-events "query"` |
| `--include-partial-messages` | Inclure les événements de streaming partiels dans la sortie. Nécessite `--print` et `--output-format stream-json` | `fuxi -p --output-format stream-json --verbose --include-partial-messages "query"` |
| `--input-format` | Spécifier le format d'entrée pour le mode impression (options : `text`, `stream-json`) | `fuxi -p --output-format json --input-format stream-json` |
| `--json-schema` | Obtenir une sortie JSON validée correspondant à un JSON Schema après que l'agent ait terminé son flux de travail (mode impression uniquement). Voir [structured outputs](/fr/agent-sdk/structured-outputs). {/* min-version: 2.1.205 */}Fuxi Code quitte avec une erreur sur un schéma invalide et accepte le mot-clé `format` comme annotation sans validation côté client. Avant v2.1.205, un schéma invalide produisait une sortie non structurée sans erreur, et les schémas utilisant `format` étaient traités comme invalides | `fuxi -p --json-schema '{"type":"object","properties":{...}}' "query"` |
| `--maintenance` | Exécuter les hooks d'[initialisation](/fr/hooks#setup) avec le matcher `maintenance` avant la session (mode impression uniquement) | `fuxi -p --maintenance "query"` |
| `--max-budget-usd` | Montant en dollars maximum à dépenser pour les appels API avant d'arrêter (mode impression uniquement) | `fuxi -p --max-budget-usd 5.00 "query"` |
| `--max-turns` | Limiter le nombre de tours d'agent (mode impression uniquement). Quitte avec une erreur lorsque la limite est atteinte. Pas de limite par défaut. {/* min-version: 2.1.205 */}Avec `--input-format stream-json`, un message envoyé pendant que Fuxi travaille reste en attente et s'exécute comme son propre tour, avec sa propre limite, lorsque la limite termine le tour actuel. Avant v2.1.205, Fuxi Code rejetait ce message | `fuxi -p --max-turns 3 "query"` |
| `--mcp-config` | Charger les serveurs MCP à partir de fichiers ou de chaînes JSON (séparés par des espaces) | `fuxi --mcp-config ./mcp.json` |
| `--model` | Définit le modèle pour la session actuelle avec un alias pour le dernier modèle (`sonnet`, `opus`, `haiku`, ou `fable`) ou le nom complet d'un modèle. Remplace le paramètre [`model`](/fr/settings#available-settings) et [`ANTHROPIC_MODEL`](/fr/model-config#environment-variables) | `fuxi --model fuxi-sonnet-5` |
| `--name`, `-n` | Définir un nom d'affichage pour la session, affiché dans `/resume` et le titre du terminal. Vous pouvez reprendre une session nommée avec `fuxi --resume `.
[`/rename`](/fr/commands) change le nom en cours de session et l'affiche également dans la barre d'invite | `fuxi -n "my-feature-work"` |
| `--no-chrome` | Désactiver l'[intégration du navigateur Chrome](/fr/chrome) pour cette session | `fuxi --no-chrome` |
| `--no-session-persistence` | Désactiver la persistance de session afin que les sessions ne soient pas enregistrées sur le disque et ne puissent pas être reprises. Mode impression uniquement. La variable d'environnement [`FUXI_CODE_SKIP_PROMPT_HISTORY`](/fr/env-vars) fait la même chose dans n'importe quel mode | `fuxi -p --no-session-persistence "query"` |
| `--output-format` | Spécifier le format de sortie pour le mode impression (options : `text`, `json`, `stream-json`) | `fuxi -p "query" --output-format json` |
| `--permission-mode` | Commencer dans un [mode de permission](/fr/permission-modes) spécifié. Accepte `default`, `acceptEdits`, `plan`, `auto`, `dontAsk`, `bypassPermissions`, ou {/* min-version: 2.1.200 */}}`manual` comme alias pour `default`. L'alias `manual` sélectionne le mode que l'interface utilisateur étiquette Manuel et nécessite Fuxi Code v2.1.200 ou ultérieur ; `fuxi --help` le répertorie à la place de `default`, et les deux valeurs fonctionnent. Remplace `defaultMode` des fichiers de paramètres | `fuxi --permission-mode plan` |
| `--permission-prompt-tool` | Spécifier un outil MCP pour gérer les invites de permission en mode non interactif. {/* min-version: 2.1.199 */}À partir de v2.1.199, l'outil d'invite ne peut pas approuver un outil MCP marqué comme [nécessitant une interaction utilisateur](/fr/mcp#require-approval-for-a-specific-tool) : un résultat `allow` pour celui-ci est converti en refus | `fuxi -p --permission-prompt-tool mcp_auth_tool "query"` |
| `--plugin-dir` | Charger un plugin à partir d'un répertoire ou d'une archive `.zip` pour cette session uniquement. Chaque drapeau prend un chemin. Répétez le drapeau pour plusieurs plugins : `--plugin-dir A --plugin-dir B.zip` | `fuxi --plugin-dir ./my-plugin` |
| `--plugin-url` | Récupérer une archive `.zip` de plugin à partir d'une URL pour cette session uniquement. Répétez le drapeau pour plusieurs plugins, ou passez des URL séparées par des espaces dans une seule valeur entre guillemets | `fuxi --plugin-url https://example.com/plugin.zip` |
| `--print`, `-p` | Imprimer la réponse sans mode interactif (voir la [documentation du SDK Agent](/fr/agent-sdk/overview) pour les détails d'utilisation programmatique) | `fuxi -p "query"` |
| `--prompt-suggestions` | Émettre un message `prompt_suggestion` après chaque tour avec une prédiction du prochain message utilisateur. Nécessite `--print`, `--output-format stream-json`, et `--verbose`. Voir [Suggestions d'invite](/fr/interactive-mode#prompt-suggestions) | `fuxi -p --prompt-suggestions --output-format stream-json --verbose "query"` |
| `--remote` | Alias déprécié pour `--cloud` | `fuxi --remote "Fix the login bug"` |
| `--remote-control`, `--rc` | Démarrer une session interactive avec [Remote Control](/fr/remote-control#start-a-remote-control-session) activé afin que vous puissiez également le contrôler depuis fuxi.ai ou l'application Fuxi. Optionnellement, passez un nom pour la session | `fuxi --remote-control "My Project"` |
| `--remote-control-session-name-prefix ` | Préfixe pour les noms de session [Remote Control](/fr/remote-control) générés automatiquement lorsqu'aucun nom explicite n'est défini. Par défaut, le nom d'hôte de votre machine, produisant des noms comme `myhost-graceful-unicorn`. Définissez `FUXI_REMOTE_CONTROL_SESSION_NAME_PREFIX` pour le même effet | `fuxi remote-control --remote-control-session-name-prefix dev-box` |
| `--replay-user-messages` | Ré-émettre les messages utilisateur de stdin sur stdout pour la reconnaissance. Nécessite `--input-format stream-json` et `--output-format stream-json` | `fuxi -p --input-format stream-json --output-format stream-json --verbose --replay-user-messages` |
| `--resume`, `-r` | Reprendre une session spécifique par ID ou nom, ou afficher un sélecteur interactif pour choisir une session. Le sélecteur et la recherche par nom incluent les sessions qui ont ajouté ce répertoire avec `/add-dir` ; passer un ID de session recherche uniquement le répertoire du projet actuel et ses git worktrees. À partir de v2.1.144, les [sessions en arrière-plan](/fr/agent-view) apparaissent dans le sélecteur marquées avec `bg` | `fuxi --resume auth-refactor` |
| `--safe-mode` | {/* min-version: 2.1.169 */}Démarrer avec toutes les personnalisations désactivées pour dépanner une configuration cassée : FUXI.md, skills, plugins, hooks, serveurs MCP, commandes et agents personnalisés, styles de sortie, workflows, thèmes personnalisés, liaisons de touches personnalisées, commandes de ligne d'état et de suggestion de fichiers, serveurs LSP, et mémoire automatique ne se chargent pas. L'authentification, la sélection du modèle, les outils intégrés et les permissions fonctionnent normalement, ce qui diffère de [`--bare`](/fr/headless#start-faster-with-bare-mode). La politique des paramètres gérés s'applique toujours, y compris les hooks configurés par la politique, la ligne d'état et les commandes de suggestion de fichiers ; les plugins gérés, les skills gérés, le FUXI.md géré et les serveurs MCP configurés par la politique ne se chargent pas. Utile pour vérifier si une personnalisation est ce qui déclenche le [basculement automatique depuis Fable 5](/fr/model-config#automatic-model-fallback). Définit [`FUXI_CODE_SAFE_MODE`](/fr/env-vars) | `fuxi --safe-mode` |
| `--session-id` | Utiliser un ID de session spécifique pour la conversation (doit être un UUID valide) | `fuxi --session-id "550e8400-e29b-41d4-a716-446655440000"` |
| `--setting-sources` | Liste séparée par des virgules des sources de paramètres à charger (`user`, `project`, `local`) | `fuxi --setting-sources user,project` |
| `--settings` | Chemin vers un fichier JSON de paramètres ou une chaîne JSON en ligne. Les valeurs que vous définissez ici remplacent les mêmes clés dans vos fichiers `settings.json` pour cette session. Les clés que vous omettez conservent leurs valeurs basées sur les fichiers. Voir [précédence des paramètres](/fr/settings#settings-precedence) | `fuxi --settings ./settings.json` |
| `--strict-mcp-config` | Utiliser uniquement les serveurs MCP de `--mcp-config`, en ignorant toutes les autres configurations MCP | `fuxi --strict-mcp-config --mcp-config ./mcp.json` |
| `--system-prompt` | Remplacer l'invite système entière par du texte personnalisé | `fuxi --system-prompt "You are a Python expert"` |
| `--system-prompt-file` | Charger l'invite système à partir d'un fichier, en remplaçant l'invite par défaut | `fuxi --system-prompt-file ./custom-prompt.txt` |
| `--teleport` | Reprendre une [session web](/fr/fuxi-code-on-the-web) dans votre terminal local | `fuxi --teleport` |
| `--teammate-mode` | Définir comment les coéquipiers de l'[équipe d'agents](/fr/agent-teams) s'affichent : `in-process` (par défaut), `auto`, `tmux`, ou {/* min-version: 2.1.186 */}}`iterm2` (ajouté dans v2.1.186). La valeur par défaut a changé de `auto` dans v2.1.179. Remplace le paramètre [`teammateMode`](/fr/settings#available-settings) pour cette session. Voir [Choisir un mode d'affichage](/fr/agent-teams#choose-a-display-mode) | `fuxi --teammate-mode auto` |
| `--tmux` | Créer une session tmux pour le worktree. Nécessite `--worktree`. Utilise les volets natifs iTerm2 lorsqu'ils sont disponibles ; passez `--tmux=classic` pour le tmux traditionnel | `fuxi -w feature-auth --tmux` |
| `--tools` | Restreindre les outils intégrés que Fuxi peut utiliser. Utilisez `""` pour désactiver tous, `"default"` pour tous, ou des noms d'outils comme `"Bash,Edit,Read"`. Les outils MCP ne sont pas affectés ; pour les refuser aussi, utilisez `--disallowedTools "mcp__*"`, ou passez `--strict-mcp-config` sans `--mcp-config` afin qu'aucun serveur MCP ne se charge | `fuxi --tools "Bash,Edit,Read"` |
| `--verbose` | Activer la journalisation détaillée, affiche la sortie complète tour par tour. Remplace le paramètre [`viewMode`](/fr/settings#available-settings) pour cette session | `fuxi --verbose` |
| `--version`, `-v` | Afficher le numéro de version | `fuxi -v` |
| `--worktree`, `-w` | Démarrer Fuxi dans un [git worktree](/fr/worktrees) isolé à `/.fuxi/worktrees/`. Si aucun nom n'est donné, un est généré automatiquement. Passez `#` ou une URL de demande de tirage GitHub pour récupérer cette PR de `origin` et créer une branche du worktree à partir de celle-ci | `fuxi -w feature-auth` |
Drapeaux d'invite système
Fuxi Code fournit quatre drapeaux pour personnaliser l'invite système. Les quatre fonctionnent à la fois en mode interactif et non interactif.
| Drapeau | Comportement | Exemple |
| :---------------------------- | :------------------------------------------------- | :------------------------------------------------------ |
| `--system-prompt` | Remplace l'invite par défaut entière | `fuxi --system-prompt "You are a Python expert"` |
| `--system-prompt-file` | Remplace par le contenu du fichier | `fuxi --system-prompt-file ./prompts/review.txt` |
| `--append-system-prompt` | Ajoute à l'invite par défaut | `fuxi --append-system-prompt "Always use TypeScript"` |
| `--append-system-prompt-file` | Ajoute le contenu du fichier à l'invite par défaut | `fuxi --append-system-prompt-file ./style-rules.txt` |
`--system-prompt` et `--system-prompt-file` s'excluent mutuellement. Les drapeaux d'ajout peuvent être combinés avec l'un ou l'autre drapeau de remplacement.
Choisissez en fonction de la question de savoir si l'identité par défaut de Fuxi Code convient toujours à votre tâche. Utilisez un drapeau d'ajout lorsque Fuxi doit rester un assistant de codage qui suit également vos règles supplémentaires : instructions par invocation, formatage de sortie, ou contexte de domaine pour un script `-p`. L'ajout préserve les conseils d'outils par défaut, les instructions de sécurité et les conventions de codage, vous ne fournissez donc que ce qui diffère. Utilisez un drapeau de remplacement lorsque la surface, l'identité ou le modèle de permission diffère de celui de Fuxi Code, comme un agent non-codage dans un pipeline qu'aucun humain ne regarde. Le remplacement supprime l'intégralité de l'invite par défaut, y compris les conseils d'outils et les instructions de sécurité, vous êtes donc responsable de tout ce que votre tâche nécessite toujours.
Ces drapeaux s'appliquent uniquement à l'invocation actuelle. Pour les personas persistants que vous pouvez basculer et partager dans un projet, utilisez les [styles de sortie](/fr/output-styles). Pour les conventions de projet que Fuxi doit toujours suivre, utilisez [FUXI.md](/fr/memory). Le [guide du SDK Agent sur les invites système](/fr/agent-sdk/modifying-system-prompts#decide-on-a-starting-point) couvre la même décision plus en profondeur.
Voir aussi
* [Extension Chrome](/fr/chrome) - Automatisation du navigateur et tests web
* [Mode interactif](/fr/interactive-mode) - Raccourcis, modes d'entrée et fonctionnalités interactives
* [Guide de démarrage rapide](/fr/quickstart) - Prise en main de Fuxi Code
* [Flux de travail courants](/fr/common-workflows) - Flux de travail et modèles avancés
* [Paramètres](/fr/settings) - Options de configuration
* [Documentation du SDK Agent](/fr/agent-sdk/overview) - Utilisation programmatique et intégrations