Настройка Claude Code API: ключи, settings.json, модели и шлюзы

Настройка Claude Code API начинается не с вставки ключа, а с выбора активного маршрута. Сначала решите, что должно владеть сеансом: вход по подписке, прямой ANTHROPIC_API_KEY, bearer-шлюз через ANTHROPIC_AUTH_TOKEN и ANTHROPIC_BASE_URL, apiKeyHelper, Bedrock, Vertex или Foundry.

Рабочий порядок простой: маршрут, область настройки, модель, проверка. Пока /status, /config и /model не подтверждают ожидаемое состояние, сеанс нельзя считать настроенным.

Сначала выберите маршрут

Один и тот же Claude Code может работать через разные контракты. Вход по подписке подходит для живой разработки в терминале. API-ключ нужен для CI, SDK, фоновых задач и учета в Console. Шлюз нужен только при понятной совместимости и доверии. Облачный провайдер переносит авторизацию и лимиты на сторону AWS, Google Cloud или Azure.

Если вам нужна базовая установка, откройте инструкцию по установке Claude Code. Если вопрос в том, кто платит за сеанс с API-ключом, используйте разбор API key и подписки.

Приоритет учетных данных

На дату проверки 21 апреля 2026 года порядок такой: учетные данные облачного провайдера, затем ANTHROPIC_AUTH_TOKEN, затем ANTHROPIC_API_KEY, затем apiKeyHelper, OAuth token и только потом данные /login. Поэтому старый env var может сильнее влиять на сеанс, чем новая правка settings.

bash
test -n "$ANTHROPIC_API_KEY" && echo "ANTHROPIC_API_KEY is set"
test -n "$ANTHROPIC_AUTH_TOKEN" && echo "ANTHROPIC_AUTH_TOKEN is set"
printenv ANTHROPIC_BASE_URL

Где менять settings.json

Секреты не должны жить в общих проектных настройках. ~/.claude/settings.json подходит для личных дефолтов, .claude/settings.json для командного поведения без секретов, .claude/settings.local.json для локальных переопределений, shell и CI secrets для ключей.

API-ключ и шлюз

Для прямого Anthropic API используйте ANTHROPIC_API_KEY:

bash
export ANTHROPIC_API_KEY="$YOUR_ANTHROPIC_API_KEY"
claude
/status

Для шлюза задавайте token и base URL вместе:

bash
export ANTHROPIC_AUTH_TOKEN="$YOUR_GATEWAY_TOKEN"
export ANTHROPIC_BASE_URL="https://gateway.example.com"
claude
/status

Шлюз не равен прямому Anthropic API. Проверьте совместимость API, сохранение version/beta headers, имена моделей, логи и границу данных. Для выбора маршрута шлюза используйте отдельный материал.

Модель и провайдеры

Приоритет модели: /model, затем --model, затем ANTHROPIC_MODEL, затем model в settings. Если в settings одно значение, а сеанс использует другое, ищите более высокий слой.

Bedrock обычно требует CLAUDE_CODE_USE_BEDROCK=1 и AWS_REGION. Vertex требует CLAUDE_CODE_USE_VERTEX=1, регион или project ID и действительные Google Cloud credentials. Когда провайдер владеет авторизацией, обычная логика /login не объясняет сеанс.

Проверка перед работой

Внутри Claude Code выполните:

text
/status
/config
/model

В shell проверяйте только наличие переменных, не печатайте секреты. Если маршрут неверный, очистите более приоритетные env vars и запустите новый терминал.

Безопасность и следующие решения

Не коммитьте ключи, bearer tokens, приватные host-адреса и облачные credentials. Перед commit проверьте diff для .claude/settings.json и .claude/settings.local.json.

Смежные вопросы: установка — Claude Code install, биллинг — API key vs subscription, бесплатный ключ — Claude API key free tier, лимиты — usage limits.

Часто задаваемые вопросы

Нужен ли API-ключ для Claude Code?

Не всегда. Для интерактивной работы обычно достаточно входа по подписке. API-ключ нужен для API-маршрута, CI и автоматизации.

Чем отличается ANTHROPIC_AUTH_TOKEN?

Это bearer token, который часто используется со шлюзом и ANTHROPIC_BASE_URL. ANTHROPIC_API_KEY — прямой API-маршрут Anthropic.

Как понять, что настройка сработала?

Запустите /status, /config, /model, затем проверьте env vars без вывода секретов.