Documentation › Intégrations d'agents › Claude Code

Claude Code

Claude Code parle nativement le format Anthropic : il suffit de le pointer sur https://api.cloudzir.com/anthropic et de déclarer quel modèle Mina répond à quel niveau. Aucun plugin, aucune modification du code de l'agent.

Prérequis#

  • Node.js 18 ou plus récent.
  • Claude Code : npm install -g @anthropic-ai/claude-code
  • Une clé zir_ai_… et un portefeuille crédité.

Configuration#

export ANTHROPIC_BASE_URL="https://api.cloudzir.com/anthropic"
export ANTHROPIC_AUTH_TOKEN="zir_ai_..."
export ANTHROPIC_MODEL="mina-full"
export ANTHROPIC_DEFAULT_OPUS_MODEL="mina-full"
export ANTHROPIC_DEFAULT_SONNET_MODEL="mina-full"
export ANTHROPIC_DEFAULT_HAIKU_MODEL="mina-flash"
export CLAUDE_CODE_SUBAGENT_MODEL="mina-flash"

cd mon-projet
claude

Configuration permanente#

Pour ne pas répéter ces variables à chaque session, placez-les dans le fichier de réglages de Claude Code (~/.claude/settings.json, ou .claude/settings.json pour un seul projet) :

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.cloudzir.com/anthropic",
    "ANTHROPIC_AUTH_TOKEN": "zir_ai_...",
    "ANTHROPIC_MODEL": "mina-full",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "mina-full",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "mina-full",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "mina-flash",
    "CLAUDE_CODE_SUBAGENT_MODEL": "mina-flash"
  }
}
Ne committez pas votre clé

Un settings.json de projet finit souvent dans Git. Préférez les variables d'environnement, ou ajoutez le fichier à .gitignore. Nos clés sont reconnaissables au motif zir_ai_ suivi de 48 caractères hexadécimaux : ajoutez-le à vos règles de détection de secrets.

Choisir les modèles Mina#

Les variables de modèle ci-dessus acceptent les identifiants Mina mina-flash, mina-low et mina-full. La liste des modèles activés pour votre clé est renvoyée par GET /anthropic/v1/models. Les noms des variables appartiennent à la configuration du client.

Vérifier que ça marche#

Dans Claude Code, demandez par exemple « liste les fichiers du projet et résume l'architecture ». Puis contrôlez sur Usage que des requêtes /anthropic/v1/messages apparaissent avec leur coût.

Conseils d'usage et de coût#

  • Sous-agents en mina-flash : les tâches de recherche/lecture représentent le gros du volume, elles n'ont pas besoin du modèle le plus cher.
  • Surveillez le contexte : un agent de code renvoie tout l'historique à chaque tour. Relancez une session propre entre deux tâches sans rapport.
  • Fixez une alerte de solde : une session d'agent longue peut consommer plusieurs centaines de milliers de jetons.

Limites connues#

  • cache_control est accepté et sans effet : la mise en cache est automatique, rien à marquer.
  • Le champ thinking est honoré (Mode de pensée) : couper le raisonnement accélère nettement les tâches simples de l'agent.

Paramètres

Personnalisation

Réponse API