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 avez remis à plus tard. 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 :
• par défaut · demande avant les modifications ou commandes risquées
• accepter-modifications · les modifications de fichiers passent ; demande toujours avant d'exécuter les commandes
• plan · lecture seule ; propose un plan et attend l'approbation
• auto (si activé par votre organisation) · approuve automatiquement avec une vérification de sécurité en arrière-plan

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 contient CLAUDE.md ?

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 de caractères », « ne jamais appeler la base de données 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 en 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 place la dernière réponse dans votre presse-papiers. /export écrit la conversation entière 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 ; vous verrez le raisonnement de Claude avant les réponses plus difficiles. 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. Connecteur courant en premier : 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 hooks ?

Scripts shell qui s'exécutent sur des événements (avant qu'un outil ne s'exécute, après une modification de fichier, quand Claude vous attend). Hook courant en premier : un hook 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 hooks

3.4 Créez une invite réutilisable / commande slash

Déposez un fichier markdown dans .claude/commands/. Le nom du fichier devient la commande : .claude/commands/ship.md devient /ship. Anglais simple, pas de syntaxe spéciale. Chemin le plus facile : demandez à Claude de l'écrire pour vous.

Référence : Commandes slash

3.5 Compétences vs. commandes slash

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 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écutez sans interface (CI / scripts)

claude -p "votre invite" s'exécute une fois et imprime le résultat. Bon pour les hooks CI, les vérifications de pré-commit ou la redirection vers d'autres outils. Authentification via votre session connectée ou ANTHROPIC_API_KEY.

Référence : Utilisation de style Unix

3.8 Annulez ce qu'il a fait

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

Référence : Checkpointing

3.9 Partager votre configuration avec l'équipe

Vérifiez .claude/ dans le dépôt (CLAUDE.md, commands, MCP config). Quiconque clone le dépôt 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 utilise ripgrep en arrière-plan. S'il est manquant, la recherche se dégrade. Installez-le (brew install ripgrep ou apt install ripgrep) et définissez USE_BUILTIN_RIPGREP=0 pour utiliser la copie système.

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 entièrement le problème.

4.3 Lent sur WSL

La lecture des fichiers Windows via /mnt/c/ est une pénalité connue. Déplacez le dépôt 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 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 sans interface -p se comporte différemment

• Les serveurs MCP qui ont besoin d'OAuth ne peuvent pas demander en mode sans interface
• Les approbations interactives ne sont pas reportées
Pour le mode sans interface/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 d'une 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 Team/Enterprise de votre organisation, 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 dépôt 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 dépôt. Pour bloquer fermement 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 « accept-edits » 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

Liste de commandes intégrée montrant ce qui est disponible dans votre session

/bug

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

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

Autorisations

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