Vue d'ensemble de Claude Code

npm install -g @anthropic-ai/claude-code

Claude Code est un outil de codage agentique qui vit dans votre terminal, comprend votre base de code et vous aide à coder plus rapidement grâce à des commandes en langage naturel. En s’intégrant directement à votre environnement de développement, Claude Code simplifie votre flux de travail sans nécessiter de serveurs supplémentaires ou de configuration complexe.

Les principales capacités de Claude Code incluent :

• L’édition de fichiers et la correction de bugs dans votre base de code
• Répondre aux questions sur l’architecture et la logique de votre code
• Exécuter et corriger les tests, le linting et autres commandes
• Rechercher dans l’historique git, résoudre les conflits de fusion et créer des commits et des PR

​

Avant de commencer

​

Vérifier les prérequis système

• Systèmes d’exploitation : macOS 10.15+, Ubuntu 20.04+/Debian 10+, ou Windows via WSL
• Matériel : 4 Go de RAM minimum
• Logiciels :
  • Node.js 18+
  • git 2.23+ (optionnel)
  • CLI GitHub ou GitLab pour les flux de travail PR (optionnel)
  • ripgrep (rg) pour la recherche de fichiers améliorée (optionnel)
• Réseau : Connexion Internet requise pour l’authentification et le traitement IA
• Localisation : Disponible uniquement dans les pays pris en charge

​

Installer et s’authentifier

​

Fonctionnalités principales et flux de travail

Claude Code fonctionne directement dans votre terminal, comprenant le contexte de votre projet et prenant des actions réelles. Pas besoin d’ajouter manuellement des fichiers au contexte - Claude explorera votre base de code selon les besoins. Claude Code utilise claude-3-7-sonnet-20250219 par défaut.

​

Sécurité et confidentialité dès la conception

La sécurité de votre code est primordiale. L’architecture de Claude Code garantit :

• Connexion API directe : Vos requêtes vont directement à l’API d’Anthropic sans serveurs intermédiaires
• Fonctionne là où vous travaillez : Opère directement dans votre terminal
• Comprend le contexte : Maintient une conscience de toute la structure de votre projet
• Prend des actions : Effectue des opérations réelles comme l’édition de fichiers et la création de commits

​

Des questions aux solutions en quelques secondes

# Posez des questions sur votre base de code
claude
> comment fonctionne notre système d'authentification ?

# Créez un commit avec une seule commande
claude commit

# Corrigez les problèmes dans plusieurs fichiers
claude "corriger les erreurs de type dans le module d'authentification"

​

Initialiser votre projet

Pour les nouveaux utilisateurs, nous recommandons :

1. Démarrez Claude Code avec claude
2. Essayez une commande simple comme résumer ce projet
3. Générez un guide de projet CLAUDE.md avec /init
4. Demandez à Claude de commiter le fichier CLAUDE.md généré dans votre dépôt

​

Utiliser Claude Code pour les tâches courantes

Claude Code fonctionne directement dans votre terminal, comprenant le contexte de votre projet et prenant des actions réelles. Pas besoin d’ajouter manuellement des fichiers au contexte - Claude explorera votre base de code selon les besoins.

​

Comprendre un code non familier

> que fait le système de traitement des paiements ?
> trouver où les permissions utilisateur sont vérifiées
> expliquer comment fonctionne la couche de cache

​

Automatiser les opérations Git

> commiter mes changements
> créer une pr
> quel commit a ajouté les tests pour markdown en décembre ?
> rebase sur main et résoudre les conflits de fusion

​

Éditer le code intelligemment

> ajouter la validation des entrées au formulaire d'inscription
> refactoriser le logger pour utiliser la nouvelle API
> corriger la condition de course dans la file d'attente des workers

​

Tester et déboguer votre code

> exécuter les tests pour le module d'authentification et corriger les échecs
> trouver et corriger les vulnérabilités de sécurité
> expliquer pourquoi ce test échoue

​

Encourager une réflexion plus approfondie

Pour les problèmes complexes, demandez explicitement à Claude de réfléchir plus profondément :

> réfléchir à la façon dont nous devrions architecturer le nouveau service de paiement
> réfléchir attentivement aux cas limites dans notre flux d'authentification

