Vue d'ensemble de 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

​

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 en une seule commande
$ claude commit

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

​

Avant de commencer

​

Vérifiez 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)
  • GitHub ou GitLab CLI 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

​

Installation et authentification

​

Initialisez votre projet

Pour les nouveaux utilisateurs, nous recommandons :

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

​

Utilisez 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 le code non familier

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

​

Automatiser les opérations Git

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

​

Éditer le code intelligemment

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

​

Tester et déboguer votre code

> lance les tests pour le module d'authentification et corrige les échecs
> trouve et corrige les vulnérabilités de sécurité
> explique 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échis à comment nous devrions architecturer le nouveau service de paiement
> réfléchis bien aux cas limites dans notre flux d'authentification

​

Contrôlez 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 pendant 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

Ajoutez ces URLs à la liste blanche lors de l’utilisation de Claude Code dans des environnements conteneurisés.

​

Optimisez votre configuration terminal et configurez votre environnement

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

Shells supportés :

• Bash
• Zsh (Shell Fish non supporté actuellement)

​

Thèmes et apparence

Claude ne peut pas contrôler le thème de votre terminal. Cela est géré par votre application 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 d’Entrée pour créer un saut de 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 Paramètres système → Notifications → [Votre application 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érez 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.

​

Suivez 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éduisez l’utilisation des tokens

• Conversations compactes : 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 de conversation
• La fréquence de compactage des conversations

​

Utilisation avec les API tierces

​

Se connecter à Amazon Bedrock

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

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 les variables d’environnement pertinentes comme AWS_ACCESS_KEY_ID, AWS_SECRET_ACCESS_KEY). 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=votre-id-projet

Nécessite des identifiants GCP standard configurés via google-auth-library. 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 des 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 préconfigurées et paramètres optimisés
• Persistance des sessions : Préserve l’historique des commandes et les configurations entre les redémarrages du 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é multicouche avec sa configuration de pare-feu :

• Contrôle d’accès précis : Restreint les connexions sortantes aux domaines en 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 du 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 :

• Ajout ou suppression d’extensions VS Code selon votre flux de travail
• Modification des allocations de ressources pour différents environnements matériels
• Ajustement des permissions d’accès réseau
• Personnalisation des configurations shell et des outils de développement

​

Prochaines étapes

​

Licence et utilisation des données

Claude Code est fourni comme un aperçu de recherche Bêta 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). Nous n’entraînerons pas de modèles génératifs en utilisant ces retours.

​

Protections de la 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.