Claude Code via Model Gate

Ce guide utilise un permanent settings.json configuration. ANTHROPIC_BASE_URL il faut préciser sans /v1.

Valeurs requises

ANTHROPIC_BASE_URL=https://api.model-gate.com
ANTHROPIC_AUTH_TOKEN=mg_live_...

ANTHROPIC_AUTH_TOKEN est envoyé sous forme de jeton de porteur. Model Gate accepte également x-api-key, mais le formulaire de jeton d'authentification est approprié pour une passerelle LLM.

1. Installez Claude Code

Installateur natif macOS ou Linux

curl -fsSL https://claude.ai/install.sh | bash

alternative npm

npm install -g @anthropic-ai/claude-code

Windows PowerShell

irm https://claude.ai/install.ps1 | iex

Fermez et rouvrez le terminal, puis vérifiez :

claude --version

Utilisez les instructions d'installation officielles actuelles lorsque le programme d'installation change : https://docs.anthropic.com/en/docs/claude-code/getting-started.

2. Créez le répertoire des paramètres

Linux ou macOS

mkdir -p ~/.claude
nano ~/.claude/settings.json

Windows PowerShell

New-Item -ItemType Directory -Force "$HOME\.claude" | Out-Null
notepad "$HOME\.claude\settings.json"

3. Paramètres.json recommandés

{
  "$schema": "https://json.schemastore.org/claude-code-settings.json",
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.model-gate.com",
    "ANTHROPIC_AUTH_TOKEN": "mg_live_...",
    "ANTHROPIC_MODEL": "claude-sonnet-4.6",
    "ANTHROPIC_SMALL_FAST_MODEL": "claude-haiku-4.5"
  },
  "model": "claude-sonnet-4.6"
}

Remplacez les ID de modèle par les ID activés renvoyés par :

curl https://api.model-gate.com/v1/models \
  -H "Authorization: Bearer mg_live_..."

4. Remplacez les emplacements Opus, Sonnet et Haiku

Claude Code expose trois emplacements de modèle standard. Vous pouvez les mapper aux ID de modèle Model Gate :

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.model-gate.com",
    "ANTHROPIC_AUTH_TOKEN": "mg_live_...",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-4.7",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-4.6",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-haiku-4.5"
  }
}

Ces valeurs remplacent les trois emplacements standard ; ils ne créent pas de nouveaux boutons GUI illimités.

5. Paramètres facultatifs de confidentialité et de délai d'attente

Ajoutez uniquement les paramètres que vous comprenez :

{
  "env": {
    "DISABLE_TELEMETRY": "1",
    "DISABLE_ERROR_REPORTING": "1",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1",
    "BASH_DEFAULT_TIMEOUT_MS": "120000",
    "BASH_MAX_TIMEOUT_MS": "600000"
  }
}

N'activez pas le contournement des autorisations de manière globale, sauf si vous comprenez l'impact sur la sécurité. Model Gate ne nécessite pas bypassPermissions.

6. Commencez Claude Code

claude

Utiliser /model pour inspecter ou modifier le modèle sélectionné.

7. Test unique sans settings.json

Linux ou macOS

export ANTHROPIC_BASE_URL="https://api.model-gate.com"
export ANTHROPIC_AUTH_TOKEN="mg_live_..."
claude

Windows PowerShell

$env:ANTHROPIC_BASE_URL = "https://api.model-gate.com"
$env:ANTHROPIC_AUTH_TOKEN = "mg_live_..."
claude

Dépannage

Problème	Résolution
claude n'est pas trouvé	Fermez et rouvrez le terminal, puis exécutez claude --version. Vérifier where.exe claude sous Windows ou which claude sous Unix.
Une authentification est demandée	Vérifier ANTHROPIC_AUTH_TOKEN, fermez Claude Code et redémarrez-le.
Le modèle n'est pas trouvé	Utilisez un identifiant canonique ou un alias activé renvoyé par /v1/models.
Les demandes sont adressées directement à Anthropic	Confirmez que l'URL de base est exactement https://api.model-gate.com sans /v1.
401 invalid_api_key	Faites pivoter la clé Model Gate et mettez à jour settings.json.

Référence officielle de la passerelle : https://docs.anthropic.com/en/docs/claude-code/llm-gateway.