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.