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

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

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

## Чем CodeGPT отличается от Cline, Roo Code и Kilo Code {#vs-others}

С агентами вроде [Roo Code](/pages/vibe-coding-vscode-roo-code), [Kilo Code](/pages/vibe-coding-vscode-kilo-code) и Cline CodeGPT сближает режим Agent и выбор любой модели. Отличия, которые видны из документации:

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

## Требования {#requirements}

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

| Компонент | Требование |
|---|---|
| VS Code | версия 1.96.0 или выше |
| Node.js | 20.0.0 или выше |
| Порт | свободный `54112` или `54113` на localhost: на нём работает локальный сервис расширения |
| JetBrains | IntelliJ IDEA, PyCharm, WebStorm, PhpStorm и другие, версия 2022.1 или выше |
| RAM / диск | от 1 ГБ и от 20 МБ (без локальных моделей) |

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

## Установка {#install}

### VS Code {#install-vscode}

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

![VS Code: панель Extensions, поиск CodeGPT, кнопка Install у расширения CodeGPT: AI Coding Agents & Chat](https://b51bc417-3ee0-451a-a83b-8a681d027a96.selstorage.ru/public/e29b3deea1a8ab414c56cc3fdea0b547.png)

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

### JetBrains и Visual Studio {#install-others}

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

## Подключение к RouterAI {#connect}

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. Поэтому вписывайте полный адрес:

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

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

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

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

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

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

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

## Выбор модели {#models}

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

| Модель | Идентификатор | Контекст | Для чего |
|---|---|---|---|
| Claude Sonnet 5.5 | `anthropic/claude-sonnet-5.5` | 1 000 000 | Основная для Agent: многофайловые правки, рефакторинг |
| GPT-6 Astra | `openai/gpt-6-astra` | 1 050 000 | Сложные агентные задачи, сравнение с Claude на своём проекте |
| Claude Haiku 5.5 | `anthropic/claude-haiku-5.5` | 1 000 000 | Быстрый чат и Search, дешевле Sonnet |
| DeepSeek V4.1 Flash | `deepseek/deepseek-v4.1-flash` | 1 048 576 | Дешёвые частые запросы: объяснить, прокомментировать |
| GLM 5.3 Flash | `z-ai/glm-5.3-flash` | 1 048 576 | Самый лёгкий вариант для коротких задач |

Подробнее о линейке OpenAI — в статье [GPT-6 Luna, Sol и Astra](/pages/gpt-6-luna-sol-astra-routerai), о быстрой модели Anthropic — в [обзоре Claude Haiku 5.5](/pages/claude-haiku-5-5-obzor).

### Две модели под разные задачи {#two-profiles}

«Профили» в 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](/pages/vibe-coding-vscode-continue), где автодополнение настраивается в `config.yaml`.

## Проверка подключения {#check}

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

Расход по каждому запросу виден в [статистике RouterAI](/settings/activity).

## Решение проблем {#troubleshooting}

**«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 и установить расширение заново.

## Что дальше {#next}

- [Каталог моделей RouterAI](/models) — идентификаторы и контекст для настройки.
- [Continue + RouterAI](/pages/vibe-coding-vscode-continue) — расширение с автодополнением и настройкой через `config.yaml`.
- [Kilo Code](/pages/vibe-coding-vscode-kilo-code) и [Roo Code](/pages/vibe-coding-vscode-roo-code) — агенты для VS Code с прямой настройкой OpenAI-совместимого провайдера.
- [Claude Haiku 5.5](/pages/claude-haiku-5-5-obzor) и [GPT-6 Astra](/pages/gpt-6-luna-sol-astra-routerai) — как выбрать модель под задачу.