Passer au contenu principal
Claude Code est un agent de programmation en terminal qui comprend votre base de code et vous aide à coder plus rapidement grâce aux commandes en langage naturel - exécutant des tâches routinières, expliquant du code complexe et gérant les workflows git. Claude Code devient encore plus puissant avec le Coding Plan — Le forfait Pro offre plus que Claude Pro (20 USD/mois), le forfait Max offre plus que Claude Max (200 USD/mois). Codez plus vite, déboguez plus intelligemment et gérez les workflows de manière fluide avec plus de tokens et une fiabilité accrue.

Étape 1 : Installer Claude Code

Prérequis : Node.js 18 ou plus récent
# Installer Claude Code
npm install -g @anthropic-ai/claude-code
Si vous rencontrez des erreurs de permission pendant l’installation, essayez d’utiliser sudo (MacOS/Linux) ou exécutez l’invite de commande en tant qu’administrateur (Windows).

Étape 2 : Configurer le Coding Plan

1

Obtenir la Clé API

2

Configurer les Variables d'Environnement

Il existe 2 façons de configurer : via le fichier settings.json (recommandé) ou via l’export de variables d’environnement.

Étape 1 : Localiser le chemin correct du fichier settings.json

Le fichier de configuration se trouve à différents emplacements selon votre système d’exploitation :
Chemin : %USERPROFILE%\.claude\settings.jsonExemple : C:\Users\VotreNom\.claude\settings.json

Étape 2 : Ouvrir settings.json pour l’édition

Choisissez l’une des méthodes suivantes pour ouvrir le fichier :
# Sous Windows (Git Bash ou WSL)
claude --settings "$USERPROFILE\.claude\settings.json"

# Sous macOS/Linux
claude --settings ~/.claude/settings.json
Cette commande ouvre le fichier dans l’éditeur par défaut de votre système. Si cela ne fonctionne pas, essayez une autre méthode ci-dessous.

Étape 3 : Ajouter la configuration au fichier

Ajoutez les champs env au fichier settings.json :
{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "votre_cle_api",
    "ANTHROPIC_BASE_URL": "https://api.vibecodecheap.com/v1/ai",
    "API_TIMEOUT_MS": "3000000"
  }
}
Remplacez votre_cle_api par votre Clé API VibeCodeCheap et enregistrez le fichier.

Dépannage courant

Cause : Les commandes comme code, cursor peuvent ne pas être dans PATH, ou le fichier s’ouvre au mauvais emplacement.Solution :
  1. Vérifier l’emplacement du fichier :
    # Windows (PowerShell)
    ls $env:USERPROFILE\.claude\settings.json
    
    # macOS/Linux
    ls -la ~/.claude/settings.json
    
  2. Si le fichier n’existe pas, créer le répertoire et le fichier :
    # Windows (PowerShell)
    mkdir -Force $env:USERPROFILE\.claude
    echo '{"env":{}}' > $env:USERPROFILE\.claude\settings.json
    
    # macOS/Linux
    mkdir -p ~/.claude
    echo '{"env":{}}' > ~/.claude/settings.json
    
  3. Ouvrir le fichier avec le chemin absolu :
    # Windows
    code "C:\Users\VotreNom\.claude\settings.json"
    
    # macOS
    code "/Users/VotreNom/.claude/settings.json"
    
  1. Vérifier le format JSON : Utiliser JSONLint pour valider
  2. Fermer tous les terminaux exécutant Claude Code
  3. Ouvrir un nouveau terminal et exécuter claude à nouveau
  4. Exécuter /status dans Claude Code pour vérifier la configuration
Cause : Le répertoire .claude n’a pas été créé car Claude Code n’a pas encore été exécuté.Solution :
  1. Exécuter claude une fois (peut quitter immédiatement)
  2. Ou créer manuellement :
    # Windows
    mkdir %USERPROFILE%\.claude
    
    # macOS/Linux
    mkdir -p ~/.claude
    
Cause : Claude Code peut automatiquement écraser settings.json dans certains cas.Solution :
  1. Sauvegarder le fichier de configuration :
    cp ~/.claude/settings.json ~/.claude/settings.json.backup
    
  2. Verrouiller le fichier pour éviter l’écrasement (seulement si nécessaire) :
    # macOS/Linux
    chmod 444 ~/.claude/settings.json
    
    # Windows (PowerShell - exécuter en tant qu'administrateur)
    Set-ItemProperty -Path "$env:USERPROFILE\.claude\settings.json" -Name IsReadOnly -Value $true
    
  3. Déverrouiller si modification nécessaire :
    # macOS/Linux
    chmod 644 ~/.claude/settings.json
    
    # Windows (PowerShell)
    Set-ItemProperty -Path "$env:USERPROFILE\.claude\settings.json" -Name IsReadOnly -Value $false
    
