Integrations/Claude Code

Интеграция с Claude Code

Claude Code — официальный CLI-агент Anthropic для программирования. Sozdai предоставляет совместимый Anthropic Messages API: направьте Claude Code на Sozdai и используйте настоящие модели Claude дешевле — без изменений в коде.

#Как это работает

Claude Code использует Anthropic Messages API. Три переменные окружения (base URL, токен и пустой API-ключ) направляют каждый запрос в Sozdai API, который обрабатывает его и списывает средства с баланса Sozdai.

Почему ANTHROPIC_API_KEY должен быть пустым

Если ANTHROPIC_API_KEY задан, Claude Code отправляет запросы напрямую в Anthropic, игнорируя ваш base URL. Всегда указывайте пустую строку.

#Требования

Установите Node.js 18+

Claude Code требует Node.js 18 или новее.

Установите Claude Code

bash

npm install -g @anthropic-ai/claude-code

Получите API-ключ Sozdai

Создайте ключ на странице API Keys в консоли. Он начинается с sk-corr- и используется ниже как ANTHROPIC_AUTH_TOKEN.

#Настройка по операционной системе

Выберите свою ОС и следуйте шагам. Замените sk-corr-... на ваш реальный ключ.

Откройте профиль оболочки

macOS по умолчанию использует zsh. Откройте ~/.zshrc в редакторе:

bash

nano ~/.zshrc

Вставьте конфигурацию

bash

# ~/.zshrc
export ANTHROPIC_BASE_URL="https://api.sozdai.ai"
export ANTHROPIC_AUTH_TOKEN="sk-corr-..."
export ANTHROPIC_API_KEY=""
export ANTHROPIC_DEFAULT_OPUS_MODEL="claude-opus-4-8"
export ANTHROPIC_DEFAULT_SONNET_MODEL="claude-sonnet-4-6"
export ANTHROPIC_DEFAULT_HAIKU_MODEL="claude-haiku-4-5"

Перезагрузите профиль

Применить без перезапуска терминала:

bash

source ~/.zshrc

#Сопоставление моделей

У Claude Code три роли моделей. Сопоставьте каждую с именем модели Sozdai через эти переменные (уже включены в настройку выше):

Роль	Переменная	Модель Sozdai
Основная (Opus)	`ANTHROPIC_DEFAULT_OPUS_MODEL`	`claude-opus-4-8`
По умолчанию (Sonnet)	`ANTHROPIC_DEFAULT_SONNET_MODEL`	`claude-sonnet-4-6`
Фоновая (Haiku)	`ANTHROPIC_DEFAULT_HAIKU_MODEL`	`claude-haiku-4-5`

Это обязательно

Встроенные ID моделей Claude Code могут отсутствовать в Sozdai. Без этих переменных запросы падают с model_not_found. Полный список имён — на странице моделей.

#Дешёвые модели (DeepSeek / Kimi)

Не обязательно использовать Claude. DeepSeek и Kimi стоят в разы дешевле и полностью работают в Claude Code — включая вызовы инструментов (правка файлов, запуск команд) и расширенное мышление. Просто укажите их в переменных:

Измените эти строки в ~/.zshrc или ~/.bashrc и перезагрузите:

bash

export ANTHROPIC_DEFAULT_OPUS_MODEL="deepseek-v4-pro"
export ANTHROPIC_DEFAULT_SONNET_MODEL="deepseek-v4-flash"
export ANTHROPIC_DEFAULT_HAIKU_MODEL="kimi-k2.6"

Смешивайте

Задайте каждую роль отдельно — например, DeepSeek для основной модели и Kimi для быстрой фоновой; или оставьте Opus на настоящем Claude, а Sonnet/Haiku сделайте дешевле. Цены — на странице моделей.

Какие модели работают с Claude Code

Claude, DeepSeek и Kimi полностью поддерживаются. Gemini пока несовместим с Claude Code — используйте его через обычный эндпоинт /v1/chat/completions.

#Проверка

Запустите Claude Code и выполните /status. Убедитесь, что API Base URL указывает на Sozdai и токен задан. Дальше — работайте как обычно.

bash

claude
# затем, внутри Claude Code:
/status

#Устранение проблем

Симптом	Решение
Запросы всё ещё идут в Anthropic	ANTHROPIC_API_KEY не пустой — задайте "" и перезапустите терминал.
`model_not_found`	Укажите в ANTHROPIC_DEFAULT_*_MODEL имена моделей Sozdai.
401 неверный ключ	ANTHROPIC_AUTH_TOKEN неверный или не является ключом sk-corr-.
402 недостаточно средств	Пополните баланс Sozdai на странице оплаты.