--- title: "Intégration de Claude Code" description: "Connecter Claude Code à 1折AI : avec ANTHROPIC_BASE_URL et ANTHROPIC_AUTH_TOKEN (variables d'environnement ou settings.json), avec la syntaxe Windows, le mapping des modèles, l'extension VS Code et les erreurs courantes." headingIds: {"Chemin le plus court":"section-1","Étapes complètes":"section-2","Pourquoi utiliser ANTHROPIC_AUTH_TOKEN":"section-3","Mapping des modèles":"section-4","Extension VS Code":"section-5","Paramètres facultatifs":"section-6","Questions fréquentes":"section-7"} --- Claude Code n'a besoin que de deux variables : `ANTHROPIC_BASE_URL` pointe vers nous, `ANTHROPIC_AUTH_TOKEN` contient votre clé API (API key). Aucune connexion à un compte Anthropic n'est nécessaire. ## Chemin le plus court Si Claude Code est déjà installé et que vous avez une clé API, ajoutez les deux lignes suivantes dans `~/.claude/settings.json`, puis exécutez `claude` : ```json title="~/.claude/settings.json" { "env": { "ANTHROPIC_BASE_URL": "https://1zheai.com", "ANTHROPIC_AUTH_TOKEN": "sk-你的Key" } } ``` Si le fichier existe déjà, fusionnez ces deux éléments dans votre `env` existant, sans écraser les autres configurations. ## Étapes complètes Si déjà installé, vous pouvez passer cette étape. Les commandes suivantes proviennent de la [documentation officielle d'installation de Claude Code](https://code.claude.com/docs/en/setup) : ```bash title="macOS / Linux" curl -fsSL https://claude.ai/install.sh | bash ``` ```powershell title="Windows PowerShell" irm https://claude.ai/install.ps1 | iex ``` ```bash title="Homebrew" brew install --cask claude-code ``` ```bash title="npm（需要 Node.js 22+）" npm install -g @anthropic-ai/claude-code ``` N'ajoutez pas `sudo` lors de l'installation via npm. Créez une clé API dans la [console](https://1zheai.com/console?lng=fr), idéalement dédiée à Claude Code sur cette machine. Voir [Obtenir et gérer les clés API](/fr/docs/api-keys/). Emplacement de settings.json : macOS / Linux : `~/.claude/settings.json`, Windows : `%USERPROFILE%\.claude\settings.json`. ```json title="settings.json（推荐）" { "env": { "ANTHROPIC_BASE_URL": "https://1zheai.com", "ANTHROPIC_AUTH_TOKEN": "sk-你的Key" } } ``` ```bash title="macOS / Linux 环境变量" # 写进 ~/.zshrc 或 ~/.bashrc，然后重开终端 export ANTHROPIC_BASE_URL="https://1zheai.com" export ANTHROPIC_AUTH_TOKEN="sk-你的Key" ``` ```powershell title="Windows PowerShell" # 持久写入当前用户，重开终端后生效 [Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://1zheai.com", "User") [Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", "sk-你的Key", "User") # 只在当前窗口生效 $env:ANTHROPIC_BASE_URL = "https://1zheai.com" $env:ANTHROPIC_AUTH_TOKEN = "sk-你的Key" ``` ```bat title="Windows CMD" setx ANTHROPIC_BASE_URL "https://1zheai.com" setx ANTHROPIC_AUTH_TOKEN "sk-你的Key" ``` `ANTHROPIC_BASE_URL` doit contenir l'adresse de base, sans ajouter `/v1` ; Claude Code assemblera lui-même `/v1/messages`. Dans le répertoire du projet, exécutez `claude`, puis saisissez `/status`. Vérifiez deux lignes : - la ligne de l'URL de base affiche `https://1zheai.com` - la ligne des identifiants indique que la source est `ANTHROPIC_AUTH_TOKEN` Posez ensuite une question, puis consultez les [journaux d'appels](/fr/docs/usage-logs/) pour vérifier s'il y a un nouvel enregistrement. S'il y en a un, la connexion est établie. Si vous ne souhaitez pas entrer dans l'interface interactive, vous pouvez également tester en mode non interactif (testé le 2026-10-15, retour `ok`) : ```bash claude -p "say ok" --model claude-sonnet-4-6 ``` ## Pourquoi utiliser ANTHROPIC_AUTH_TOKEN Claude Code dispose de deux variables pouvant contenir la clé API, avec les différences suivantes ([explication officielle](https://code.claude.com/docs/en/authentication)) : | Variable | Méthode d'envoi | Comportement | |---|---|---| | `ANTHROPIC_AUTH_TOKEN` | `Authorization: Bearer <值>` | Prend effet immédiatement après le réglage, sans demande de confirmation | | `ANTHROPIC_API_KEY` | `x-api-key: <值>` | En mode interactif, une fenêtre demande la première fois si vous souhaitez utiliser cette clé API | Les deux sont prises en charge ; nous recommandons `ANTHROPIC_AUTH_TOKEN`. **N'en configurez qu'une seule des deux** : si un ancien `ANTHROPIC_API_KEY` officiel subsiste dans le système, supprimez-le pour éviter un mélange entraînant une erreur 401. Deux règles faciles à négliger : - Lorsque le `env` de `settings.json` et un export dans le terminal définissent la même variable, **settings.json prime**. Si la modification de la variable du terminal n'a pas pris effet, vérifiez d'abord settings.json. - N'écrivez pas la clé API dans le `.claude/settings.json` du projet, ce fichier étant généralement soumis au dépôt. Pour différencier par projet, utilisez le `.claude/settings.local.json` non soumis. ## Mapping des modèles Dans Claude Code, `opus`, `sonnet`, `haiku` et `fable` sont des alias ; vous pouvez préciser via des variables d'environnement les modèles concrets auxquels ils correspondent. Le niveau Haiku est également utilisé par Claude Code pour exécuter certaines petites tâches d'arrière-plan. | Variable | Rôle | Valeur d'exemple | |---|---|---| | `ANTHROPIC_MODEL` | Modèle utilisé au démarrage | `claude-sonnet-5-5` | | `ANTHROPIC_DEFAULT_OPUS_MODEL` | Modèle auquel pointe l'alias `opus` | `claude-opus-5-5` | | `ANTHROPIC_DEFAULT_SONNET_MODEL` | Modèle auquel pointe l'alias `sonnet` | `claude-sonnet-5-5` | | `ANTHROPIC_DEFAULT_HAIKU_MODEL` | Modèle pour l'alias `haiku` et les tâches d'arrière-plan | `claude-haiku-5-5` | | `ANTHROPIC_DEFAULT_FABLE_MODEL` | Modèle auquel pointe l'alias `fable` | `claude-fable-5-1` | ```json title="~/.claude/settings.json（带模型映射）" { "env": { "ANTHROPIC_BASE_URL": "https://1zheai.com", "ANTHROPIC_AUTH_TOKEN": "sk-你的Key", "ANTHROPIC_MODEL": "claude-sonnet-5-5", "ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-5-5", "ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-5-5", "ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-haiku-5-5" } } ``` L'ID du modèle doit figurer parmi les [modèles pris en charge](/fr/docs/models/). Pendant l'exécution, vous pouvez aussi basculer temporairement avec `/model claude-opus-5-5`. ## Extension VS Code L'extension VS Code de Claude Code vérifie les identifiants avant le démarrage ; l'officiel recommande de placer les variables dans les paramètres utilisateur de VS Code eux-mêmes (palette de commandes → Preferences: Open User Settings (JSON)) : ```json title="VS Code settings.json" { "claudeCode.environmentVariables": [ { "name": "ANTHROPIC_BASE_URL", "value": "https://1zheai.com" }, { "name": "ANTHROPIC_AUTH_TOKEN", "value": "sk-你的Key" } ] } ``` Si vous n'écrivez que dans `~/.claude/settings.json`, la vérification de connexion propre à l'extension risque de ne pas les lire. ## Paramètres facultatifs | Variable | Rôle | |---|---| | `API_TIMEOUT_MS` | Délai d'attente des requêtes, 600000 par défaut (10 minutes) ; à augmenter si les tâches longues dépassent souvent le délai | | `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1` | Désactive les mises à jour automatiques, la télémétrie, la remontée d'erreurs et autres flux non essentiels. Attention : la valeur `0` ou `false` compte aussi comme activé ; pour désactiver, il faut supprimer cette variable | | `CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1` | À utiliser face aux erreurs 400 du type "Extra inputs are not permitted" | | `CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY=1` | Fait récupérer la liste `/model` des modèles disponibles depuis `/v1/models` | `CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY=1` a été testé et fonctionne (Claude Code 2.1.296, 2026-10-15) : après le démarrage, le journal de debug contient `[gatewayDiscovery] cached 14 models`, et les 14 modèles correspondent aux [modèles pris en charge](/fr/docs/models/). Ne configurez pas `DISABLE_PROMPT_CACHING` : cela désactive le cache et la facture augmentera nettement, voir [Prompt Caching](/fr/docs/prompt-caching/). ## Questions fréquentes Claude Code n'a pas lu la clé API. Vérifiez l'orthographe du nom de la variable ; si vous utilisez des variables d'environnement, assurez-vous de lancer dans un terminal nouvellement ouvert ; si vous utilisez settings.json, vérifiez le format JSON (une virgule en trop invalide l'ensemble). La clé API a été copiée de façon incomplète, ou `ANTHROPIC_API_KEY` et `ANTHROPIC_AUTH_TOKEN` coexistent avec l'une des valeurs obsolètes. Ne gardez qu'une seule des deux. Pour plus de détails, voir [codes d'erreur et dépannage](/fr/docs/troubleshooting/). `ANTHROPIC_BASE_URL` contient en trop `/v1`. Remplacez par `https://1zheai.com`. C'est Claude Code qui exécute de petites tâches d'arrière-plan avec le niveau Haiku. Pour changer de modèle, définissez `ANTHROPIC_DEFAULT_HAIKU_MODEL`. Supprimez (ou commentez) les deux variables ci-dessus pour revenir à la connexion officielle. Si vous basculez souvent, utilisez [CC Switch](/fr/docs/quickstart-cc-switch/) : un clic suffit. Aucune association n'est créée. Lors de l'intégration à 1折AI, Claude Code utilise notre clé API et ne se connecte pas à votre compte Anthropic.