Claude Code montrera quand Claude (3.7 Sonnet) utilise une réflexion étendue. Vous pouvez proactivement demander à Claude de “réfléchir” ou “réfléchir profondément” pour les tâches nécessitant plus de planification. Nous suggérons de d’abord parler à Claude de votre tâche et de le laisser rassembler le contexte de votre projet. Ensuite, demandez-lui de “réfléchir” pour créer un plan.

​

Automatiser les flux de travail CI et infra

Claude Code est livré avec un mode non interactif pour l’exécution sans interface. C’est particulièrement utile pour exécuter Claude Code dans des contextes non interactifs comme les scripts, les pipelines et les Github Actions.

Utilisez --print (-p) pour exécuter Claude en mode non interactif. Dans ce mode, vous pouvez définir la variable d’environnement ANTHROPIC_API_KEY pour fournir une clé API personnalisée.

Le mode non interactif est particulièrement utile lorsque vous préconfigurez l’ensemble des commandes que Claude est autorisé à utiliser :

export ANTHROPIC_API_KEY=sk_...
claude -p "mettre à jour le README avec les derniers changements" --allowedTools "Bash(git diff:*)" "Bash(git log:*)" Edit

​

Contrôler Claude Code avec des commandes

​

Commandes CLI

Drapeaux CLI :

• --print : Afficher la réponse sans mode interactif
• --verbose : Activer la journalisation détaillée
• --dangerously-skip-permissions : Ignorer les invites de permission (uniquement dans les conteneurs Docker sans internet)

​

Commandes slash

Contrôlez le comportement de Claude dans une session :

​

Gérer les permissions et la sécurité

Claude Code utilise un système de permissions à plusieurs niveaux pour équilibrer puissance et sécurité :

​

Outils disponibles pour Claude

Claude Code a accès à un ensemble d’outils puissants qui l’aident à comprendre et modifier votre base de code :

​

Se protéger contre l’injection de prompts

L’injection de prompts est une technique où un attaquant tente de contourner ou manipuler les instructions d’un assistant IA en insérant du texte malveillant. Claude Code inclut plusieurs protections contre ces attaques :

• Système de permissions : Les opérations sensibles nécessitent une approbation explicite
• Analyse contextuelle : Détecte les instructions potentiellement dangereuses en analysant la requête complète
• Assainissement des entrées : Empêche l’injection de commandes en traitant les entrées utilisateur
• Liste noire de commandes : Bloque les commandes risquées qui récupèrent du contenu arbitraire du web comme curl et wget

Bonnes pratiques pour travailler avec du contenu non fiable :

1. Examinez les commandes suggérées avant approbation
2. Évitez de transmettre directement du contenu non fiable à Claude
3. Vérifiez les modifications proposées aux fichiers critiques
4. Signalez les comportements suspects avec /bug

​

Configurer l’accès réseau

Claude Code nécessite l’accès à :

• api.anthropic.com
• statsig.anthropic.com
• sentry.io

Mettez ces URLs sur liste blanche lorsque vous utilisez Claude Code dans des environnements conteneurisés.

​

Configurer Claude Code

Configurez Claude Code en exécutant claude config dans votre terminal, ou la commande /config lors de l’utilisation du REPL interactif.

​

Options de configuration

Claude Code prend en charge la configuration globale et au niveau du projet.

Pour gérer vos configurations, utilisez les commandes suivantes :

• Lister les paramètres : claude config list
• Voir un paramètre : claude config get <clé>
• Modifier un paramètre : claude config set <clé> <valeur>
• Ajouter à un paramètre (pour les listes) : claude config add <clé> <valeur>
• Retirer d’un paramètre (pour les listes) : claude config remove <clé> <valeur>

Par défaut config modifie votre configuration de projet. Pour gérer votre configuration globale, utilisez le drapeau --global (ou -g).

​

Configuration globale

Pour définir une configuration globale, utilisez claude config set -g <clé> <valeur> :

​

Options de permission de mise à jour automatique

Lorsque Claude Code détecte qu’il n’a pas suffisamment de permissions pour écrire dans votre répertoire npm prefix global (requis pour les mises à jour automatiques), vous verrez un avertissement qui pointe vers cette page de documentation. Pour des solutions détaillées aux problèmes de mise à jour automatique, consultez le guide de dépannage.

