Claude Code przez Bramę Modelu

W tym przewodniku zastosowano stałą settings.json konfiguracja. ANTHROPIC_BASE_URL należy określić bez /v1.

Wymagane wartości

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

ANTHROPIC_AUTH_TOKEN jest wysyłany jako token okaziciela. Model Gate również akceptuje x-api-key, ale formularz tokenu uwierzytelniania jest odpowiedni dla bramy LLM.

1. Zainstaluj Claude Code

Natywny instalator systemu macOS lub Linux

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

alternatywa npm

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

Windows PowerShell

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

Zamknij i otwórz ponownie terminal, a następnie sprawdź:

claude --version

W przypadku zmiany instalatora należy skorzystać z aktualnych oficjalnych instrukcji instalacji: https://docs.anthropic.com/en/docs/claude-code/getting-started.

2. Utwórz katalog ustawień

Linux lub 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. Zalecane ustawienia.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"
}

Zastąp identyfikatory modeli włączonymi identyfikatorami zwróconymi przez:

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

4. Zastąp miejsca Opus, Sonnet i Haiku

Claude Code udostępnia trzy miejsca na modele standardowe. Możesz przypisać je do identyfikatorów modeli 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"
  }
}

Te wartości zastępują trzy standardowe miejsca; nie tworzą nieograniczonej liczby nowych przycisków GUI.

5. Opcjonalne ustawienia prywatności i limitu czasu

Dodaj tylko ustawienia, które rozumiesz:

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

Nie włączaj globalnego pomijania uprawnień, chyba że rozumiesz wpływ na bezpieczeństwo. Model Gate nie wymaga bypassPermissions.

6. Zacznij Claude Code

claude

Używać /model aby sprawdzić lub zmienić wybrany model.

7. Jednorazowy test bez pliku settings.json

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

Rozwiązywanie problemów

Problem	Rezolucja
claude nie został znaleziony	Zamknij i otwórz ponownie terminal, a następnie uruchom claude --version. Sprawdzać where.exe claude w systemie Windows lub which claude na Unixie.
Wymagane jest uwierzytelnienie	Zweryfikować ANTHROPIC_AUTH_TOKEN, zamknij Claude Code i uruchom ponownie.
Nie znaleziono modelu	Użyj kanonicznego identyfikatora lub włączonego aliasu zwróconego przez /v1/models.
Zgłoszenia trafiają bezpośrednio do Anthropic	Upewnij się, że podstawowy adres URL jest prawidłowy https://api.model-gate.com bez /v1.
401 invalid_api_key	Obróć klucz Model Gate i zaktualizuj settings.json.

Oficjalne odniesienie do bramy: https://docs.anthropic.com/en/docs/claude-code/llm-gateway.