Guide d'utilisation de Claude Code

Claude Code utilise le protocole natif de Claude, il dépend donc de l'interface POST /v1/messages de ce projet, et non de /v1/chat/completions.

Étape préalable : désactiver la connexion guidée

Ouvrez ~/.claude.json, recherchez hasCompletedOnboarding et définissez-le sur true :

{
  "hasCompletedOnboarding": true
}

Méthode 1 (recommandée) : définir directement les variables d'environnement

Si vous ne souhaitez pas créer de fichier de configuration supplémentaire, vous pouvez simplement définir les variables d'environnement dans le terminal.

Mac/Linux

export ANTHROPIC_BASE_URL="https://api.magickapi.com"
export ANTHROPIC_AUTH_TOKEN="Clé API générée dans le panneau d'administration"
export CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1

Windows CMD

set ANTHROPIC_BASE_URL=https://api.magickapi.com
set ANTHROPIC_AUTH_TOKEN=Clé API générée dans le panneau d'administration
set CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1

PowerShell

$env:ANTHROPIC_BASE_URL="https://api.magickapi.com"
$env:ANTHROPIC_AUTH_TOKEN="Clé API générée dans le panneau d'administration"
$env:CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1

Après avoir exécuté les trois commandes ci-dessus, accédez au répertoire du projet à développer et lancez directement :

claude

Claude Code lira automatiquement les variables d'environnement du terminal actuel, il n'est pas nécessaire de saisir à nouveau la clé API.

Méthode 2 : modifier les fichiers de configuration (méthode classique)

Si vous préférez continuer à utiliser l'ancienne méthode de configuration par fichiers, vous pouvez suivre les instructions ci-dessous.

Configurer ~/.claude/settings.json

Chemin du fichier : ~/.claude/settings.json

{
  "env": {
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1",
    "CLAUDE_CODE_ATTRIBUTION_HEADER": "0",
    "DISABLE_INSTALLATION_CHECKS": "1",
    "ENABLE_TOOL_SEARCH": "1"
  },
  "cleanupPeriodDays": 720
}

Configurer ~/.claude/settings.xxxx.json

Chemin du fichier : ~/.claude/settings.xxxx.json

Ici, xxxx peut être personnalisé pour distinguer différents environnements ou comptes :

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.magickapi.com",
    "ANTHROPIC_AUTH_TOKEN": "Clé API générée dans le panneau d'administration"
  }
}

Lancer Claude Code avec une configuration spécifique

claude --settings ~/.claude/settings.xxxx.json

Remarques

• Pour ANTHROPIC_AUTH_TOKEN, veuillez renseigner la clé secrète générée dans le panneau d'administration de Magick API.
• Si vous avez déjà défini les variables d'environnement dans le terminal actuel, il suffit d'exécuter claude directement.
• Claude Code envoie les en-têtes comme anthropic-version selon les habitudes du client Claude ; le point d'entrée /v1/messages de ce projet est compatible avec cette forme de requête.
• Si vous avez besoin d'une chaîne d'outils de style OpenAI, veuillez utiliser Codex ou appeler directement /v1/chat/completions.