​

Recommandé : Créer un nouveau préfixe npm accessible en écriture par l’utilisateur

# D'abord, sauvegardez une liste de vos paquets globaux existants pour une migration ultérieure
npm list -g --depth=0 > ~/npm-global-packages.txt

# Créez un répertoire pour vos paquets globaux
mkdir -p ~/.npm-global

# Configurez npm pour utiliser le nouveau chemin de répertoire
npm config set prefix ~/.npm-global

# Note : Remplacez ~/.bashrc par ~/.zshrc, ~/.profile, ou autre fichier approprié pour votre shell
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.bashrc

# Appliquez le nouveau paramètre PATH
source ~/.bashrc

# Maintenant réinstallez Claude Code dans le nouvel emplacement
npm install -g @anthropic-ai/claude-code

# Optionnel : Réinstallez vos paquets globaux précédents dans le nouvel emplacement
# Regardez ~/npm-global-packages.txt et installez les paquets que vous voulez garder
# npm install -g package1 package2 package3...

Pourquoi nous recommandons cette option :

• Évite de modifier les permissions des répertoires système
• Crée un emplacement propre et dédié pour vos paquets npm globaux
• Suit les meilleures pratiques de sécurité

Comme Claude Code est en développement actif, nous recommandons de configurer les mises à jour automatiques en utilisant l’option recommandée ci-dessus.

​

Désactiver la mise à jour automatique

Si vous préférez désactiver la mise à jour automatique plutôt que de corriger les permissions, vous pouvez utiliser :

claude config set -g autoUpdaterStatus disabled

​

Configuration du projet

Gérez la configuration du projet avec claude config set <clé> <valeur> (sans le drapeau -g) :

Par exemple :

# Laisser npm test s'exécuter sans approbation
claude config add allowedTools "Bash(npm test)"

# Laisser npm test et toutes ses sous-commandes s'exécuter sans approbation
claude config add allowedTools "Bash(npm test:*)"

# Indiquer à Claude d'ignorer node_modules
claude config add ignorePatterns node_modules
claude config add ignorePatterns "node_modules/**"

​

Optimiser votre configuration de terminal

Claude Code fonctionne mieux lorsque votre terminal est correctement configuré. Suivez ces directives pour optimiser votre expérience.

Shells pris en charge :

• Bash
• Zsh
• Fish

​

Thèmes et apparence

Claude ne peut pas contrôler le thème de votre terminal. C’est géré par votre application de terminal. Vous pouvez faire correspondre le thème de Claude Code à votre terminal pendant l’intégration ou à tout moment via la commande /config

​

Sauts de ligne

Vous avez plusieurs options pour entrer des sauts de ligne dans Claude Code :

• Échappement rapide : Tapez \ suivi de Entrée pour créer une nouvelle ligne
• Raccourci clavier : Appuyez sur Option+Entrée (Meta+Entrée) avec la configuration appropriée

Pour configurer Option+Entrée dans votre terminal :

Pour Mac Terminal.app :

1. Ouvrez Paramètres → Profils → Clavier
2. Cochez “Utiliser Option comme touche Meta”

Pour iTerm2 et terminal VSCode :

1. Ouvrez Paramètres → Profils → Touches
2. Sous Général, définissez la touche Option gauche/droite sur “Esc+”

Astuce pour les utilisateurs iTerm2 et VSCode : Exécutez /terminal-setup dans Claude Code pour configurer automatiquement Shift+Entrée comme alternative plus intuitive.

​

Configuration des notifications

Ne manquez jamais quand Claude termine une tâche avec une configuration appropriée des notifications :

Notifications sonores du terminal

Activez les alertes sonores lorsque les tâches se terminent :

claude config set --global preferredNotifChannel terminal_bell

Pour les utilisateurs macOS : N’oubliez pas d’activer les permissions de notification dans Réglages Système → Notifications → [Votre application de terminal].

Notifications système iTerm 2

Pour les alertes iTerm 2 lorsque les tâches se terminent :

1. Ouvrez les Préférences iTerm 2
2. Naviguez vers Profils → Terminal
3. Activez “Silence bell” et “Send notification when idle”
4. Définissez votre délai de notification préféré

Notez que ces notifications sont spécifiques à iTerm 2 et ne sont pas disponibles dans le Terminal macOS par défaut.

