FAQ Claude Code

Question

Réponse

1.1 Comment l'installer ?

macOS/Linux : curl -fsSL https://claude.ai/install.sh | bash
​Windows PowerShell : irm https://claude.ai/install.ps1 | iex
​Homebrew : brew install --cask claude-code
​WinGet : winget install Anthropic.ClaudeCode
Ensuite, exécutez claude depuis n'importe quel dépôt.

Référence : Démarrage rapide

1.2 Installé, mais « claude : commande introuvable »

L'installateur natif place le binaire à ~/.local/bin/claude (Windows : %USERPROFILE%\.local\bin). Ajoutez ce répertoire à votre PATH, par exemple export PATH="$PATH:$HOME/.local/bin" dans ~/.zshrc ou ~/.bashrc, puis redémarrez votre terminal.

Référence : Dépannage : PATH

1.3 La connexion ouvre un navigateur sur la mauvaise machine / Je suis en SSH

Appuyez sur c à l'invite de connexion pour copier l'URL d'authentification. Ouvrez-la dans un navigateur local, puis collez le code dans le terminal.

Référence : Dépannage : authentification

1.4 Erreurs d'authentification juste après la connexion, mais j'ai accès

400 « organisation désactivée » : une variable d'environnement ANTHROPIC_API_KEY égarée remplace votre connexion. Désactivez-la, supprimez-la de votre profil shell, redémarrez. Exécutez /status pour confirmer quelle authentification est active.
​403 Interdit : votre administrateur n'a pas encore activé Claude Code pour votre espace de travail, ou un proxy d'entreprise interfère.

Référence : Dépannage : authentification

1.5 Claude Code est-il inclus dans mon forfait ?

Oui. Il est inclus avec les sièges Team et Enterprise et avec l'accès Console (API). Connectez-vous avec votre compte professionnel ; l'authentification unique est gérée automatiquement. Une erreur 403 après la connexion signifie généralement que votre administrateur doit encore l'activer pour l'espace de travail.

Référence : Authentification

1.6 Claude Code vs. application de bureau vs. claude.ai ?

Claude Code : agent terminal qui lit votre dépôt, édite des fichiers, exécute des commandes.
​Application de bureau / claude.ai : interfaces de chat pour les conversations et les questions ponctuelles.
Même famille de modèles en arrière-plan, forme d'outil différente.

Référence : Aperçu

1.7 Fonctionne-t-il dans mon IDE ?

Oui. Des extensions sont disponibles pour VS Code et les IDE JetBrains (IntelliJ, PyCharm, etc.). Mêmes fonctionnalités, intégrées dans l'éditeur au lieu d'un terminal séparé.

Référence : VS Code · JetBrains

1.8 En quoi cela diffère-t-il de l'autocomplétion Copilot/Cursor ?

L'autocomplétion suggère les prochaines lignes. Claude Code est un agent : donnez-lui une tâche (« corriger les tests défaillants ») et il lit les fichiers, exécute les commandes et effectue des modifications multi-fichiers jusqu'à la fin. Moins « termine ma phrase », plus « voici un problème, va le résoudre ».

Référence : Aperçu

1.9 Par quoi devrais-je commencer ?

Pointez-le vers un bug fastidieux mais pas difficile que vous repoussiez. Exemple : « le test dans [fichier] est instable, découvrez pourquoi. » Laissez-le lire le code au lieu de vous expliquer le code.

Référence : Cas d'usage courants

1.10 Comment le mettre à jour ?

Les installations natives se mettent à jour automatiquement en arrière-plan. Pour en forcer une maintenant, exécutez claude update.
Homebrew/WinGet ne se mettent pas à jour automatiquement : exécutez brew upgrade claude-code ou winget upgrade Anthropic.ClaudeCode périodiquement.

Référence : Configuration : mises à jour

Question

Réponse

2.1 Il demande constamment la permission pour les mêmes commandes

Les approbations durent la session actuelle par défaut. Pour les rendre persistantes :
• Choisissez « toujours autoriser » à l'invite
• Ajoutez le modèle à permissions.allow dans .claude/settings.json
• Ou exécutez /permissions pour gérer de manière interactive

Référence : Permissions

2.2 Modes de permission et comment basculer

Appuyez sur Maj+Tab pour parcourir les modes :

Référence : Modes de permission

2.3 Qu'est-ce que /init et quand l'exécuter ?

Exécutez-le une fois, au début, dans n'importe quel dépôt sur lequel vous travaillerez plus d'une fois. Il analyse le projet et écrit CLAUDE.md avec les commandes de compilation, l'architecture et les conventions. Chaque session future le charge automatiquement, donc Claude démarre avec du contexte.

Référence : Mémoire et CLAUDE.md

2.4 Que mettre dans CLAUDE.md ?