Cause : WSL utilise Node.js de Windows au lieu de la version Linux.Vérifier :
which node
which npm
# Si le résultat est /mnt/c/... alors utilise Node de Windows
Solution :
  1. Installer Node.js pour Linux :
    # Avec nvm (recommandé)
    curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash
    source ~/.bashrc
    nvm install --lts
    
    # Ou avec le gestionnaire de paquets
    sudo apt update
    sudo apt install nodejs npm
    
  2. Corriger la priorité du PATH - Ajouter à ~/.bashrc ou ~/.zshrc :
    # S'assurer que nvm est chargé
    export NVM_DIR="$HOME/.nvm"
    [ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh"
    
    # Prioriser les chemins Linux
    export PATH="$HOME/.local/bin:/usr/local/bin:/usr/bin:$PATH"
    
  3. Appliquer les changements :
    source ~/.bashrc
    
Cause : macOS a la sécurité gatekeeper et SIP (System Integrity Protection).Solution :
  1. Autoriser le terminal à accéder aux fichiers :
    • Ouvrir Réglages Système > Confidentialité et sécurité > Accès complet au disque
    • Ajouter Terminal.app ou iTerm2
  2. Corriger les permissions du répertoire :
    sudo chown -R $(whoami) ~/.claude
    chmod -R u+w ~/.claude
    

Étape 3 : Commencer avec Claude Code

Après la configuration, vous pouvez commencer à utiliser Claude Code dans le terminal :
cd votre-repertoire-projet
claude
Si vous utilisez Windows, vous devez exécuter claude en utilisant Git Bash ou Ubuntu (WSL) pour la première fois.
Lors de la première exécution de Claude Code, vous pourriez voir une invite de sécurité demandant l’autorisation d’accès aux fichiers :
Do you trust the files in this folder?

 Claude Code may read, write, or execute files contained in this directory. 
 This can pose security risks, so only use files from trusted sources.

 ❯ 1. Yes, proceed
   2. No, exit
Sélectionnez “Yes, proceed” et appuyez sur Entrée pour accorder à Claude Code l’accès aux fichiers dans votre répertoire de projet.

FAQ

Comment Changer le Modèle Utilisé

Correspondance entre les variables d’environnement internes de Claude Code et les modèles :
ModèleMultiplicateurContexte
claude-sonnet-4-51x200K tokens
claude-sonnet-4-5-202509291x200K tokens
claude-opus-4-5-202511012x200K tokens
gpt-5-mini0x (gratuit)128K tokens
glm-4.60x (gratuit)200K tokens
glm-4.70x (gratuit)200K tokens
gpt-5-mini, glm-4.6 et glm-4.7 sont des modèles gratuits avec utilisation illimitée lors de l’abonnement au Coding Plan sur VibeCodeCheap.
Si vous devez ajuster, vous pouvez directement éditer le fichier de configuration ~/.claude/settings.json :
{
  "env": {
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-haiku-4-5-20251001",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-4-5-20250929",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-4-5-20251101"
  }
}

Comment Vérifier l’État Actuel du Modèle

Ouvrez un nouveau terminal et exécutez claude, entrez /help pour voir toutes les commandes disponibles.
  • Entrez /status pour vérifier l’état actuel du modèle.
  • Entrez /models pour lister tous les modèles disponibles.

La Configuration Manuelle Ne Fonctionne Pas

Si vous avez édité le fichier ~/.claude/settings.json mais que les changements ne prennent pas effet :
  • Fermez toutes les fenêtres Claude Code, ouvrez un nouveau terminal et exécutez claude à nouveau.
  • Si ça ne fonctionne toujours pas, essayez de supprimer le fichier ~/.claude/settings.json et de reconfigurer.
  • Confirmez que le format JSON est correct, vérifiez les noms de variables et assurez-vous qu’il n’y a pas de virgules manquantes ou en trop.

Version Recommandée de Claude Code

Nous recommandons d’utiliser la dernière version de Claude Code :
# Vérifier la version actuelle
claude --version

# Mettre à jour vers la dernière version
claude update