Claude Code может отправлять свои нативные запросы, совместимые с Anthropic, в OdiRouter, если задать переменные Base URL и токена OdiRouter. Практическая проверка проста: после запуска Claude Code /status должен отображать OdiRouter в качестве Base URL и ANTHROPIC_AUTH_TOKEN в качестве источника авторизации.
Приведённые ниже команды соответствуют текущей версии OdiRouter Claude Code integration documentation. Проверяйте эту страницу снова при обновлении Claude Code или выборе новой модели, поскольку настройки и идентификаторы моделей могут измениться.
Подготовьте учётную запись и локальную среду
Вам потребуются Claude Code, учётная запись OdiRouter и API-ключ OdiRouter. Начните с OdiRouter’s getting-started documentation или страницы регистрации учётной записи, если вы ещё не создали ключ.
Храните ключ вне вашего репозитория. Для этой нативной конфигурации в руководстве OdiRouter указано, что Claude Code не считывает стандартный файл проекта .env. Вместо этого задайте значения в оболочке, файле настроек уровня пользователя или защищённом процессе управления секретами.
Установите или обновите Claude Code
Если Claude Code не установлен, используйте способ установки из его официальной документации. Руководство по интеграции OdiRouter включает следующий вариант с npm:
npm install -g @anthropic-ai/claude-code
claude --versionПеред устранением неполадок конфигурации выполните команду проверки версии. Она подтверждает, что локальная команда claude доступна оболочке, которую вы планируете использовать.
Настройте соединение OdiRouter
OdiRouter указывает https://api.odirouter.ai в качестве базового URL-адреса Anthropic. Сохраните ключ в переменной оболочки, передайте его через ANTHROPIC_AUTH_TOKEN и установите ANTHROPIC_API_KEY в пустую строку. Сброс последнего значения предотвращает конкуренцию более старой конфигурации с токеном OdiRouter.
export ODIROUTER_API_KEY="YOUR_API_KEY"
export ANTHROPIC_BASE_URL="https://api.odirouter.ai"
export ANTHROPIC_AUTH_TOKEN="$ODIROUTER_API_KEY"
export ANTHROPIC_API_KEY=""Используйте корень API в качестве базового URL-адреса. Не вставляйте полный конечный URL-адрес запроса в ANTHROPIC_BASE_URL. OdiRouter указывает https://api.odirouter.ai/v1/messages как совместимый конечный адрес Messages, тогда как Claude Code формирует совместимые запросы на основе базового URL-адреса.
Официальное руководство по интеграции также описывает вариант постоянных настроек на уровне пользователя. Если вы выберете этот путь, храните ANTHROPIC_AUTH_TOKEN в защищенном механизме пользовательского уровня, а не в общем файле проекта.
Удалите старый вход в систему, если он мешает
Если ранее вход в Claude Code выполнялся через другую учётную запись, откройте его и выполните:
/logoutЗатем перезапустите терминал или Claude Code. Это обеспечит новым переменным OdiRouter новый процесс для загрузки. Этот шаг можно пропустить, если сохранённого входа в систему нет.
Запустите Claude Code и проверьте активную конфигурацию
Откройте проект и запустите Claude Code:
cd /path/to/your/project
claudeЗатем выполните эту команду в сеансе Claude Code:
/statusВ ожидаемом представлении статуса ANTHROPIC_AUTH_TOKEN указан как источник авторизации, а https://api.odirouter.ai — как базовый URL-адрес Anthropic. Если одно из этих значений отличается, исправьте окружение, прежде чем использовать сеанс для работы в производственной среде.
Выбирайте идентификаторы моделей из текущего списка OdiRouter
Claude Code поддерживает отдельные значения по умолчанию для ролей Opus, Sonnet, Haiku и подагентов. Считайте названия моделей в старых публикациях примерами, а не данными конфигурации. Руководство OdiRouter предписывает получить точные актуальные идентификаторы из GET https://api.odirouter.ai/v1/models перед настройкой любых переменных значений моделей по умолчанию.
Выберите модель после проверки текущего списка и нужных вам возможностей. Если рабочий процесс зависит от использования инструментов или логических блоков, убедитесь, что выбранная модель их поддерживает. В документации OdiRouter сказано, что он передаёт эти возможности, когда выбранная модель их поддерживает.
Устранение распространенных проблем с конфигурацией
Ответ с недействительным ключом API
Убедитесь, что ANTHROPIC_AUTH_TOKEN содержит действительный ключ API OdiRouter. Во время расследования не храните ключ в заявках, расшифровках чатов и репозиториях.
Claude Code по-прежнему использует предыдущую учётную запись
Установите для ANTHROPIC_API_KEY пустую строку, выполните /logout, затем перезапустите терминал и Claude Code. Это устраняет обычный конфликт между сохранённым входом в систему и предполагаемой конфигурацией OdiRouter.
Модель не найдена
Запросите текущий список у https://api.odirouter.ai/v1/models и скопируйте идентификатор модели в точности. Не выводите его из маркетингового названия или старого файла настроек.
Ошибка протокола или потоковой передачи
Установите ANTHROPIC_BASE_URL в значение https://api.odirouter.ai, а не в полный путь /v1/messages. Это различие является частью рекомендаций по настройке OdiRouter для Claude Code.
Изменённые настройки не применяются
Проверьте синтаксис JSON, если вы использовали файл настроек. Затем перезапустите терминал или Claude Code, чтобы они запустились с изменённым окружением.
Держите официальное руководство под рукой
Как только /status покажет базовый URL-адрес OdiRouter и источник токена, подключение будет готово к следующей задаче. В OdiRouter Claude Code guide приведены актуальный формат настроек, примеры значений моделей по умолчанию, пример GitHub Action и примечания по устранению неполадок. Если вы ещё этого не сделали, создайте учётную запись и ключ API через OdiRouter перед выполнением команд настройки.