Почему Claude Code подключается к RouterAI без доработок
Claude Code — консольный ассистент Anthropic: из терминала он читает и правит файлы, запускает команды и работает с git. RouterAI даёт Anthropic-совместимый эндпоинт POST /api/v1/messages, поэтому Claude Code работает без модификаций. Достаточно подменить базовый адрес и указать в ANTHROPIC_AUTH_TOKEN ключ из личного кабинета, оставив ANTHROPIC_API_KEY пустой строкой.
Подойдут macOS, Linux, Windows (WSL) или Windows нативно; установке через npm нужен Node.js 22+. На Windows настройку надёжнее делать через файл %USERPROFILE%\.claude\settings.json в блоке env, а не через системные переменные.
Проще начать с установщика агентов: одна команда ставит Claude Code и подключает его к RouterAI, права администратора не нужны. Вручную настраивайте, если установщик не подошёл; на ARM Linux и ARM Windows он не работает. Через RouterAI подключаются и другие агенты и редакторы.
Что назначить на роли Sonnet, Opus и субагентов
По умолчанию на роли ставятся модели семейства Claude. Для совместимости рекомендуются идентификаторы с префиксом anthropic/: если на роль попадает модель из другого семейства, RouterAI сам переводит запрос в формат Chat Completions и обратно. Так, роль Haiku можно отдать модели deepseek/deepseek-v4-flash.
Переменная ANTHROPIC_DEFAULT_SONNET_MODEL задаёт модель для основных задач, ANTHROPIC_DEFAULT_OPUS_MODEL для сложных, ANTHROPIC_DEFAULT_HAIKU_MODEL для быстрых операций, а CLAUDE_CODE_SUBAGENT_MODEL для субагентов. Чтобы снизить расход, ставьте дорогую модель на Opus и дешёвую на Haiku и субагентов.
Любую роль занимает любая модель из каталога. Оплата идёт за токены с баланса по цене модели; например, Claude Sonnet 5.5 на 02.11.2026 стоит 209,44 ₽ за 1 млн входных токенов и 1047,2 ₽ за выходные.
Функции сессии и контроль трат
В сессии доступны стриминг ответов, tool use, изображения в сообщениях, кэширование промптов через cache_control и расширенное мышление для совместимых моделей. Проверить настройку легко: команда /status выводит адрес и токен, которыми пользуется ассистент.
Статус-бар RouterAI показывает модель, токены, кэш и баланс. Расход за сессию считают как разницу между балансом на старте и текущим; обновляется он не чаще раза в минуту. Включите статус-бар, чтобы видеть стоимость сессии по ходу работы.
Ошибки, которые встречаются при настройке
Если Claude Code уходит на серверы Anthropic напрямую, проверьте, что ANTHROPIC_API_KEY задан пустой строкой: без этого ассистент не станет обращаться к RouterAI. Ошибка 401 означает, что в ANTHROPIC_AUTH_TOKEN не тот ключ. Возьмите правильный из личного кабинета.
Ключ в проектном файле .claude/settings.local.json не должен попадать в git: внесите файл в .gitignore.