Перейти к содержимому

Claude Code

Установка и постоянная настройка Claude Code для Anthropic-совместимого эндпоинта Model Gate.

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 передаётся как токен Bearer. Model Gate также принимает x-api-key, но вариант auth-token подходит для шлюза языковых моделей.

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. Рекомендуемый settings.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"
}

Замените идентификаторы моделей на активные ID из ответа:

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

Не включайте глобальный обход разрешений, если не понимаете последствий для безопасности. Model 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 и запустите его снова.
Модель не найденаИспользуйте канонический ID из /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.

Для настольного приложения используйте отдельную инструкцию Claude Desktop.