Практическое подключение

Claude Code через CLODEx API

Подключим Claude Code по настройкам из /docs: базовый домен, ключ CLODEx и точное имя модели. Начнём с временной конфигурации терминала, чтобы не перезаписывать существующие настройки.

Как получить API key для Claude Code

Создайте отдельный ключ CLODEx для агента, задайте тестовую квоту и проверьте /v1/models. Сохраните секрет в CLODEX_API_KEY, а доступный ID с поддержкой Messages — в CLODEX_MODEL. Не используйте основной ключ других приложений для первой проверки.

claude-fable-5 и claude-fable-5.1 — разные маршруты. Выбирайте точный доступный ID; привычный alias CLI может разрешаться в другое имя. Наличие модели в каталоге ещё не подтверждает работу всех инструментов Claude Code: это проверяется отдельной задачей.

Создать и проверить ключ · Проверить Messages отдельно от CLI

Запуск в Bash или zsh

Сначала установите Claude Code по официальной инструкции и проверьте команду claude --version. Затем выполните блок ниже в терминале, где уже заданы CLODEX_API_KEY и CLODEX_MODEL. Скобки создают подоболочку: после выхода из Claude Code настройки основного терминала останутся прежними.

Здесь выбран заголовок x-api-key через ANTHROPIC_API_KEY. ANTHROPIC_AUTH_TOKEN убирается только внутри подоболочки, чтобы не оставлять второй источник учётных данных. Не вставляйте секрет напрямую в команду: он может сохраниться в истории оболочки.

В /docs для подключения с MCP также указаны ENABLE_TOOL_SEARCH=false и MAX_MCP_OUTPUT_TOKENS=50000. Это настройки конкретного сценария с инструментами, а не обязательное условие простого текстового запроса. Не переустанавливайте Figma MCP, если он вам не нужен.

# Bash / zsh: CLODEX_API_KEY and CLODEX_MODEL must already be set.
(
  : "${CLODEX_API_KEY:?Set CLODEX_API_KEY in your protected environment}"
  : "${CLODEX_MODEL:?Choose an exact Messages model ID}"
  unset ANTHROPIC_AUTH_TOKEN
  export ANTHROPIC_BASE_URL="https://clodex.xyz"
  export ANTHROPIC_API_KEY="$CLODEX_API_KEY"
  claude --model "$CLODEX_MODEL"
)

Официальная настройка LLM gateway · Выбор модели в Claude Code

Что проверить до первой рабочей задачи

  • Откройте /status в Claude Code. Проверьте адрес https://clodex.xyz и источник ключа. Если показан другой адрес или вход через подписку, не начинайте задачу.
  • Сверьте выбранную модель. Аргумент --model передаёт ID, но не добавляет модели поддержку протокола или инструментов.
  • Учтите настройки проекта, managed settings и apiKeyHelper: они могут менять конфигурацию. Если /status не совпадает с ожидаемым, найдите конфликт, а не отключайте организационные политики.
  • Начните в пустом тестовом каталоге с одним коротким текстовым вопросом. Это платный запрос; после него проверьте расход и только затем переходите к файлам.

Безопасная проверка работы с файлами

Создайте в тестовом каталоге README.md с одной строкой «demo». Попросите: «Прочитай только README.md и скажи, сколько в нём строк. Не меняй файлы и не запускай команды». Проверьте запрошенные разрешения и фактический результат, а не только заявление агента о выполнении.

После чтения можно отдельно проверить правку тестового файла и посмотреть diff. Не отключайте подтверждения инструментов ради прохождения теста. Ключ доступа не даёт модели право читать секреты, удалять данные или менять production.

Для реального проекта сначала задайте границы: какие файлы читать, что менять нельзя и какие тесты запускать. Расход длинной агентской сессии состоит из нескольких запросов и повторной передачи контекста, а не только из последнего ответа.

Тарифы моделей · Проверка расхода сессии

Как отличить ошибку шлюза от ошибки клиента

СимптомСледующий шаг
401 / 403Проверьте /status, срок действия ключа и доступ к модели. Не печатайте переменные с секретами.
Model not foundСравните --model с точным ID своего каталога; не подставляйте другой ID молча.
Текст работает, tools не работаютПроверьте поддержку tools, версию CLI и безопасный текст ошибки; текстовая проба не проверяла этот режим.
404 или HTML-страницаПроверьте base URL без дополнительного /v1 и локальные прокси.
Обрыв потока / таймаутПроверьте завершение запроса и расход до повтора. Не запускайте несколько одинаковых сессий одновременно.

Передать диагностические данные без ключа

Документация и проверка примера

Адреса и настройки подключения сверены с документацией CLODEx. Примеры предназначены для указанного протокола; они не являются журналом выполненных запросов и не обещают одинаковые функции у всех моделей. Рабочий запрос на генерацию может списать средства.

Подключение клиентов · Протоколы API

Частые вопросы

Эта настройка меняет глобальный профиль терминала?

Нет, показанный блок ограничивает изменения подоболочкой. Файлы конфигурации Claude Code могут иметь собственные настройки; проверяйте фактическую конфигурацию через /status.

Подписка Claude и баланс CLODEx взаимозаменяемы?

Нет. Здесь запросы направляются в CLODEx с ключом CLODEx. Это не подключение оплаченной подписки на сайте владельца модели.

Почему один тестовый ответ не гарантирует работу агента?

Агенту могут потребоваться streaming, tools и дополнительные запросы. Проверяйте каждую нужную функцию на безопасном задании перед работой с репозиторием.

Подключите CLODEX API к своему проекту

Один ключ, единый endpoint и несколько семейств LLM для разработки, приложений и ботов.