# Вайб-кодинг в TRAE: свои модели через RouterAI (Claude, GPT, DeepSeek)

**В этой статье** мы подключим к **[TRAE](https://www.trae.ai/)** — AI-IDE от ByteDance — свои модели через **[RouterAI](/ "RouterAI")**: Claude Sonnet 5.5, Claude Opus 5.5, GPT-6.2 Astra, DeepSeek V4.1 Flash, Qwen4-Max и GLM 5.3. Разберём окно **Add model** по полям, покажем оба варианта API format (OpenAI Chat Completions и Anthropic Messages) и объясним, как не получить 404 из-за переключателя **Full URL**. В итоге агент в TRAE будет работать по ключу RouterAI — без VPN и с оплатой в рублях.

## Что такое TRAE и чем он отличается от Cline и Roo {#what-is-trae}

TRAE — это не расширение для VS Code, а отдельная IDE со встроенным агентом. Внутри два режима: **IDE** (редактор с боковой панелью агента) и **SOLO**, где AI ведёт задачу сам. Дополняет их **CUE** — автодополнение по контексту, которое предлагает не только продолжение строки, но и связанные правки в других местах файла.

Отличия от Cline и Roo Code:

* **Своя оболочка.** Cline и Roo ставятся расширением в VS Code, Cursor или Windsurf. TRAE — самостоятельное приложение под macOS, Windows и Linux, поэтому настройки моделей живут не в `settings.json` расширения, а на экране **Settings → Models**.
* **Собственный агент и SOLO.** Встроенные агенты Chat и Agent плюс режим SOLO с планированием задачи и параллельными подзадачами.
* **Модели по умолчанию с лимитами.** TRAE даёт набор встроенных моделей (Seed, GLM, DeepSeek, Kimi, Qwen и другие) с бесплатными лимитами и платными тарифами. Свои модели добавляются отдельно — о них и пойдёт речь.

Смысл подключения через RouterAI простой: встроенный список ограничен, а агент умеет работать с любой моделью, которая отвечает по формату OpenAI или Anthropic. RouterAI даёт один ключ на весь каталог — от Claude и GPT до DeepSeek, Qwen и GLM — и оплату российскими картами.

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

* **ОС:** macOS 12.0 и новее (Apple Silicon или Intel), Windows 10/11 (x64), Linux — `.deb` для Ubuntu 20.04+ и Debian 10+ (x64 или ARM64), `.rpm` для Fedora 42 и RHEL 9.x.
* **Аккаунт TRAE.** Он нужен и для самого приложения, и для экрана моделей: без входа раздел **Models** показывает только кнопку **Log in**, а списка моделей и кнопки добавления нет.
* **Ключ RouterAI.** Создаётся в разделе «Ключи API» личного кабинета. Для теста хватит минимального пополнения.
* **Идентификатор модели** из [каталога RouterAI](/models "каталог моделей RouterAI"). Вписывать его нужно вручную — TRAE не подгружает список моделей провайдера.

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

1. Скачайте установщик со страницы загрузки: [trae.ai/download](https://www.trae.ai/download) для международной версии, [trae.cn/download](https://www.trae.cn/download) — для китайской. Ставьте ту версию, к которой привязан ваш аккаунт: интерфейсы и вход у них разные.
2. Установите приложение обычным способом: `.dmg` для macOS, `.exe` для Windows, `sudo apt install ./TRAE-linux-x64.deb` (или `dnf install`) для Linux.
3. При первом запуске TRAE предложит выбрать тему и язык, импортировать настройки из VS Code или Cursor, добавить команду `trae` в PATH — и попросит войти в аккаунт.
4. Откройте папку проекта: **Открыть папку** (Open Folder) на стартовом экране. Для своего проекта нажмите **Yes, I trust the authors**, иначе расширения и агент останутся в ограниченном режиме.

На старте TRAE предлагает выбрать, что импортировать из другой IDE, и стиль горячих клавиш:

![Диалог IDE Preferences при первом запуске TRAE: выбор IDE Configuration и Keyboard shortcut style, кнопка Configure in one click и ссылка Skip](https://b51bc417-3ee0-451a-a83b-8a681d027a96.selstorage.ru/public/383823739cacb84d65e222de73f3d4b6.png)

При открытии папки TRAE спрашивает, доверяете ли вы авторам файлов:

![Запрос доверия авторам файлов при открытии папки в TRAE: кнопки No, I don't trust the authors и Yes, I trust the authors](https://b51bc417-3ee0-451a-a83b-8a681d027a96.selstorage.ru/public/ae64f9ab6e3803f0bd6d0a11bf3c10d4.png)

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

Вся настройка — на одном экране. Путь: иконка шестерёнки в правом верхнем углу окна → **Settings** → в списке слева **Models** → кнопка **Add model** → в открывшемся окне выбрать **Custom model**.

![Настройки TRAE: в боковом меню выбран пункт Models, справа — раздел Models](https://b51bc417-3ee0-451a-a83b-8a681d027a96.selstorage.ru/public/65691ebe957e1cef4ed5499297b6c4e7.png)

Раздел **Models** открывается только после входа в аккаунт TRAE: без него на месте списка моделей видна лишь кнопка **Log in**.

Дальше заполняем форму **Custom model**. Полей немного, но два из них решают, заработает подключение или нет.

### API format: OpenAI Chat Completions или Anthropic Messages

Первое поле — **API format**. Вариантов два, и они не взаимозаменяемы:

* **OpenAI Chat Completions** — протокол `/v1/chat/completions`. Подходит для GPT-6.2 Astra, DeepSeek V4.1 Flash, Qwen4-Max, GLM 5.3 и вообще для большинства моделей.
* **Anthropic Messages** — протокол `/v1/messages`. Нужен для моделей Claude: в этом протоколе TRAE передаёт thinking-режим и рассуждающие блоки так, как их понимает Anthropic API.

Практическое правило: **Claude — Anthropic Messages, всё остальное — OpenAI Chat Completions**. Claude отвечает и в OpenAI-формате, но рассуждения модели полноценно передаются только в Anthropic Messages.

### Base URL и переключатель Full URL

Второе поле — **Custom request URL**. Рядом с ним переключатель **Full URL**, и он меняет смысл поля:

| Full URL | Что вписывать | Значение для OpenAI Chat Completions | Значение для Anthropic Messages |
| --- | --- | --- | --- |
| **Включён (рекомендуем)** | Полный адрес запроса вместе с путём | `https://routerai.ru/api/v1/chat/completions` | `https://routerai.ru/api/v1/messages` |
| Выключен | Только базовый адрес, путь TRAE допишет сам | `https://routerai.ru/api/v1` | `https://routerai.ru/api` |

Надёжнее всего включить **Full URL** и вписать полный адрес: тогда запрос уйдёт ровно туда, куда указано, и не важно, какой путь TRAE дописывает к базовому адресу.

Обратите внимание на асимметрию в колонке Anthropic Messages: базовый адрес Anthropic-совместимого API у RouterAI — `https://routerai.ru/api`, но путь сообщений всё равно начинается с `/v1`. Поэтому при включённом **Full URL** и формате Anthropic Messages адрес содержит `/v1` и в базе, и в пути.

Самая частая ошибка — вписать в **Custom request URL** полный адрес, забыв включить **Full URL**. Тогда TRAE допишет свой путь и получит `.../api/v1/chat/completions/chat/completions` — это 404. И наоборот: включённый переключатель с базовым адресом без пути тоже даст 404.

### Остальные поля

* **Model ID** — идентификатор из [каталога RouterAI](/models). Вписывается вручную, посимвольно: `anthropic/claude-sonnet-5.5`. Если в окне выбран предпросмотренный сервис, а нужной модели в списке нет, нажмите **Use other model** (в китайском интерфейсе — **使用其他模型**) и укажите ID там.
* **Model display name** — как модель будет называться в списке TRAE. Поле необязательное: если пусто, показывается сам Model ID.
* **API key** — ключ RouterAI. Вставляйте его только сюда, не в адрес и не в заголовки вручную.

Пример заполнения для Claude:

```
API format:          Anthropic Messages
Custom request URL:  https://routerai.ru/api/v1/messages
Full URL:            on
Model ID:            anthropic/claude-sonnet-5.5
Model display name:  Claude Sonnet 5.5 (RouterAI)
API key:             xxxxxxxxxxxx
```

Для GPT-6.2 Astra меняются три поля:

```
API format:          OpenAI Chat Completions
Custom request URL:  https://routerai.ru/api/v1/chat/completions
Model ID:            openai/gpt-6.2-astra
```

Если предпочитаете выключенный **Full URL**, в поле идёт только базовый адрес: `https://routerai.ru/api/v1` для OpenAI Chat Completions и `https://routerai.ru/api` для Anthropic Messages. При ошибке 404 вернитесь к варианту с полным адресом.

После заполнения нажмите кнопку добавления в правом нижнем углу окна — модель появится в списке и станет доступна в селекторе моделей.

### Продвинутые настройки

Под формой есть раздел **Advanced** (в китайской версии — **高级配置**). Для большинства моделей его можно не трогать: пустые поля означают значения по умолчанию. Там задаются профиль **Model series** под конкретное семейство (профили GPT-6, GPT-5, Gemini-3 и DeepSeek-4 доступны всем, Kimi, GLM-5 и Claude-4 — только в Enterprise), входной и выходной лимиты **Context window**, число раундов вызова инструментов, поддержка картинок и параметры **Thinking mode**.

Свои значения в этих полях имеют приоритет над настройками TRAE — если поставить лимит контекста больше, чем поддерживает модель, запросы начнут падать с ошибкой.

## Выбор модели {#model-choice}

Что имеет смысл добавить первым делом, по каталогу RouterAI:

| Модель и ID | Для чего |
| --- | --- |
| `anthropic/claude-sonnet-5.5` | Основная рабочая лошадка: сложный рефакторинг, многофайловые правки, разбор чужого кода |
| `anthropic/claude-opus-5.5` | Самые тяжёлые задачи — архитектура, запутанная логика, длинный контекст |
| `openai/gpt-6.2-astra` | Альтернатива Claude на том же уровне: агентные задачи и генерация кода, формат OpenAI |
| `deepseek/deepseek-v4.1-flash` | Быстрые и дешёвые проходы: тесты, мелкие правки, массовые переименования |
| `qwen/qwen4-max` | Длинный контекст и работа с большими репозиториями |
| `z-ai/glm-5.3` | Ещё один вариант для агентных сценариев, хорошо работает с инструментами |

Не обязательно добавлять всё сразу: каждая модель — отдельная запись в **Models**, и переключаться между ними можно в селекторе в нижней части окна чата. Начните с `anthropic/claude-sonnet-5.5` через Anthropic Messages, а быструю модель для рутины добавьте через OpenAI Chat Completions.

## Ограничение: Auto Mode не использует свои модели {#solo-limitation}

Важный момент, о котором легко забыть. В селекторе моделей TRAE есть переключатель **Auto Mode**: в этом режиме TRAE сам подбирает модель под задачу, ориентируясь на скорость ответа, производительность и расход ресурсов. **Auto Mode вызывает только встроенные модели TRAE и не обращается к добавленным вами.**

Своя модель работает там, где вы выбрали её явно: в чате и в режиме SOLO, где её подхватывает встроенный агент Agent.

Практический вывод: если модель «не отвечает» или ведёт себя как встроенная, первым делом проверьте, не включён ли Auto Mode и какая модель стоит в селекторе.

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

1. Откройте панель чата (иконка Agent в правом верхнем углу или панель агента в боковой части окна).
2. В селекторе моделей выберите добавленную запись — например, **Claude Sonnet 5.5 (RouterAI)**. Убедитесь, что Auto Mode выключен.
3. Отправьте короткий запрос: `Что делает функция totalAmount в invoices.js? Ответь одной строкой.`
4. Если ответ пришёл — откройте кабинет RouterAI, раздел со статистикой расходов, и сверьте: там должен появиться запрос к `anthropic/claude-sonnet-5.5` с ненулевой стоимостью. Это подтверждает, что трафик идёт через ваш ключ, а не через встроенные модели TRAE.

Стоимость одного такого запроса зависит от модели и объёма контекста, а цены в рублях за токены указаны в каталоге на странице каждой модели.

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

* **401 Unauthorized.** Ключ неверный, скопирован с обрезанным краем или вставлен не в то поле. Проверьте, что ключ стоит именно в **API key**, а не в адресе. Если ключ удалён в кабинете RouterAI, запросы тоже вернут 401 — создайте новый.
* **404 Not Found.** Почти всегда это **Full URL**. Выключенный переключатель ждёт базовый адрес (`https://routerai.ru/api/v1` или `https://routerai.ru/api`), включённый — полный путь (`.../chat/completions` или `.../messages`). Ещё одна причина: лишний `/v1` в базовом адресе при выключенном **Full URL** — TRAE допишет его сам, и получится `/api/v1/v1/messages`.
* **Model not found / модель не определяется.** Model ID вписан неточно: нужен префикс провайдера и точное написание, как в каталоге, — `anthropic/claude-sonnet-5.5`, а не `Claude Sonnet 5.5`. Отображаемое имя модели здесь не работает, TRAE отправляет в запрос именно Model ID.
* **Модель отвечает, но без рассуждений.** Проверьте **API format**: для Claude выбирайте **Anthropic Messages**.
* **Модель «не используется» в SOLO.** Выключите Auto Mode и выберите свою модель в селекторе вручную — автоматический режим вызывает только встроенные модели TRAE.

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

* [Каталог моделей RouterAI](/models) — все доступные ID, лимиты контекста и цены в рублях.
* [Вайб-кодинг в Claude Code](/pages/vibe-coding-claude-code) — если нужен терминальный агент на тех же моделях.
* [Вайб-кодинг в Qwen Code](/pages/vibe-coding-qwen-code) — open-source CLI-агент с Qwen и Claude через RouterAI.
* [Вайб-кодинг в Codex](/pages/vibe-coding-codex) — OpenAI Codex CLI через RouterAI.
* [Вайб-кодинг в Aider](/pages/vibe-coding-aider) — парный программист в терминале с Git-историей.

TRAE удобен тем, что переключение между Claude, GPT и DeepSeek занимает два клика в селекторе, а платите вы одним ключом RouterAI.

Экраны установки сняты на TRAE 3.6.20, адреса RouterAI проверены запросами 18 ноября 2026 года.
