Claude Code a través de Model Gate

Aquesta guia utilitza un permanent settings.json configuració. ANTHROPIC_BASE_URL s'ha d'especificar sense /v1.

Valors requerits

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

ANTHROPIC_AUTH_TOKEN s'envia com a testimoni de portador. Model Gate també accepta x-api-key, però el formulari d'auth-token és adequat per a una passarel·la LLM.

1. Instal·leu el número {0}

Instal·lador natiu de macOS o Linux

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

alternativa npm

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

Windows PowerShell

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

Tanqueu i torneu a obrir el terminal i, a continuació, verifiqueu:

claude --version

Utilitzeu les instruccions oficials d'instal·lació actuals quan canviï l'instal·lador: https://docs.anthropic.com/en/docs/claude-code/getting-started.

2. Creeu el directori de configuració

Linux o 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. Settings.json recomanats

{
  "$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"
}

Substituïu els ID de model per ID activats retornats per:

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

4. Anul·leu les ranures Opus, Sonnet i Haiku

Claude Code exposa tres espais de model estàndard. Podeu assignar-los als ID del model de 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"
  }
}

Aquests valors anul·len les tres ranures estàndard; no creen nous botons GUI il·limitats.

5. Configuració opcional de privadesa i temps d'espera

Afegeix només la configuració que entenguis:

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

No activeu el bypass de permisos globalment tret que entengueu l'impacte de seguretat. Model Gate no requereix bypassPermissions.

6. Inici núm. {0}

claude

Ús /model per inspeccionar o canviar el model seleccionat.

7. Prova única sense settings.json

Linux o 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

Resolució de problemes

Problema	Resolució
claude no es troba	Tanqueu i torneu a obrir el terminal i, a continuació, executeu-lo claude --version. Comproveu where.exe claude a Windows o which claude a Unix.
Es demana autenticació	Verificar ANTHROPIC_AUTH_TOKEN, tanqueu Claude Code i torneu a començar.
No s'ha trobat el model	Utilitzeu un identificador canònic o un àlies habilitat retornat per /v1/models.
Les sol·licituds van directament a Anthropic	Confirmeu que l'URL base és exactament https://api.model-gate.com sense /v1.
401 invalid_api_key	Gireu la clau Model Gate i actualitzeu settings.json.

Referència oficial de la passarel·la: https://docs.anthropic.com/en/docs/claude-code/llm-gateway.