Как получить 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. Примеры предназначены для указанного протокола; они не являются журналом выполненных запросов и не обещают одинаковые функции у всех моделей. Рабочий запрос на генерацию может списать средства.
Частые вопросы
Эта настройка меняет глобальный профиль терминала?
Нет, показанный блок ограничивает изменения подоболочкой. Файлы конфигурации Claude Code могут иметь собственные настройки; проверяйте фактическую конфигурацию через /status.
Подписка Claude и баланс CLODEx взаимозаменяемы?
Нет. Здесь запросы направляются в CLODEx с ключом CLODEx. Это не подключение оплаченной подписки на сайте владельца модели.
Почему один тестовый ответ не гарантирует работу агента?
Агенту могут потребоваться streaming, tools и дополнительные запросы. Проверяйте каждую нужную функцию на безопасном задании перед работой с репозиторием.