Claude Code přes modelovou bránu

Tato příručka používá trvalé settings.json konfigurace. ANTHROPIC_BASE_URL musí být specifikováno bez /v1.

Požadované hodnoty

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

ANTHROPIC_AUTH_TOKEN je odeslána jako žeton nositele. Model Gate také přijímá x-api-key, ale forma auth-tokenu je vhodná pro bránu LLM.

1. Nainstalujte Claude Code

nativní instalační program pro macOS nebo 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

Zavřete a znovu otevřete terminál a poté ověřte:

claude --version

Při změně instalačního programu použijte aktuální oficiální instalační pokyny: https://docs.anthropic.com/en/docs/claude-code/getting-started.

2. Vytvořte adresář nastavení

Linux nebo 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. Doporučená nastavení.json

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

Nahraďte ID modelů povolenými ID vrácenými:

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

4. Přepište sloty Opus, Sonnet a Haiku

Claude Code odhaluje tři standardní sloty modelu. Můžete je namapovat na ID modelu brány modelu:

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

Tyto hodnoty mají přednost před třemi standardními sloty; nevytvářejí neomezená nová tlačítka GUI.

5. Volitelné nastavení soukromí a časového limitu

Přidejte pouze nastavení, kterým rozumíte:

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

Nepovolujte obcházení oprávnění globálně, pokud nerozumíte dopadu na zabezpečení. Model Gate nevyžaduje bypassPermissions.

6. Start Claude Code

claude

Použití /model pro kontrolu nebo změnu vybraného modelu.

7. Jednorázový test bez settings.json

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

Odstraňování problémů

Problém	Rezoluce
claude není nalezen	Zavřete a znovu otevřete terminál a poté spusťte claude --version. Kontrola where.exe claude na Windows nebo which claude na Unixu.
Je požadováno ověření	Ověřte ANTHROPIC_AUTH_TOKEN, zavřete Claude Code a spusťte jej znovu.
Model nebyl nalezen	Použijte kanonické ID nebo povolený alias vrácený uživatelem /v1/models.
Žádosti jdou přímo do Antropic	Potvrďte, že základní adresa URL je správná https://api.model-gate.com bez /v1.
401 invalid_api_key	Otočte klíčem Model Gate a aktualizujte settings.json.

Oficiální reference brány: https://docs.anthropic.com/en/docs/claude-code/llm-gateway.