Claude Code с OpenRouter: подключение и проверка

Claude Code можно направить в OpenRouter через совместимый с Anthropic интерфейс, без локального прокси. Для этого нужны установленный Claude Code, ключ OpenRouter и четыре переменные окружения. Такой маршрут имеет смысл ради единого баланса, контроля расходов или выбора провайдера. Если вам нужен обычный Claude Code с подпиской Anthropic, прямой вход проще и надёжнее.

Карта результата перед настройкой

Исходные условия: Claude Code запускается в терминале, у вас есть отдельный ключ OpenRouter и тестовый проект без секретных данных. Ожидаемый результат: команда claude отправляет запросы через адрес OpenRouter, /status показывает новый базовый адрес, а тестовый вызов появляется в журнале активности. Обязательные шаги: сохранить исходную схему входа, очистить конфликтующий сеанс при необходимости, задать переменные, проверить статус, выполнить дешёвую пробу и подготовить откат.

• Используйте терминальную версию Claude Code для этой настройки.
• Не вставляйте настоящий ключ в статью, репозиторий, .env или команду, которая попадёт в общий журнал.
• Начните с модели Anthropic через первого поставщика Anthropic, это наиболее совместимый путь по документации OpenRouter.
• Проверьте маршрут до большой задачи, потому что ошибочная модель или провайдер могут нарушить работу инструментов.
• Сохраните инструкцию отката до изменения постоянных настроек оболочки.

Правило выбора: OpenRouter нужен, когда вы можете назвать пользу шлюза и готовы проверять совместимость. Ради одного обычного сеанса Claude Code дополнительный посредник не обязателен.

Что именно делает OpenRouter

OpenRouter принимает запрос Claude Code на своём Anthropic-совместимом адресе и передаёт его выбранной модели или провайдеру. Официальная инструкция OpenRouter указывает базовый адрес OpenRouter, переменную ANTHROPIC_AUTH_TOKEN для ключа и пустую ANTHROPIC_API_KEY, чтобы избежать конфликта с прямой авторизацией Anthropic.

Шлюз полезен для централизованного баланса, статистики и маршрутизации, но это отдельный участник обработки данных и оплаты. OpenRouter описывает общие правила баланса и тарификации в официальном разделе вопросов. Перед рабочими данными проверьте настройки журналирования, провайдера и требования вашей организации.

По теме: Claude и Claude Code: в чём разница и что выбрать

Когда выбирать прямой доступ, OpenRouter или локальный роутер

Практический элемент 1, матрица выбора. Прямой доступ Anthropic выбирайте для максимальной предсказуемости и поддержки. OpenRouter выбирайте, если нужен один внешний шлюз с общей статистикой и балансом. Локальный Claude Code Router уместен, если вам действительно нужны правила маршрутизации на своей машине и вы готовы обслуживать ещё один процесс. Его устройство отдельно разобрано в инструкции по Claude Code Router.

• Прямой Anthropic: меньше компонентов, проще поддержка, только доступные Anthropic маршруты.
• OpenRouter: единая учётная запись шлюза, внешний маршрут, совместимость зависит от модели и провайдера.
• Локальный роутер: больше контроля над правилами, но появляются порт, конфигурация и отдельная диагностика.
• Смешанная схема: сложнее найти причину ошибки, поэтому не начинайте с неё без конкретного требования.

Подготовьте Claude Code и безопасный тест

Установите Claude Code официальным способом и убедитесь, что обычная команда claude запускается. Актуальные способы установки собраны в документации Anthropic. Если инструмент ещё не знаком, сначала выполните одну локальную задачу по базовому гайду Claude Code, чтобы не спутать ошибку установки с ошибкой шлюза.

1. Создайте пустую папку или копию учебного проекта.
2. Проверьте git status, чтобы видеть будущие изменения.
3. Создайте в OpenRouter отдельный ключ только для Claude Code.
4. Задайте ключу ограничение расходов в интерфейсе сервиса, если такая настройка доступна для вашего аккаунта.
5. Закройте терминалы, в которых уже заданы старые ключи, либо очистите их перед тестом.

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

Сначала используйте временные переменные только в текущем окне терминала. В примере ключ вводится скрыто и не записывается в файл. После закрытия окна значения исчезнут. Команды рассчитаны на Bash или Zsh.

read -s OPENROUTER_API_KEY
export OPENROUTER_API_KEY
export ANTHROPIC_BASE_URL="https://openrouter.ai/api"
export ANTHROPIC_AUTH_TOKEN="$OPENROUTER_API_KEY"
export ANTHROPIC_API_KEY=""
claude

Если Claude Code раньше был подключён к аккаунту Anthropic, официальный гайд OpenRouter советует один раз выполнить /logout, закрыть Claude Code и запустить его снова. Кэшированный вход и ANTHROPIC_AUTH_TOKEN могут конфликтовать. Если прямого входа раньше не было, выход не требуется.

