Intégration de Claude Code

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.

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 :

1
{
2
  "env": {
3
    "ANTHROPIC_BASE_URL": "https://1zheai.com",
4
    "ANTHROPIC_AUTH_TOKEN": "sk-你的Key"
5
  }
6
}

Si le fichier existe déjà, fusionnez ces deux éléments dans votre env existant, sans écraser les autres configurations.

Étapes complètes

Installer Claude Code
Si déjà installé, vous pouvez passer cette étape. Les commandes suivantes proviennent de la documentation officielle d’installation de Claude Code :
macOS / Linux
Windows PowerShell
Homebrew
npm（需要 Node.js 22+）
macOS / Linux
curl -fsSL https://claude.ai/install.sh | bash
Windows PowerShell
irm https://claude.ai/install.ps1 | iex
Homebrew
brew install --cask claude-code
npm（需要 Node.js 22+）
npm install -g @anthropic-ai/claude-code
N’ajoutez pas sudo lors de l’installation via npm.
Obtenir une clé API
Créez une clé API dans la console, idéalement dédiée à Claude Code sur cette machine. Voir Obtenir et gérer les clés API.

Configuration (trois choix)

Emplacement de settings.json : macOS / Linux : ~/.claude/settings.json, Windows : %USERPROFILE%\.claude\settings.json.

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://1zheai.com",
    "ANTHROPIC_AUTH_TOKEN": "sk-你的Key"
  }
}

# 写进 ~/.zshrc 或 ~/.bashrc，然后重开终端
export ANTHROPIC_BASE_URL="https://1zheai.com"
export ANTHROPIC_AUTH_TOKEN="sk-你的Key"

# 持久写入当前用户，重开终端后生效
[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"

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.

Démarrer et confirmer
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 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
```
1
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) :

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`

1
{
2
  "env": {
3
    "ANTHROPIC_BASE_URL": "https://1zheai.com",
4
    "ANTHROPIC_AUTH_TOKEN": "sk-你的Key",
5
    "ANTHROPIC_MODEL": "claude-sonnet-5-5",
6
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-5-5",
7
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-5-5",
8
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-haiku-5-5"
9
  }
10
}

L’ID du modèle doit figurer parmi les modèles pris en charge. 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)) :

1
{
2
  "claudeCode.environmentVariables": [
3
    { "name": "ANTHROPIC_BASE_URL", "value": "https://1zheai.com" },
4
    { "name": "ANTHROPIC_AUTH_TOKEN", "value": "sk-你的Key" }
5
  ]
6
}

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.

Ne configurez pas DISABLE_PROMPT_CACHING : cela désactive le cache et la facture augmentera nettement, voir Prompt Caching.

Questions fréquentes

L'interface de connexion s'affiche au démarrage / invite Please run /login

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).

401 / Invalid API key

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.

404

ANTHROPIC_BASE_URL contient en trop /v1. Remplacez par https://1zheai.com.

Opus sélectionné, mais des appels à Haiku apparaissent dans les journaux

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.

Comment basculer entre le compte officiel et 1折AI ?

Supprimez (ou commentez) les deux variables ci-dessus pour revenir à la connexion officielle. Si vous basculez souvent, utilisez CC Switch : un clic suffit.

L'utilisation de 1折AI affecte-t-elle mon compte Anthropic ?

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.