​

Gestion des entrées volumineuses

Lors du travail avec du code extensif ou de longues instructions :

• Évitez le collage direct : Claude Code peut avoir du mal avec le contenu collé très long
• Utilisez des flux de travail basés sur les fichiers : Écrivez le contenu dans un fichier et demandez à Claude de le lire
• Soyez conscient des limitations de VS Code : Le terminal VS Code est particulièrement sujet à tronquer les collages longs

En configurant ces paramètres, vous créerez un flux de travail plus fluide et plus efficace avec Claude Code.

​

Gérer les coûts efficacement

Claude Code consomme des tokens pour chaque interaction. L’utilisation typique coûte entre 5 et 10 $par développeur par jour, mais peut dépasser 100$ par heure lors d’une utilisation intensive.

​

Suivre vos coûts

• Utilisez /cost pour voir l’utilisation de la session actuelle
• Examinez le résumé des coûts affiché à la sortie
• Vérifiez l’utilisation historique dans la Console Anthropic
• Définissez des Limites de dépenses

​

Réduire l’utilisation des tokens

• Compactez les conversations : Utilisez /compact quand le contexte devient important
• Écrivez des requêtes spécifiques : Évitez les demandes vagues qui déclenchent des analyses inutiles
• Décomposez les tâches complexes : Divisez les grandes tâches en interactions ciblées
• Effacez l’historique entre les tâches : Utilisez /clear pour réinitialiser le contexte

Les coûts peuvent varier significativement selon :

• La taille de la base de code analysée
• La complexité des requêtes
• Le nombre de fichiers recherchés ou modifiés
• La longueur de l’historique des conversations
• La fréquence de compactage des conversations

​

Utiliser avec des API tierces

​

Se connecter à Amazon Bedrock

CLAUDE_CODE_USE_BEDROCK=1

Si vous souhaitez remplacer le modèle par défaut, vous pouvez passer la variable d’environnement ANTHROPIC_MODEL (Claude 3.7 Sonnet est utilisé par défaut) :

ANTHROPIC_MODEL='us.anthropic.claude-3-7-sonnet-20250219-v1:0'

Si vous souhaitez accéder à Claude Code via un proxy, vous pouvez utiliser la variable d’environnement ANTHROPIC_BEDROCK_BASE_URL :

ANTHROPIC_BEDROCK_BASE_URL='https://your-proxy-url'

Si vous n’avez pas activé la mise en cache des prompts, définissez également :

DISABLE_PROMPT_CACHING=1

Nécessite des identifiants AWS SDK standard (par exemple, ~/.aws/credentials ou des variables d’environnement pertinentes comme AWS_ACCESS_KEY_ID, AWS_SECRET_ACCESS_KEY). Pour configurer les identifiants AWS, exécutez :

aws configure

Contactez Amazon Bedrock pour la mise en cache des prompts pour des coûts réduits et des limites de taux plus élevées.

​

Se connecter à Google Vertex AI

CLAUDE_CODE_USE_VERTEX=1
CLOUD_ML_REGION=us-east5
ANTHROPIC_VERTEX_PROJECT_ID=your-project-id

Si vous souhaitez remplacer le modèle par défaut, vous pouvez passer la variable d’environnement ANTHROPIC_MODEL (Claude 3.7 Sonnet est utilisé par défaut) :

ANTHROPIC_MODEL='us.anthropic.claude-3-7-sonnet-20250219-v1:0'

Si vous souhaitez accéder à Claude Code via un proxy, vous pouvez utiliser la variable d’environnement ANTHROPIC_VERTEX_BASE_URL :

ANTHROPIC_VERTEX_BASE_URL='https://your-proxy-url'

Si vous n’avez pas activé la mise en cache des prompts, définissez également :

DISABLE_PROMPT_CACHING=1

Nécessite des identifiants GCP standard configurés via google-auth-library. Pour configurer les identifiants GCP, exécutez :

gcloud auth application-default login

Pour la meilleure expérience, contactez Google pour des limites de taux plus élevées.

​

Implémentation de référence du conteneur de développement

Claude Code fournit une configuration de conteneur de développement pour les équipes qui ont besoin d’environnements cohérents et sécurisés. Cette configuration devcontainer préconfigurée fonctionne parfaitement avec l’extension Remote - Containers de VS Code et les outils similaires.

