Вайб-кодинг в VS Code: Настройка CodeGPT + RouterAI (Claude, GPT-6)

CodeGPT — AI-агент для редактора: расширение для VS Code и Visual Studio и плагин для JetBrains. Внутри чат с контекстом проекта, режим Agent, который правит файлы и запускает команды в терминале, и набор команд для типовых задач: объяснить код, отрефакторить, написать комментарии, документацию и юнит-тесты. Модель можно выбирать самому: Claude, GPT, Gemini, Grok, локальные Ollama и LM Studio или любой OpenAI-совместимый провайдер.

Через RouterAI это даёт один ключ ко всем моделям из каталога, работу из России без VPN и оплату в рублях. Ниже — установка, подключение провайдера Custom, выбор моделей и разбор типичных ошибок. Что в интерфейсе подтверждено документацией CodeGPT, а что стоит проверить у себя, отмечено в тексте прямо.

Чем CodeGPT отличается от Cline, Roo Code и Kilo Code

С агентами вроде Roo Code, Kilo Code и Cline CodeGPT сближает режим Agent и выбор любой модели. Отличия, которые видны из документации:

• Несколько редакторов. Один продукт для VS Code, JetBrains и Visual Studio, а не только расширение для VS Code.
• Готовые команды. Пункты Explain, Refactor, Comment, Document, Fix this и Unit Test работают на выделенном коде без написания промпта.
• Три режима. Chat (вопросы без контекста проекта), Search (читает проект, ничего не меняет) и Agent (создаёт и правит файлы, запускает команды).
• Свой аккаунт. Часть возможностей привязана к аккаунту CodeGPT и его тарифам, об этом отдельный раздел ниже.

Требования

По странице System Requirements в документации CodeGPT:

Кроме этого понадобится аккаунт RouterAI с пополненным балансом и API-ключ из раздела «Ключи API».

Установка

VS Code

1. Откройте панель Extensions (Ctrl+Shift+X, на macOS — Cmd+Shift+X) и найдите CodeGPT: AI Coding Agents & Chat (издатель DanielSanMedium, идентификатор DanielSanMedium.dscodegpt).
2. Нажмите Install. Документация предлагает и другие пути: страница в Visual Studio Marketplace и Open VSX — для VSCodium и сборок без Microsoft Marketplace.
3. После установки в Activity Bar появится значок CodeGPT.

В проверке для этой статьи установлена версия 3.24.81. При первом открытии панель CodeGPT показывает «Loading», пока поднимается локальный сервис на порту 54112.

JetBrains и Visual Studio

В JetBrains установите плагин CodeGPT (ссылка на него есть в разделе Installation документации CodeGPT) и перезапустите IDE. В Visual Studio откройте Extensions → Manage Extensions, в левой панели выберите Online, найдите CodeGPT, нажмите Download и закройте Visual Studio, чтобы запустился VSIX Installer.

Подключение к RouterAI

CodeGPT подключается к RouterAI через провайдера Custom: ему нужны название модели, API-ключ и адрес эндпоинта. Для Claude отдельный Anthropic-эндпоинт https://routerai.ru/api здесь не нужен: провайдер Anthropic в документации CodeGPT принимает только ключ, поля для своего адреса у него нет, поэтому Claude подключается тем же OpenAI-совместимым адресом.

Порядок по документации CodeGPT (раздел AI Providers → Custom):

1. В чате CodeGPT откройте выбор модели (кнопка Manage Models).
2. В списке провайдеров выберите LLMs Cloud model, затем Custom в поле Provider.
3. В поле с названием модели вставьте идентификатор из каталога RouterAI, например anthropic/claude-sonnet-5.5.
4. В поле API Key вставьте ключ: sk-xxxxxxxxxxxxxxxx (подставьте свой).
5. В поле endpoint для completion укажите адрес RouterAI (см. ниже) и нажмите Connect.
6. Закройте окно настроек и напишите сообщение в чат.

В документации CodeGPT это поле названо «endpoint link for completion», то есть ожидается адрес самого метода, а не базовый. Мы проверили запросом: POST на https://routerai.ru/api/v1 возвращает 404, а на путь с /chat/completions — 200. Поэтому вписывайте полный адрес:

https://routerai.ru/api/v1/chat/completions

Если вы настраиваете другие инструменты, где поле называется Base URL, там нужен базовый адрес https://routerai.ru/api/v1. Как именно CodeGPT обрабатывает адрес с суффиксом и без него, документация не описывает, поэтому при ошибке 404 проверьте оба варианта.

Чтобы поменять ключ или адрес позже, нажмите Change connection settings в том же окне.