Les choses que les outils ne peuvent pas imposer et qu'un nouveau coéquipier se tromperait le premier jour : « déployer depuis release, pas main », « tous les ID sont des chaînes », « ne jamais appeler la BD directement depuis un gestionnaire de route ». Gardez-le sous deux écrans ; plus long sera survolé.

Référence : Mémoire et CLAUDE.md

2.5 Claude ne suit pas mon CLAUDE.md

• Trop long ou trop vague : réduisez aux règles qui comptent vraiment
• Enterré dans la prose : mettez les règles strictes près du haut, utilisez le langage impératif (« Ne jamais X. Toujours Y. »)

Référence : Meilleures pratiques

2.6 Pointez vers un fichier spécifique sans le coller

Tapez @ puis le chemin (complétage par tabulation). Le fichier mentionné est lu avant que Claude réponde.

Référence : Flux de travail courants

2.7 Collez une capture d'écran dans l'invite

Faites glisser l'image dans le terminal, ou appuyez sur Ctrl+V. Sur Mac, c'est Ctrl, pas Cmd (Cmd+V colle du texte). Fonctionne pour les dialogues d'erreur, les maquettes d'interface utilisateur, les photos de tableau blanc.

Référence : Travailler avec des images

2.8 Copiez la réponse de Claude hors du terminal

/copy met la dernière réponse dans votre presse-papiers. /export écrit toute la conversation dans un fichier.

2.9 Récupérez une session précédente

claude --continue reprend la plus récente. claude --resume ouvre une liste pour choisir. Les sessions sont stockées localement par répertoire de projet.

Référence : Flux de travail courants : reprendre

2.10 Changer de modèle

/model ouvre le sélecteur. Définissez une valeur par défaut dans .claude/settings.json si vous voulez le même modèle à chaque session.

Référence : Configuration du modèle

2.11 Réflexion étendue

Activée par défaut. Le raisonnement lui-même est caché dans la vue normale ; appuyez sur Ctrl+O pour basculer vers la transcription détaillée si vous voulez la lire. Utilisez /effort pour augmenter ou diminuer la profondeur. Cela vaut la latence supplémentaire pour le débogage délicat ou les appels d'architecture.

Référence : Réflexion étendue

2.12 Arrêtez-le en cours de tâche

Appuyez sur Ctrl+C pour annuler la génération actuelle, puis dites-lui quoi faire à la place. Pas besoin de recommencer la conversation.

Question

Réponse

3.1 Qu'est-ce que MCP ?

MCP connecte Claude Code à vos outils externes : GitHub, Linear, Slack, votre base de données, votre pile d'observabilité. Une configuration .mcp.json et Claude peut lire vos problèmes, interroger vos données et utiliser les mêmes outils que vous. Premier connecteur courant : votre suivi de problèmes.

Référence : MCP

3.2 Configurez votre premier serveur MCP

• Ajoutez un .mcp.json à la racine du projet, ou utilisez claude mcp add
• Chaque entrée nomme un paquet serveur plus toutes les variables d'environnement (généralement un jeton d'authentification)
• Redémarrez Claude Code et exécutez /mcp pour confirmer qu'il est connecté

Référence : Configuration MCP

3.3 À quoi servent les crochets ?

Scripts shell qui s'exécutent sur des événements (avant qu'un outil s'exécute, après une modification de fichier, quand Claude vous attend). Premier crochet courant : un crochet de Notification qui signale votre bureau quand Claude a besoin d'une entrée. Le même mécanisme peut exécuter votre linter après chaque modification, publier sur Slack ou bloquer les modifications des chemins protégés.

Référence : Guide des crochets

3.4 Créez une invite réutilisable / compétence

Créez .claude/skills/ship/SKILL.md et le nom du dossier devient la commande : /ship. Anglais simple, pas de syntaxe spéciale. Chemin le plus facile : demandez à Claude de l'écrire pour vous. (Le chemin hérité .claude/commands/ship.md fonctionne toujours.)

Référence : Compétences

3.5 Compétences vs. commandes héritées