Les mesures de sécurité renforcées du conteneur (isolation et règles de pare-feu) vous permettent d’exécuter claude --dangerously-skip-permissions pour contourner les invites de permission pour un fonctionnement sans surveillance. Nous avons inclus une implémentation de référence que vous pouvez personnaliser selon vos besoins.

​

Fonctionnalités clés

• Node.js prêt pour la production : Construit sur Node.js 20 avec les dépendances de développement essentielles
• Sécurité dès la conception : Pare-feu personnalisé restreignant l’accès réseau aux services nécessaires uniquement
• Outils conviviaux pour les développeurs : Inclut git, ZSH avec des améliorations de productivité, fzf, et plus
• Intégration transparente avec VS Code : Extensions et paramètres préconfigurés
• Persistance des sessions : Préserve l’historique des commandes et les configurations entre les redémarrages de conteneur
• Fonctionne partout : Compatible avec les environnements de développement macOS, Windows et Linux

​

Démarrage en 4 étapes

1. Installez VS Code et l’extension Remote - Containers
2. Clonez le dépôt d’implémentation de référence de Claude Code
3. Ouvrez le dépôt dans VS Code
4. Lorsque vous y êtes invité, cliquez sur “Rouvrir dans le conteneur” (ou utilisez la Palette de commandes : Cmd+Shift+P → “Remote-Containers : Rouvrir dans le conteneur”)

​

Décomposition de la configuration

La configuration devcontainer se compose de trois composants principaux :

• devcontainer.json : Contrôle les paramètres du conteneur, les extensions et les montages de volume
• Dockerfile : Définit l’image du conteneur et les outils installés
• init-firewall.sh : Établit les règles de sécurité réseau

​

Fonctionnalités de sécurité

Le conteneur implémente une approche de sécurité à plusieurs niveaux avec sa configuration de pare-feu :

• Contrôle d’accès précis : Restreint les connexions sortantes aux domaines sur liste blanche uniquement (registre npm, GitHub, API Anthropic, etc.)
• Politique de refus par défaut : Bloque tout autre accès réseau externe
• Vérification au démarrage : Valide les règles de pare-feu lors de l’initialisation du conteneur
• Isolation : Crée un environnement de développement sécurisé séparé de votre système principal

​

Options de personnalisation

La configuration devcontainer est conçue pour être adaptable à vos besoins :

• Ajoutez ou supprimez des extensions VS Code selon votre flux de travail
• Modifiez les allocations de ressources pour différents environnements matériels
• Ajustez les permissions d’accès réseau
• Personnalisez les configurations shell et les outils de développement

​

Prochaines étapes

​

Licence et utilisation des données

Claude Code est fourni comme aperçu de recherche Beta sous les Conditions d’utilisation commerciales d’Anthropic.

​

Comment nous utilisons vos données

Nous visons à être totalement transparents sur la façon dont nous utilisons vos données. Nous pouvons utiliser les retours pour améliorer nos produits et services, mais nous n’entraînerons pas de modèles génératifs en utilisant vos retours de Claude Code. Étant donné leur nature potentiellement sensible, nous stockons les transcriptions de retours utilisateur pendant seulement 30 jours.

​

Transcriptions de retours

Si vous choisissez de nous envoyer des retours sur Claude Code, comme des transcriptions de votre utilisation, Anthropic peut utiliser ces retours pour déboguer les problèmes liés et améliorer la fonctionnalité de Claude Code (par exemple, pour réduire le risque que des bugs similaires se reproduisent à l’avenir). Nous n’entraînerons pas de modèles génératifs en utilisant ces retours.

​

Protections de confidentialité

Nous avons mis en place plusieurs protections pour protéger vos données, y compris des périodes de rétention limitées pour les informations sensibles, un accès restreint aux données de session utilisateur, et des politiques claires contre l’utilisation des retours pour l’entraînement des modèles.

Pour plus de détails, veuillez consulter nos Conditions d’utilisation commerciales et notre Politique de confidentialité.

​

Licence

© Anthropic PBC. Tous droits réservés. L’utilisation est soumise aux Conditions d’utilisation commerciales d’Anthropic.