Как подключить Claude Code к API Anthropic: пошагово
Claude Code работает поверх API Anthropic. Чтобы его подключить, нужен ключ API, одна переменная окружения и тестовый запрос. После этого модель выбирается флагом при запуске или командой внутри сессии. Весь процесс занимает минут десять.
Шаг 1. Получить ключ API
- Зайдите в консоль Anthropic в раздел API Keys.
- Создайте новый ключ и скопируйте значение.
- Положите ключ в переменные окружения, не в код и не в репозиторий.
Шаг 2. Установить Claude Code
npm install -g @anthropic-ai/claude-code claude --version
Шаг 3. Задать ключ
# Linux / macOS / WSL export ANTHROPIC_API_KEY="sk-ant-..." # Windows PowerShell $env:ANTHROPIC_API_KEY="sk-ant-..."
Чтобы ключ не слетал между сессиями, добавьте export в ~/.bashrc или задайте системную переменную в Windows.
Шаг 4. Проверить подключение
claude
> скажи hello
ответ модели пришёл, подключение работает
прямая проверка API без Claude Code:
curl https://api.anthropic.com/v1/messages -H "x-api-key: $ANTHROPIC_API_KEY" -H "anthropic-version: 2023-06-01" -H "content-type: application/json" -d '{"model":"claude-opus-4-8","max_tokens":64,"messages":[{"role":"user","content":"hi"}]}'
Шаг 5. Выбрать модель
claude --model claude-opus-4-8
или внутри сессии:
/model claude-sonnet-4-6
| Задача | Модель |
|---|---|
| Повседневные правки, фичи, рефакторинг | Sonnet 4.6 |
| Сложная архитектура и хитрый дебаг | Opus 4.8 |
Частые ошибки
- 401 Unauthorized: ключ не задан, устарел или скопирован с лишним пробелом.
- 403 или геоблокировка: запрос из региона, куда API не отдаёт напрямую.
- Ошибка оплаты: к ключу не привязана карта или баланс нулевой.
Из России прямой ключ часто упирается в геоблок и зарубежную карту. CLOD даёт Anthropic-совместимый API с рублёвой оплатой: ключ кладёте в ANTHROPIC_API_KEY, Claude Code работает без VPN.
Частые вопросы
Ключ API и подписка Max это одно и то же?
Нет. Ключ API нужен для оплаты по токенам. Подписка Max это отдельный план с фиксированным лимитом, ключ для неё не требуется.
Безопасно ли класть ключ в ~/.bashrc?
Для локальной разработки допустимо, лучше секрет-менеджер или файл с правами 600. Главное не коммитить ключ в репозиторий.
Можно ли использовать ключ CLOD в Claude Code?
Да. CLOD даёт Anthropic-совместимый API, ключ кладётся в ту же переменную ANTHROPIC_API_KEY, Claude Code работает как с прямым доступом.
Что такое заголовок anthropic-version?
Это версия API, которую вы вызываете. Текущая стабильная 2023-06-01. Без заголовка запрос вернёт ошибку.