# Руководство по настройке Trae

> Подключите LLMoxy в ByteDance Trae IDE через пользовательскую модель и программируйте с агентом в Chat / Builder.

Сайт: [https://www.trae.cn (Китай)](https://www.trae.cn) · [https://www.trae.ai (международная версия)](https://www.trae.ai)

Trae (читается /treɪ/) — AI IDE от ByteDance на базе VS Code со встроенными Chat и Builder. Помимо встроенных моделей, через пользовательскую конфигурацию можно направлять запросы в LLMoxy.

Прежде чем начать, подготовьте [токен LLMoxy](https://ru.llmoxy.com/docs/get-started/get-token); рекомендуется группа **auto**.

## Установка

1. Откройте официальный сайт и скачайте `.exe` или `.dmg` для вашей системы (для Apple Silicon выберите ARM).
2. При первом запуске выберите тему и упрощённый китайский язык.
3. По желанию импортируйте плагины, горячие клавиши и настройки из VS Code или Cursor.
4. Рекомендуется установить командную строку `trae`, после чего можно открывать текущий каталог командой `trae .`.

![Скачать Trae](https://ru.llmoxy.com/docs-assets/migrated/tutorial-trae/download.png)

![Импорт из VS Code / Cursor](https://ru.llmoxy.com/docs-assets/migrated/tutorial-trae/import.webp)

## Подключение к LLMoxy

1. Откройте **Настройки → Модели**.
2. Нажмите **Добавить модель**.
3. Выберите самый верхний пункт **Пользовательская модель** (не выбирайте предустановленных вендоров, таких как DeepSeek или Alibaba Cloud).
4. Заполните поля ниже и нажмите «Добавить». Trae сначала проверит, действителен ли ключ.

![Открыть управление моделями](https://ru.llmoxy.com/docs-assets/migrated/tutorial-trae/models.png)

![Выбрать пользовательскую модель](https://ru.llmoxy.com/docs-assets/migrated/tutorial-trae/add-model.webp)

**Через OpenAI-совместимый режим (рекомендуется, GPT / Gemini / большинство моделей):**

| Поле | Значение |
| --- | --- |
| Формат API | OpenAI Chat Completions |
| Пользовательский адрес запроса | `https://llmoxy.com/v1` |
| Полный URL | **Выключено** |
| ID модели | например, `grok-4.7` |
| Ключ API | токен LLMoxy |

**Через Anthropic-совместимый режим (семейство Claude):**

| Поле | Значение |
| --- | --- |
| Формат API | Anthropic Messages |
| Пользовательский адрес запроса | `https://llmoxy.com` |
| Полный URL | **Выключено** |
| ID модели | например, `claude-opus-5-5`, `claude-fable-5-2` |
| Ключ API | токен LLMoxy |

> **💡 Подсказка**
> Переключатель «Полный URL» по умолчанию выключен. Если включить его, нужно указывать полный путь, например `https://llmoxy.com/v1/chat/completions`. Для GPT-5 / GPT-6 рекомендуется в расширенных настройках выбрать соответствующее «семейство моделей», и Trae автоматически изменит поля запроса.

После успешного добавления отключите Auto в правом нижнем углу поля ввода чата и выберите в списке только что добавленную модель.

## Как пользоваться

Справа находится панель AI:

- **Chat**: объяснение кода, поиск ошибок, вопросы с контекстом через `@имя_файла`.
- **Builder**: создание проекта с нуля на естественном языке; создаёт файлы, устанавливает зависимости, запускает предпросмотр.

![Chat и Builder](https://ru.llmoxy.com/docs-assets/migrated/tutorial-trae/assistant.png)

| Действие | macOS | Windows |
| --- | --- | --- |
| Принять изменения в текущем файле | `Command + Enter` | `Ctrl + Enter` |
| Отклонить изменения в текущем файле | `Command + Backspace` | `Ctrl + Backspace` |
| Встроенный диалог | `Command + I` | `Ctrl + I` |

Плагины VS Code также поддерживаются. Если вам привычнее Cline, см. [инструкцию по плагину Trae Cline](https://ru.llmoxy.com/docs/code-tutorials/trae-cline).

## Частые вопросы

**Пользовательский адрес запроса постоянно подсвечивается красным**
Сначала убедитесь, что «Полный URL» выключен, а адрес — `https://llmoxy.com/v1` (OpenAI) или `https://llmoxy.com` (Anthropic). Не добавляйте `/chat/completions` в базовый адрес.

**Проверка ключа не проходит**
Убедитесь, что в токене нет пробелов, группа — **auto**, а ID модели в точности совпадает с указанным в консоли.

**Builder в Windows выдаёт ошибку терминала**
В разделе «Настройки → Профиль терминала» выберите PowerShell 6 или новее.

Это markdown-версия страницы https://ru.llmoxy.com/docs/code-tutorials/trae.
