Accueil / Documentation / Claude Code

Claude Code

Configurez l’agent CLI d’Anthropic pour utiliser la passerelle avec deux variables d’environnement, et évitez le piège qui facture silencieusement la mauvaise clé.

Claude Code lit son point de terminaison dans l’environnement ; aucune modification du code n’est donc nécessaire. C’est la configuration la plus courante sur la passerelle.

Configuration

export ANTHROPIC_BASE_URL="https://aiprimetech.io"
export ANTHROPIC_AUTH_TOKEN="sk-your-key"
claude

C’est toute l’intégration. Ajoutez les deux lignes à ~/.zshrc ou ~/.bashrc pour rendre la configuration permanente.

Le piège : si ANTHROPIC_API_KEY est définie dans votre shell, Claude Code peut la privilégier et facturer les appels sur cette clé, en ignorant silencieusement votre clé de passerelle et tout abonnement Pro/Max. Exécutez echo $ANTHROPIC_API_KEY — si la commande affiche quoi que ce soit, unset ANTHROPIC_API_KEY avant de démarrer.

Configuration par projet

Pour limiter l’utilisation de la passerelle à un dépôt plutôt qu’à l’ensemble de votre shell, utilisez un fichier de paramètres :

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://aiprimetech.io",
    "ANTHROPIC_AUTH_TOKEN": "sk-your-key"
  }
}

Placez-le à l’emplacement .claude/settings.json dans le projet, ou ~/.claude/settings.json pour une configuration par défaut applicable à l’utilisateur. Ajoutez .claude/settings.json à .gitignore — il contient une clé.

Vérifier que la configuration fonctionne

"c"># 1. the gateway answers and the key is valid
curl -s -o /dev/null -w "%{http_code}\n" https://aiprimetech.io/v1/models \
  -H "Authorization: Bearer $ANTHROPIC_AUTH_TOKEN"

"c"># 2. start Claude Code and confirm usage appears in your dashboard
claude

Si les requêtes n’apparaissent pas dans votre tableau de bord, elles sont envoyées ailleurs — presque toujours à cause du piège lié à ANTHROPIC_API_KEY décrit ci-dessus.

Choisir un modèle

claude --model claude-opus-4-8

Tout identifiant provenant de Modèles fonctionne. Opus pour les refactorisations difficiles, Sonnet pour le travail quotidien — consultez Maîtrise des coûts pour comprendre pourquoi ce choix pèse autant sur votre facture.

Maîtriser les coûts