Même mécanisme ; les commandes ont été fusionnées dans les compétences. .claude/commands/foo.md et .claude/skills/foo/SKILL.md créent tous les deux /foo. La forme de compétence est préférée et vous donne un dossier pour les fichiers de support (documents de référence, modèles, scripts d'aide).

Référence : Compétences

3.6 À quoi servent les sous-agents ?

Travail parallèle : rechercher différentes parties de la base de code, examiner une différence selon des dimensions distinctes, ou générer des implémentations concurrentes en même temps. La session principale agrège les résultats.

Référence : Sous-agents

3.7 Exécuter de manière non-interactive (CI / scripts)

claude -p "votre prompt" s'exécute une fois et affiche le résultat. Idéal pour les hooks CI, les vérifications de pré-commit ou le piping vers d'autres outils. Authentification via votre session connectée ou ANTHROPIC_API_KEY.

Référence : Utilisation de style Unix

3.8 Annuler ce qu'il a fait

/rewind revient à un point de contrôle antérieur. Les points de contrôle sont créés automatiquement à chaque prompt que vous envoyez. Pour tout ce qui a déjà été commité, utilisez un git revert normal.

Référence : Points de contrôle

3.9 Partager votre configuration avec l'équipe

Vérifiez .claude/ dans le repo (CLAUDE.md, commandes, configuration MCP). Quiconque clone le repo obtient la même configuration automatiquement. Les compétences peuvent également être empaquetées en tant que plugin que les équipes installent via /plugin.

Référence : Plugins

Question

Réponse

4.1 Impossible de trouver des fichiers / la recherche ne retourne rien

Claude Code est livré avec une copie groupée de ripgrep, vous n'avez donc pas besoin de l'installer. Le binaire groupé peut échouer sur les systèmes Alpine/musl ; dans ce cas, installez une copie système (apk add ripgrep) et définissez USE_BUILTIN_RIPGREP=0 pour que Claude l'utilise à la place.

Référence : Dépannage : recherche

4.2 Copier/coller et défilement cassés sur SSH ou dans tmux

L'interface utilisateur du terminal capture les événements de la souris. Maintenez Maj enfoncée lors de la sélection pour le contourner, ou configurez tmux pour transmettre les événements de la souris. /copy et /export contournent complètement le problème.

4.3 Lent sur WSL

La lecture des fichiers Windows via /mnt/c/ est une pénalité connue. Déplacez le repo dans le système de fichiers WSL (~/ au lieu de /mnt/c/...). La différence de vitesse est spectaculaire.

Référence : Dépannage : WSL

4.4 Le collage d'image ne fonctionne pas sur Mac

Utilisez Ctrl+V, pas Cmd+V. Cmd+V colle du texte ; Ctrl+V est le chemin image-depuis-presse-papiers.

4.5 La règle de permission avec caractère générique ne correspond pas

Construisez les règles progressivement : approuvez d'abord les commandes de manière interactive, vérifiez ce qui a été écrit dans les paramètres, puis généralisez.

Référence : Modèles de permissions

4.6 Le mode non-interactive -p se comporte différemment

Pour les exécutions non-interactive/CI, préférez l'authentification par clé API et les serveurs MCP configurés avec des jetons de variables d'environnement.

4.7 Contexte épuisé au milieu de la tâche

/compact résume la conversation antérieure pour libérer de l'espace. /clear recommence à zéro tout en gardant CLAUDE.md et les paramètres chargés. Pour les tâches longues, divisez en étapes avec un /clear entre les phases.

Référence : Gestion du contexte

Question

Réponse

5.1 Anthropic s'entraîne-t-il sur mon code ?

Non. Selon les conditions de votre organisation Team/Enterprise, votre code et vos conversations ne sont pas utilisés pour entraîner les modèles.

Référence : Utilisation des données

5.2 Où va réellement mon code ?

Claude Code s'exécute sur votre machine. Les fichiers source sont lus localement, et seules les portions nécessaires pour la tâche actuelle sont envoyées à l'API pour générer une réponse. Rien n'est indexé, téléchargé en tant que repo complet ou utilisé pour l'entraînement.

Référence : Utilisation des données

5.3 Quelqu'un d'autre peut-il voir mes conversations ?

Non. Les sessions sont stockées localement sur votre machine, par répertoire de projet, et ne sont pas partagées avec les coéquipiers ou visibles dans aucun tableau de bord. Utilisez /export si vous voulez partager une conversation.

Référence : Utilisation des données

5.4 Comment garder les secrets et les fichiers .env hors de la conversation ?

Claude ne lit que les fichiers dont il a besoin pour la tâche ; il ne scanne pas tout votre repo. Pour bloquer dur des fichiers spécifiques, ajoutez une règle de refus de lecture dans .claude/settings.json (par exemple "Read(.env*)"). Les fichiers refusés ne peuvent pas être lus même si vous les demandez accidentellement.

Référence : Permissions

5.5 Que peut faire le mode « acceptEdits » sans me demander ?

Les modifications de fichiers passent sans invite. Il demande toujours avant d'exécuter des commandes shell, de faire des appels réseau ou de toucher à quoi que ce soit en dehors de votre répertoire de travail. Pour un contrôle plus strict, restez en mode par défaut.

Référence : Permissions

Ressource

À quoi ça sert

/help

Commande intégrée listant ce qui est disponible dans votre session

/feedback

Signaler un problème depuis le terminal (alias pour /bug)

Documentation complète

Tout ici, en détail

Le canal #claude-code de votre équipe

Les petites victoires et les erreurs bizarres y ont leur place

Page

Lien

Démarrage rapide

code.claude.com/docs/en/quickstart

Dépannage

code.claude.com/docs/en/troubleshooting

Permissions

code.claude.com/docs/en/permissions

Mémoire et CLAUDE.md

code.claude.com/docs/en/memory

MCP

code.claude.com/docs/en/mcp

Utilisation des données

code.claude.com/docs/en/data-usage