ai2saveai2save

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

  1. Ouvrez https://ai2save.com/keys.
  2. Cliquez sur « Créer une clé », remplissez le nom et choisissez le groupe contenant le modèle Claude.
  3. 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 :

  1. Saisissez une courte question, par exemple « Bonjour, présentez-vous ».
  2. Si le contenu est retourné normalement, cela signifie que l'adresse, la clé et le groupe de modèles sont connectés.
  3. 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_TOKEN ou ANTHROPIC_API_KEY ne 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/v1 provoquera une erreur ; Claude Code doit être rempli avec https://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.json ou 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.