Что работает бесплатно, а что требует тарифа

Документация и сайт CodeGPT описывают это неоднозначно, поэтому проверьте условия перед настройкой:

• Страница Custom в документации указывает, что провайдер Custom доступен только на тарифах Professional и Teams.
• Страница тарифов на сайте включает в бесплатный план «Bring your own API keys — unlimited, 15+ providers».
• Страница Configuration в документации описывает отдельный план BYOK и требует авторизации через аккаунт CodeGPT для синхронизации.

Практический вывод: свой ключ RouterAI подключается через провайдера Custom, но пускает ли в него бесплатный тариф, нужно проверить в своём аккаунте. Платить за Professional ради RouterAI стоит только после такой проверки. Токены при этом оплачиваются отдельно, в RouterAI.

Выбор модели

Идентификаторы и контекст проверены по каталогу RouterAI. Все модели из таблицы поддерживают вызов инструментов (tools), который нужен режиму Agent.

Подробнее о линейке OpenAI — в статье GPT-6 Luna, Sol и Astra, о быстрой модели Anthropic — в обзоре Claude Haiku 5.5.

Две модели под разные задачи

«Профили» в CodeGPT — это режимы Chat, Search и Agent, а не наборы настроек модели. Поэтому схема из двух моделей строится так: подключите через Custom две модели (повторите шаги подключения с разными идентификаторами) и переключайте их в селекторе модели.

• Быстрая (z-ai/glm-5.3-flash или deepseek/deepseek-v4.1-flash) — для режимов Chat и Search и команд Explain, Comment, Document.
• Сильная (anthropic/claude-sonnet-5.5 или openai/gpt-6-astra) — для режима Agent.

Автодополнение (Autocomplete) в документации CodeGPT описано отдельно: на выбор Mistral Codestral, Ollama и встроенная модель CodeGPT, подключение произвольного OpenAI-совместимого провайдера там не упомянуто. Поэтому рекомендацию «дешёвая модель под автодополнение через RouterAI» мы не подтверждаем. Если нужен Tab-автокомплит именно через RouterAI, посмотрите Continue, где автодополнение настраивается в config.yaml.

Проверка подключения

1. Выберите в селекторе подключённую модель (в режиме BYOK без выбранной модели CodeGPT ответит «You must select a model first»).
2. Напишите в чат короткий запрос, например «Ответь одним словом: работает?». Ответ должен прийти за несколько секунд.
3. Переключите режим на Agent и поставьте небольшую задачу в открытом проекте: «Найди в проекте функцию расчёта суммы счёта и добавь для неё юнит-тест». Агент прочитает файлы, предложит правки и покажет их до применения.

Расход по каждому запросу виден в статистике RouterAI.

Решение проблем

«Unable to connect to the extension services», «Server is not running on localhost:54112». Панель CodeGPT обращается к локальному сервису на порту 54112. Убедитесь, что порт свободен и его не занимает другой процесс. В devcontainer порт нужно пробросить (54112:54112). В документации CodeGPT отдельно указано, что расширение несовместимо с VS Code Tunnel. Мы столкнулись с тем же в веб-версии VS Code в контейнере, где панель постоянно показывала эту ошибку: нужен локальный редактор.

404 при отправке сообщения. Скорее всего, в поле эндпоинта указан неверный путь. RouterAI отвечает на https://routerai.ru/api/v1/chat/completions; запрос на https://routerai.ru/api/v1 или https://routerai.ru/api/chat/completions возвращает 404. Если в поле стоит базовый адрес, допишите /chat/completions.

401 Unauthorized. Ключ скопирован с пробелом или удалён. Создайте новый в разделе «Ключи API» и вставьте заново через Change connection settings.

Модель не отвечает или выбирается «не та». Идентификатор нужно вводить вручную в точности как в каталоге, с префиксом провайдера: anthropic/claude-sonnet-5.5, а не claude-sonnet-5.5. Проверьте, что модель выбрана в селекторе: при BYOK без выбранной модели сообщение не отправится.

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

Чёрный экран после обновления расширения. Документация CodeGPT советует выполнить в палитре команд Clear Editor History, закрыть VS Code и установить расширение заново.

Что дальше

• Каталог моделей RouterAI — идентификаторы и контекст для настройки.
• Continue + RouterAI — расширение с автодополнением и настройкой через config.yaml.
• Kilo Code и Roo Code — агенты для VS Code с прямой настройкой OpenAI-совместимого провайдера.
• Claude Haiku 5.5 и GPT-6 Astra — как выбрать модель под задачу.