Ce guide d’utilisation de Claude ne traite que de Claude Code : de l’installation à la première exécution, l’association d’une clé API, le changement de compte, puis les abonnements et le dépannage des erreurs courantes. Suivez les étapes et vous pourrez faire tourner Claude Code dans votre terminal local. Les commandes de l’article conviennent à Windows/macOS/Linux ; j’essaie de signaler les pièges dès le début pour éviter les détours.
1) Installer Claude Code : préparation de l’environnement et première exécution
Claude Code dépend de Node.js ; il est recommandé d’installer Node.js 18 ou une version supérieure et de vérifier que npm fonctionne dans le terminal. Exécutez ensuite l’installation globale :
npm install -g @anthropic-ai/claude-code
Après l’installation, utilisez
claude --version
pour vérifier que le numéro de version s’affiche.
Lors de la première exécution de Claude Code, il vous sera généralement demandé de configurer la clé API d’Anthropic. Vous pouvez aussi définir à l’avance la variable d’environnement ANTHROPIC_API_KEY dans le système, puis démarrer Claude Code, afin d’éviter de la ressaisir.
2) Association et changement de compte : gérer via la clé API est le plus simple
Le « login » de Claude Code repose essentiellement sur l’association d’une clé API : une clé correspond à une source de facturation et de droits. Pour changer de compte, la méthode la plus fiable consiste à remplacer ANTHROPIC_API_KEY (ou à remplacer la clé dans le fichier de configuration généré lors de la première exécution de Claude Code ; le chemin exact est indiqué lors de l’initialisation).
Si vous alternez entre un compte entreprise et un compte personnel, il est recommandé de définir des variables d’environnement distinctes par session de terminal, afin d’éviter de figer la clé dans la configuration globale et de réduire les risques de mauvaise utilisation et de fuite.
3) Différences entre formules et astuces pour économiser : choisir selon le scénario d’usage
Les abonnements liés à Claude sont souvent Pro et Max (prix et avantages pouvant changer selon les ajustements officiels), davantage adaptés aux dialogues fréquents sur le web ; tandis que, pour Claude Code, le coût le plus courant provient du volume d’appels API. Pour les développeurs, regrouper les grosses tâches sur un ou deux jours, puis ne faire que de petites modifications le reste du temps, revient généralement moins cher que de le laisser « ouvert » en usage intensif sur la durée.
Pour les utilisateurs en Chine continentale, en cas de restrictions de paiement ou de réseau, privilégiez des canaux de paiement API conformes ou une facturation unifiée via entreprise/équipe ; il n’est pas recommandé d’utiliser des clés d’origine inconnue, car cela peut déclencher des contrôles de risque et interrompre Claude Code en plein milieu.
4) Problèmes courants et dépannage : échec d’abonnement, erreurs de requête, compte verrouillé
Les échecs d’abonnement proviennent le plus souvent d’un mode de paiement, d’une région ou d’informations de facturation non concordants ; commencez par vérifier l’authentification 3DS de la carte, l’adresse de facturation et la prise en charge de la devise ; si vous n’utilisez que Claude Code, assurez-vous que vous avez réellement besoin d’un abonnement, ou seulement d’une clé API valide et d’un quota.
Les erreurs de requête (p. ex. délai dépassé/interruption) sont généralement dues à un réseau instable, à une concurrence trop élevée ou à un contexte trop long. Ordre de traitement conseillé : passer à un réseau plus stable → réduire la quantité de saisie et l’ampleur des modifications en une fois → faire exécuter Claude Code par étapes (d’abord analyser, puis modifier, puis tester).
En cas de compte verrouillé ou de clé invalide, commencez par vérifier dans la console si la clé a été révoquée, si le quota est épuisé et si des appels anormaux ont été déclenchés. Après avoir remplacé par une nouvelle clé API, redémarrer Claude Code permet généralement de rétablir le fonctionnement ; si les erreurs persistent, vérifiez ensuite le proxy local / l’interception de certificats et si l’heure système est correcte.
