Tutoriel de configuration Claude Code
Claude Code utilise le protocole Anthropic Messages. Lors de la connexion à ai2save, l'adresse doit être remplie avec l'adresse racine du site https://ai2save.com, ne pas ajouter manuellement /v1 ; la clé doit être celle créée sur la console ai2save, sk-....
1. Préparer API Key
- Ouvrez https://ai2save.com/keys.
- Cliquez sur « Créer une clé », remplissez le nom et choisissez le groupe contenant le modèle Claude.
- Après la création, copiez immédiatement la clé complète. La clé complète n’est affichée qu’une seule fois.
2. Installer Claude Code
Terminez d’abord l’installation de l’environnement Node.js, puis exécutez :
npm install -g @anthropic-ai/claude-code
claude --version
Si la version est inférieure à celle requise par la passerelle, effectuez la mise à jour selon les instructions :
npm update -g @anthropic-ai/claude-code
3. Activation temporaire actuelle du terminal
macOS / Linux / WSL:
export ANTHROPIC_BASE_URL="https://ai2save.com"
export ANTHROPIC_AUTH_TOKEN="sk-votre-clé-api"
claude
Windows PowerShell :
$env:ANTHROPIC_BASE_URL="https://ai2save.com"
$env:ANTHROPIC_AUTH_TOKEN="sk-votre-clé-api"
claude
ANTHROPIC_AUTH_TOKEN est une variable réservée aux clés de relais. Ne définissez pas ANTHROPIC_API_KEY sur une autre clé officielle en même temps, afin d'éviter que Claude Code ne lise des informations d'identification incorrectes.
4. Écrire le fichier de configuration Claude Code (recommandé)
Modifiez ~/.claude/settings.json (Windows se trouve généralement dans %USERPROFILE%\.claude\settings.json) :
{
"$schema": "https://json.schemastore.org/claude-code-settings.json",
"env": {
"ANTHROPIC_BASE_URL": "https://ai2save.com",
"ANTHROPIC_AUTH_TOKEN": "sk-votre-clé-api"
}
}
Après avoir sauvegardé, rouvrez le terminal et lancez claude. Si vous souhaitez que cela ne s'applique qu'à un projet spécifique, écrivez le même contenu dans .claude/settings.local.json du projet, sans soumettre la clé réelle sur Git.
5. Sélectionner le modèle et vérifier
claude --model claude-sonnet-4-6
Après être entré dans l'interface interactive :
- Saisissez une courte question, par exemple « Bonjour, présentez-vous ».
- Si le contenu est retourné normalement, cela signifie que l'adresse, la clé et le groupe de modèles sont connectés.
- Pour changer de modèle, utilisez
/model; l'ID du modèle doit correspondre à l'ID ouvert dans la console.
Vous pouvez également utiliser Claude Code pour un diagnostic intégré afin de vérifier l'état de la configuration :
/status
/doctor
6. Multi-configuration et nettoyage des anciennes configurations
Si vous vous êtes déjà connecté à Claude officiel ou à d'autres relais :
- Priorisez l'utilisation de CC Switch pour gérer plusieurs fournisseurs, afin d'éviter les erreurs de configuration manuelles.
- Lors de la configuration manuelle, assurez-vous qu'aucun ancien
ANTHROPIC_BASE_URL,ANTHROPIC_AUTH_TOKENouANTHROPIC_API_KEYne remplace la valeur actuelle. - WSL et Windows sont deux environnements distincts ; après la configuration sur un terminal Windows, il est encore nécessaire de configurer séparément dans WSL.
Nettoyage temporaire sur macOS / Linux :
unset ANTHROPIC_API_KEY
Erreurs courantes
- 401 / invalid_api_key : La clé n'a pas été copiée complètement, a été révoquée, ou le groupe ne contient pas le modèle actuel.
- 404 / model not found : L'ID du modèle est incorrect, ou le groupe de cette clé n'a pas accès à ce modèle.
- Échec de connexion : Base URL écrit comme
https://ai2save.com/v1provoquera une erreur ; Claude Code doit être rempli avechttps://ai2save.com. - Toujours en train de demander l'adresse officielle : Vérifiez si des adresses anciennes subsistent dans
~/.claude/settings.json, le projet.claude/settings.local.jsonou les variables d'environnement du terminal. - Sous Windows, pas d'effet après ouverture : Quittez complètement le terminal, VS Code ou Claude Desktop, puis rouvrez.