Claude Code
Подключение Claude Code к Morphogen через переменные окружения.
Claude Code работает через Anthropic Messages API. Morphogen принимает этот формат для любой текстовой модели, поэтому хватит переменных окружения.
Настройка
Создайте отдельный ключ для Claude Code: тогда его расход будет видно отдельной строкой. Затем задайте переменные:
export ANTHROPIC_BASE_URL=https://api.morphogen.ru
export ANTHROPIC_AUTH_TOKEN=$MORPHOGEN_API_KEY
export ANTHROPIC_MODEL=claude-sonnet-5
export CLAUDE_CODE_MAX_OUTPUT_TOKENS=4000Адрес указывается без /v1: Claude Code сам добавляет путь /v1/messages. В ANTHROPIC_MODEL подойдёт любая текстовая модель из GET /v1/models, не только от Anthropic.
CLAUDE_CODE_MAX_OUTPUT_TOKENS=4000 ограничивает ответ: без неё Claude Code просит большой максимальный ответ, резерв не помещается в лимит ключа и второй запрос получает 402. Резерв считается по меньшему из этого значения и потолка модели, поэтому при большом лимите ключа его можно поднять, если длинные ответы с кодом обрезаются.
Чтобы не вводить переменные в каждой сессии, добавьте их в ~/.zshrc или ~/.bashrc.
Проверка
claude -p "ответь одним словом: работает?"Claude Code выведет ответ модели. Если вместо ответа ошибка, найдите её по статусу и тексту на странице Ошибки.
Morphogen резервирует деньги под максимальный ответ модели. Проверьте, что задана CLAUDE_CODE_MAX_OUTPUT_TOKENS, и пополните баланс. Подробности в разделе «Частые ошибки».
Что работает
Потоковые ответы. Вызов инструментов у моделей с поддержкой tool use. Картинки на входе. Кеширование промпта: полеcache_control проходит как есть, явный кеш Claude учитывается в расходе.
Полная таблица: Совместимость.
Частые ошибки
Claude Code получает ошибки в формате Anthropic, где поля error.code нет: ищите причину по статусу и тексту error.message. Код в таблице нужен для страницы Ошибки.
| Симптом | Причина | Что сделать |
|---|---|---|
| 401 | ключ не передан, отозван или истёк | проверьте ANTHROPIC_AUTH_TOKEN, выпустите новый ключ |
403 model_not_allowed | модели нет в списке ключа | выберите модель из GET /v1/models |
404 model_not_found | такого имени нет в каталоге | сверьте ANTHROPIC_MODEL со списком |
402 key_limit_exceeded | резерв под максимальный ответ не помещается в дневной или месячный лимит ключа | задайте CLAUDE_CODE_MAX_OUTPUT_TOKENS=4000 или поднимите лимит ключа |
402 insufficient_funds | баланс меньше резерва под максимальный ответ | задайте CLAUDE_CODE_MAX_OUTPUT_TOKENS=4000 и пополните баланс |
429 rate_limit_exceeded | больше лимита ключа (по умолчанию 120 запросов или 200 000 токенов в минуту) | подождите время из Retry-After |
Дальше
- Подключите документацию как MCP, чтобы Claude Code искал по ней сам: Документация как MCP.
- Прямые вызовы через SDK: Anthropic SDK.