Configuration de Claude Code

getting-started / Configuration de Claude Code

Configuration de Claude Code

Configurer les variables d'environnement requises

Avant de lancer Claude Code CLI ou l'extension VS Code, vous devez préparer plusieurs variables d'environnement. Il est recommandé de les configurer une fois pour toutes dans les paramètres de votre shell/système, puis de rouvrir le terminal ou l'éditeur après modification, afin que chaque nouvelle session en hérite automatiquement.

macOS ou Linux

Ajoutez le contenu suivant à ~/.zshrc (zsh) ou ~/.bashrc (bash) :

1
# Claude Code
2
export ANTHROPIC_BASE_URL="https://www.codebyai.net/api/agent"
3
export ANTHROPIC_AUTH_TOKEN="sk-proj-xxxx" # Remplacez par la clé API que vous venez de copier
4
export API_TIMEOUT_MS=600000
5
export CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1

Exécutez source ~/.zshrc après avoir enregistré le fichier pour que la configuration prenne effet immédiatement.

Si vous préférez les ajouter une par une, vous pouvez exécuter (les utilisateurs bash changent ~/.zshrc en ~/.bashrc) :

1
echo 'export ANTHROPIC_BASE_URL="https://www.codebyai.net/api/agent"' >> ~/.zshrc
2
echo 'export ANTHROPIC_AUTH_TOKEN="sk-proj-xxxx"' >> ~/.zshrc
3
echo 'export API_TIMEOUT_MS=600000' >> ~/.zshrc
4
echo 'export CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1' >> ~/.zshrc
5
 
6
source ~/.zshrc

Windows

Vous pouvez utiliser l'une des méthodes suivantes pour effectuer la même configuration :

Méthode 1 · GUI (Recommandé, Permanent)

  1. Appuyez sur Win + R, tapez sysdm.cpl et appuyez sur Entrée.
  2. Ouvrez Paramètres système avancésVariables d'environnement.
  3. Dans Variables utilisateur, cliquez sur Nouvelle, et ajoutez-les une par une :
    • ANTHROPIC_BASE_URLhttps://www.codebyai.net/api/agent
    • ANTHROPIC_AUTH_TOKENsk-proj-xxxx
    • API_TIMEOUT_MS600000
    • CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC1
  4. Fermez toutes les fenêtres et redémarrez votre terminal ou IDE.

Méthode 2 · Invite de commandes (Permanent)

1
setx ANTHROPIC_BASE_URL "https://www.codebyai.net/api/agent"
2
setx ANTHROPIC_AUTH_TOKEN "sk-proj-xxxx"
3
setx API_TIMEOUT_MS "600000"
4
setx CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC "1"

Méthode 3 · PowerShell (Permanent)

1
[System.Environment]::SetEnvironmentVariable('ANTHROPIC_BASE_URL', 'https://www.codebyai.net/api/agent', 'User')
2
[System.Environment]::SetEnvironmentVariable('ANTHROPIC_AUTH_TOKEN', 'sk-proj-xxxx', 'User')
3
[System.Environment]::SetEnvironmentVariable('API_TIMEOUT_MS', '600000', 'User')
4
[System.Environment]::SetEnvironmentVariable('CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC', '1', 'User')

Méthode 4 · Session temporaire (Valide uniquement pour la fenêtre CMD actuelle)

1
set ANTHROPIC_BASE_URL=https://www.codebyai.net/api/agent
2
set ANTHROPIC_AUTH_TOKEN=sk-proj-xxxx
3
set API_TIMEOUT_MS=600000
4
set CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1

Démarrer l'environnement de codage Claude

Exécutez dans n'importe quel répertoire de projet :

1
cd your-project
2
claude

Après un démarrage réussi, vous verrez une interface similaire à celle-ci :

Si vous utilisez des extensions VS Code (ou autre IDE), ces variables d'environnement sont également requises. Si vous voyez l'invite suivante :

Cela signifie que l'extension n'a pas lu la configuration, et vous devez revérifier. Vous pouvez également coder en dur ces valeurs directement dans le fichier de configuration :

  • Paramètres globaux Claude

    • macOS/Linux : ~/.claude/settings.json
    • Windows : C:/Users/<UserName>/.claude/settings.json Exemple de contenu :
    1
    {
    2
      "env": {
    3
        "ANTHROPIC_AUTH_TOKEN": "sk-proj-xxxx",
    4
        "ANTHROPIC_BASE_URL": "https://www.codebyai.net/api/agent",
    5
        "API_TIMEOUT_MS": "600000",
    6
        "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1"
    7
      }
    8
    }
  • VS Code settings.json – Ajouter :

    1
    "claudeCode.environmentVariables": [
    2
      { "name": "ANTHROPIC_BASE_URL", "value": "https://www.codebyai.net/api/agent" },
    3
      { "name": "ANTHROPIC_AUTH_TOKEN", "value": "sk-proj-xxxx" }
    4
    ],

Après modification, veuillez recharger VS Code ou redémarrer le terminal.

Configuration de Claude Code - Documentation | Code By AI | Agents de codage IA unifiés