Claude Code prin Model Gate

Acest ghid folosește un permanent settings.json configurație. ANTHROPIC_BASE_URL trebuie specificat fără /v1.

Valori obligatorii

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

ANTHROPIC_AUTH_TOKEN este trimis ca un jeton Purtător. Model Gate acceptă și el x-api-key, dar forma simbolului de autentificare este adecvată pentru un gateway LLM.

1. Instalați Claude Code

Instalator nativ macOS sau 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

Închideți și redeschideți terminalul, apoi verificați:

claude --version

Utilizați instrucțiunile oficiale de instalare curente atunci când programul de instalare se schimbă: https://docs.anthropic.com/en/docs/claude-code/getting-started.

2. Creați directorul de setări

Linux sau 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 recomandat

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

Înlocuiți ID-urile modelului cu ID-urile activate returnate de:

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

4. Ignorați sloturile Opus, Sonnet și Haiku

Claude Code expune trei sloturi de model standard. Le puteți mapa la ID-urile modelului 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"
  }
}

Aceste valori depășesc cele trei sloturi standard; nu creează noi butoane GUI nelimitate.

5. Setări opționale de confidențialitate și timeout

Adăugați numai setările pe care le înțelegeți:

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

Nu activați ocolirea permisiunii la nivel global decât dacă înțelegeți impactul securității. Model Gate nu necesită bypassPermissions.

6. Începeți Claude Code

claude

Utilizare /model pentru a inspecta sau a schimba modelul selectat.

7. Test unic fără settings.json

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

Depanare

Problemă	Rezoluţie
claude nu este găsit	Închideți și redeschideți terminalul, apoi rulați claude --version. Verifica where.exe claude pe Windows sau which claude pe Unix.
Se cere autentificare	Verifica ANTHROPIC_AUTH_TOKEN, închideți Claude Code și porniți-l din nou.
Modelul nu este găsit	Utilizați un ID canonic sau un alias activat returnat de /v1/models.
Solicitările ajung direct către Anthropic	Confirmați că adresa URL de bază este exactă https://api.model-gate.com fără /v1.
401 invalid_api_key	Rotiți tasta Model Gate și actualizați settings.json.

Referință oficială a gateway-ului: https://docs.anthropic.com/en/docs/claude-code/llm-gateway.