Не начинайте с постоянной записи ключа в ~/.zshrc или ~/.bashrc. Сначала убедитесь, что временная схема работает. Для постоянного хранения лучше использовать менеджер секретов или защищённую пользовательскую настройку, которую не читает репозиторий. Дополнительные переменные и их приоритеты можно сверить в справке по переменным Claude Code.

По теме: Claude Code loop: как настроить безопасный цикл /loop

Как проверить, что маршрут действительно изменился

1. Внутри Claude Code выполните /status.
2. Убедитесь, что источником токена указан ANTHROPIC_AUTH_TOKEN.
3. Проверьте, что базовый адрес равен официальному адресу OpenRouter.
4. Дайте задачу только на чтение, например попросите перечислить файлы тестовой папки.
5. Откройте Activity в OpenRouter и найдите свежий вызов.
6. Только после этого разрешайте изменение одного учебного файла.

Проверка считается успешной, когда совпали три сигнала: правильный адрес в /status, новый вызов в OpenRouter и ожидаемый ответ Claude Code. Одного ответа в терминале мало: при конфликте авторизации запрос мог уйти другим маршрутом.

Как выбрать модель без случайной несовместимости

OpenRouter предупреждает, что Claude Code оптимизирован для моделей Anthropic, а гарантированная работа интеграции относится к первому поставщику Anthropic. Поэтому для первой проверки используйте Anthropic-модель через рекомендованный маршрут. Переход на другую модель делайте отдельным экспериментом, не одновременно с настройкой ключа.

Официальная инструкция допускает переопределение моделей для разных ролей Claude Code через переменные ANTHROPIC_DEFAULT_OPUS_MODEL, ANTHROPIC_DEFAULT_SONNET_MODEL, ANTHROPIC_DEFAULT_HAIKU_MODEL и CLAUDE_CODE_SUBAGENT_MODEL. Не копируйте случайное имя из старой статьи. Выберите актуальный идентификатор в каталоге OpenRouter и после каждой замены повторите /status и маленькую задачу.

По теме: Claude Code Tasks: список задач и команда /tasks в 2026

Диагностика по симптому

Практический элемент 2, последовательность поиска причины. Ошибка входа обычно связана с ключом или конфликтующей сессией. Ошибка «модель не найдена» указывает на идентификатор модели, провайдера или старую авторизацию. Ответ есть, но Activity пустой, значит сначала проверяйте базовый адрес и окружение именно того процесса, который запустил Claude Code. Инструменты работают нестабильно, вернитесь к Anthropic-модели через первого поставщика.

• Авторизация не проходит: проверьте, что ANTHROPIC_API_KEY задан пустой строкой, а не старым ключом.
• После /logout ошибка осталась: полностью перезапустите процесс и проверьте переменные новой оболочки.
• Модель не найдена: уберите переопределения моделей и повторите тест на рекомендуемом маршруте.
• Вызов списывает больше ожидаемого: остановите сеанс, проверьте модель, провайдера и лимит ключа.
• Команды или инструменты ломаются: прекратите эксперимент и вернитесь к прямому Anthropic до выяснения совместимости.
• Ключ попал в лог или репозиторий: отзовите его в OpenRouter и создайте новый, одного удаления строки недостаточно.

Как полностью откатить настройку

Закройте Claude Code и удалите временные переменные из текущей оболочки. Если вы добавляли их в профиль, сначала сделайте резервную копию, удалите только свои строки и откройте новый терминал. Затем запустите Claude Code и выполните обычный вход Anthropic.

unset OPENROUTER_API_KEY
unset ANTHROPIC_BASE_URL
unset ANTHROPIC_AUTH_TOKEN
unset ANTHROPIC_API_KEY
unset ANTHROPIC_DEFAULT_OPUS_MODEL
unset ANTHROPIC_DEFAULT_SONNET_MODEL
unset ANTHROPIC_DEFAULT_HAIKU_MODEL
unset CLAUDE_CODE_SUBAGENT_MODEL

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

Нужен ли Claude Code Router для OpenRouter?

Нет. Официальная интеграция OpenRouter работает через совместимый адрес напрямую, без локального прокси. Роутер нужен только для дополнительных локальных правил.

Можно ли подключить OpenRouter в Claude Desktop?

Эта инструкция относится к терминальной версии Claude Code. Документация Desktop указывает, что сторонние провайдеры там ограничены корпоративной конфигурацией. Для обычного личного подключения используйте CLI.

Можно ли выбрать любую модель OpenRouter?

Технически каталог широк, но Claude Code рассчитан на определённое поведение моделей и инструментов. Начинайте с Anthropic через первого поставщика, а остальные варианты проверяйте отдельно.

Где безопаснее хранить ключ?

В персональном менеджере секретов или защищённой пользовательской настройке вне репозитория. Не публикуйте ключ в .env, примерах, истории команд и снимках экрана.