Используйте Claude API в Roo Code
Claude API работает в Roo Code через нативный провайдер Anthropic самого расширения: отметьте чекбокс кастомного base URL, направьте его на шлюз apiToken.sale и вставьте один предоплаченный ключ. Этот гайд разбирает точные настройки провайдера, закрепление моделей за режимами Code, Architect и Ask и четыре ошибки, с которыми вы реально столкнётесь.
·
Подключите Roo Code к шлюзу одним профилем
В Roo Code есть нативный провайдер Anthropic с опциональным кастомным base URL, поэтому подключение к дисконтному шлюзу — это три поля, а не плагин и не прокси. Выберите провайдера Anthropic, укажите base URL https://router.apitoken.sale, вставьте ключ sk-pool-••• — и каждая задача пойдёт на Claude с единой скидкой 50% от официальных тарифов за токены.
- 01Откройте Roo Code → Settings → Providers и создайте новый профиль конфигурации API; назовите его как-нибудь вроде «apiToken», чтобы потом не путать с профилем напрямую к Anthropic.
- 02В поле API Provider выберите Anthropic, отметьте чекбокс «Use custom base URL» и введите https://router.apitoken.sale — именно так, без пути в конце.
- 03Вставьте ключ apiToken.sale (sk-pool-•••) в поле API Key. Ключ уходит в заголовке x-api-key — стандартном заголовке Anthropic Messages.
- 04Сохраните профиль, выберите модель claude-sonnet-5 и запустите маленькую задачу — попросите Roo объяснить файл, — чтобы проверить прохождение запроса, прежде чем отдавать ему настоящий рефакторинг.
# Roo Code → Settings → Providers (profile "apiToken") API Provider : Anthropic [x] Use custom base URL Base URL : https://router.apitoken.sale API Key : sk-pool-••• Model : claude-sonnet-5
Читайте также: Используйте Claude API в VS Code
Провайдер Anthropic или OpenAI-совместимый — оставайтесь на линии Anthropic
У Roo Code есть и провайдер «OpenAI Compatible», и тот же ключ отвечает на обоих протоколах: Anthropic Messages на https://router.apitoken.sale и OpenAI-совместимая линия на https://router.apitoken.sale/v1 с Authorization: Bearer. Для Claude держите провайдер Anthropic. Специфичные для Claude настройки Roo Code — переключатель промпт-кеширования, опции расширенного мышления и механика tool use, на которой держится его агентный цикл, — построены под форму Messages API, и на универсальной линии вы их теряете.
# Only for tools without an Anthropic option: API Provider : OpenAI Compatible Base URL : https://router.apitoken.sale/v1 API Key : sk-pool-••• Model ID : claude-sonnet-5 # typed by hand, no dropdown
На OpenAI-совместимой линии Roo Code не подтягивает список моделей — ID модели вводится свободным текстом. Опечатка там всплывёт как «model not found», а не как ошибка авторизации, и люди начинают чинить не то.
Закрепите свою модель Claude за каждым режимом Roo
Профили конфигурации API в Roo Code — это не только учётные данные: профиль можно привязать к каждому режиму и переключать модели вместе с режимом. Так выбор модели превращается из глобального компромисса в решение под конкретный режим — именно так агентный цикл остаётся быстрым, не оплачивая каждое чтение файла по ценам Opus.
| Режим Roo Code | Какую модель закрепить | Почему |
|---|---|---|
| Ask | claude-haiku-4-5 | Вопросы и ответы про код — короткая работа только на чтение; самого дешёвого Claude обычно достаточно. |
| Code | claude-sonnet-5 | Повседневная рабочая лошадка для правок, прогонов тестов и циклов с инструментами — качество кодинга почти уровня Opus по средней цене. |
| Architect | claude-opus-4-8 | Ошибка в планировании дороже всего бьёт дальше по цепочке; сильную модель стоит тратить здесь. |
| Debug | claude-sonnet-5 | Делит профиль с Code; упёршийся баг вручную повышайте до claude-opus-4-8, когда цикл встаёт. |
Все поддерживаемые поколения Claude сидят за одним ключом и одним предоплаченным балансом — Opus 4.8 и 4.7, Sonnet 5 и 4.6, Haiku 4.5, — так что профиль на каждую модель ничего не стоит ни в поддержке, ни в пополнении.
Что агентный цикл делает с вашим счётом за токены
Roo Code не болтает — он крутится в цикле. Одна задача читает файлы, строит план, правит, запускает результат и перепроверяет, и каждая итерация — это полный вызов модели с системным промптом, схемами инструментов и всей историей диалога. Это ровно та нагрузка, где потокенная скидка важнее всего: та же сессия на 50% дешевле, с детализацией до токенов в панели apiToken.sale — видно, какой режим тратит.
Включите опцию промпт-кеширования в Roo Code. Roo на каждом вызове в цикле шлёт один и тот же большой префикс — свой системный промпт, ваши файлы правил, контекст репозитория, — а кешированный вход тарифицируется по более дешёвым официальным ставкам кеша минус ваша скидка. На длинных сессиях строка кеша обычно даёт самую большую экономию.
Есть два способа прикинуть расход до большой задачи: оцените токены в калькуляторе стоимости и сверьте точные ставки по моделям на странице каталога.
Оцените сессию Roo Code в калькуляторе стоимости Claude API →
Разбор ошибок, которые Roo Code реально выдаёт
- 401 Unauthorized — неверный ключ или base URL. Вставьте ключ заново и проверьте, что base URL — ровно https://router.apitoken.sale: лишний слэш в конце или суффикс /v1 на линии Anthropic ломают маршрутизацию.
- Model not found — ID модели устарел или набран с опечаткой. Используйте актуальный ID, например claude-sonnet-5, claude-opus-4-8 или claude-haiku-4-5.
- 429 rate limit — Roo стреляет вызовами инструментов пачками. Поднимите настройку «Rate limit» (минимум секунд между запросами) в настройках провайдера вместо того, чтобы долбить retry.
- Context window overflow — длинные сессии накапливают прочитанные файлы быстрее, чем кажется. Заводите новую задачу на каждую единицу работы вместо растягивания одного треда — или позвольте Roo сжать контекст, когда он это предложит.
На агентных правках стоит включить чекпоинты: Roo делает снапшот рабочего дерева перед изменениями, и неудачный цикл откатывается одним кликом вместо археологии в git.
Используйте тот же ключ в Cline, Cursor и SDK
Ключ не привязан к Roo Code. Один ключ покрывает Roo Code, Cline, Cursor и SDK Anthropic и OpenAI одновременно — все тратят один предоплаченный баланс, так что попробовать другого агента можно без второго аккаунта и второго пополнения.
Если вы пришли из Cline, концептуально ничего не меняется: оба — агенты VS Code с провайдером Anthropic, принимающим кастомный base URL, и настройка отличается только расположением настроек. Roo Code добавляет профили по режимам и более тонкие настройки автоодобрения; Cline — более лёгкий однорежимный агент. Выбирайте агента по рабочему процессу, а не по ключу — он работает в обоих.
Частые вопросы
Поддерживает ли Roo Code кастомный base URL для Anthropic?
Да. В настройках провайдера Anthropic в Roo Code есть чекбокс «Use custom base URL»; включите его, задайте URL https://router.apitoken.sale и авторизуйтесь ключом apiToken.sale.
Какие модели Claude доступны в Roo Code на этом ключе?
Все поддерживаемые модели Claude — Opus 4.8 и 4.7, Sonnet 5 и 4.6, Haiku 4.5 — на одном ключе и одном предоплаченном балансе, так что разные модели можно закрепить за разными режимами Roo Code.
Может ли Roo Code использовать разные модели для разных режимов?
Да. Профили конфигурации API можно привязывать к режимам, поэтому Ask может работать на claude-haiku-4-5, Code — на claude-sonnet-5, а Architect — на claude-opus-4-8 без захода в настройки между задачами.
Работает ли промпт-кеширование через шлюз?
Да. Держите опцию промпт-кеширования в Roo Code включённой; кешированный вход тарифицируется по более дешёвым официальным ставкам кеша минус ваша единая скидка 50%, что особенно ощутимо на длинных агентных циклах.
Настройка Roo Code отличается от Cline?
Почти нет. Оба — агенты VS Code, чей провайдер Anthropic принимает кастомный base URL, поэтому тот же ключ и тот же URL работают в обоих; берите того агента, чей рабочий процесс вам ближе.
Создайте аккаунт через Google или GitHub и протестируйте шлюз с бонусом $5 на балансе платформы.