Claude Code през Model Gate

Това ръководство използва постоянен settings.json конфигурация. ANTHROPIC_BASE_URL трябва да се посочи без /v1.

Задължителни стойности

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

ANTHROPIC_AUTH_TOKEN се изпраща като токен на носител. Модел Gate също приема x-api-key, но формата за токен за удостоверяване е подходяща за LLM шлюз.

1. Инсталирайте Claude Code

собствен инсталатор за macOS или Linux

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

npm алтернатива

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

Windows PowerShell

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

Затворете и отворете отново терминала, след което проверете:

claude --version

Използвайте текущите официални инструкции за инсталиране, когато инсталаторът се промени: https://docs.anthropic.com/en/docs/claude-code/getting-started.

2. Създайте директория с настройки

Linux или 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. Препоръчителни настройки.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"
}

Заменете идентификаторите на модела с разрешени идентификатори, върнати от:

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

4. Заменете слотовете Opus, Sonnet и Haiku

Claude Code разкрива три стандартни гнезда за модел. Можете да ги съпоставите с идентификатори на модели на 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"
  }
}

Тези стойности имат предимство пред трите стандартни слота; те не създават неограничени нови GUI бутони.

5. Незадължителни настройки за поверителност и изчакване

Добавете само настройки, които разбирате:

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

Не разрешавайте глобално заобикаляне на разрешения, освен ако не разбирате въздействието върху сигурността. Модел Gate не изисква bypassPermissions.

6. Старт Claude Code

claude

Използвайте /model за преглед или смяна на избрания модел.

7. Еднократен тест без settings.json

Linux или 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

Отстраняване на неизправности

проблем	Резолюция
claude не е намерен	Затворете и отворете отново терминала, след което стартирайте claude --version. Проверете where.exe claude на Windows или which claude на Unix.
Изисква се удостоверяване	Проверете ANTHROPIC_AUTH_TOKEN, затворете Claude Code и го стартирайте отново.
Моделът не е намерен	Използвайте каноничен идентификатор или активиран псевдоним, върнат от /v1/models.
Заявките отиват директно към Anthropic	Потвърдете, че основният URL адрес е точен https://api.model-gate.com без /v1.
401 invalid_api_key	Завъртете ключа Model Gate и актуализирайте settings.json.

Официална справка за портала: https://docs.anthropic.com/en/docs/claude-code/llm-gateway.