Claude Code через модельные ворота

В этом руководстве используется постоянный 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. Установите № {0}

Собственный установщик 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. Создайте каталог настроек.

Линукс или МакОС

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

Эти значения переопределяют три стандартных слота; они не создают неограниченное количество новых кнопок графического интерфейса.

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. Старт № {0}

claude

Использовать /model чтобы проверить или изменить выбранную модель.

7. Разовый тест без settings.json

Линукс или МакОС

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 на Юниксе.
Требуется аутентификация	Проверять 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.