Как подключить Claude Code к API CLODEX

Быстрая настройка Claude Code

Базовый URL указывается без /v1: Claude Code самостоятельно вызывает /v1/messages. Не публикуйте переменные окружения в репозитории и не вставляйте ключ в скриншоты или логи CI.

export ANTHROPIC_BASE_URL="https://clodex.xyz"
export ANTHROPIC_API_KEY="clodex_YOUR_KEY"

claude

Как выбрать модель

Выберите модель в настройках клиента или конфигурации, используя точное имя из каталога CLODEX. Opus подходит для сложных изменений и архитектуры, Sonnet — для ежедневной разработки. Доступность версии определяется активными каналами и группой ключа.

Можно ли переключать модель во время работы

Уже запущенный запрос должен завершаться на той модели, с которой был отправлен. Изменение селектора применяется к следующему запросу. Если открыть несколько проектов или вкладок, запросы могут выполняться параллельно и завершаться не в порядке запуска — это не означает автоматическую подмену модели.

Диагностика streaming-ошибок

• EOF без message_stop — незавершённый поток, его следует повторить после проверки состояния.
• 429 означает ограничение канала или параллельности; уменьшите concurrency и повторите позже.
• 401/403 — проверьте ключ, группу, статус пользователя и разрешённые модели.
• HTML вместо SSE указывает на ошибку proxy/CDN до API-приложения.

Безопасное хранение переменных окружения

ANTHROPIC_API_KEY хранится в локальном secret store, CI secret или защищённом environment-файле, который исключён из Git. Не вставляйте ключ в shell history, скриншоты, issue и общий dotfiles-репозиторий. Для разных машин и проектов лучше использовать отдельные ключи с минимальными правами.

После утечки секрет нужно отозвать, а не только удалить из последнего commit: старое значение остаётся в истории и копиях. Новый ключ проверяется коротким запросом до запуска долгой agent-сессии.

Модель фиксируется на момент отправки запроса

Смена модели в интерфейсе не должна менять уже открытый stream. Новый выбор применяется к следующему запросу. При нескольких окнах ответы могут завершаться не в порядке запуска; диагностировать это следует по request ID и model slug, а не по визуальному порядку сообщений.

Если нужной модели нет в /v1/models для текущего ключа, остановите запуск и покажите понятную ошибку. Скрытая подмена на другую Claude-модель делает стоимость и качество непредсказуемыми.

Что проверять при reconnect и медленном ответе

Retry выполняется только после классификации ошибки. Немедленное повторение нескольких длинных запросов часто ухудшает ситуацию и расходует лимит быстрее, чем один контролируемый backoff.

• Есть ли обязательный message_stop, а не только закрытие TCP-соединения.
• Не получил ли клиент 429 из-за concurrency или ограничений канала.
• Возвращает ли proxy JSON/SSE, а не HTML-страницу ошибки.
• Совпадают ли выбранная и фактическая модель в usage log.
• Не запускает ли расширение несколько одинаковых запросов параллельно.