> ## Documentation Index
> Fetch the complete documentation index at: https://docs.apiyi.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Trae

> AI-нативная IDE ByteDance с режимами Builder/Chat/Inline Chat. Подключите APIYI через пользовательские записи моделей, чтобы охватить оба протокола OpenAI и Anthropic с более чем 400 ведущими моделями.

## Обзор

**Trae** — это **AI-native IDE**, запущенная ByteDance в январе 2025 года, позиционируется как инструмент продуктивности в стиле «Vibe Coding» для профессиональных разработчиков — опишите, что вы хотите, на естественном языке, и AI выполнит завершение, исправление ошибок, создание каркаса проекта и предпросмотр в один клик. Trae поставляется в двух вариантах: **TRAE CN** (`trae.cn`) и **международная TRAE** (`trae.ai`), а серия **SOLO** (Desktop / App / Web) позволяет агенту взять на себя весь жизненный цикл задачи.

Подключив APIYI через функцию Trae «Пользовательская модель», вы получаете:

<CardGroup cols={2}>
  <Card title="🔌 Поддержка двух протоколов" icon="plug">
    Настройте провайдеров OpenAI и Anthropic — один token, два протокола
  </Card>

  <Card title="🤖 400+ моделей" icon="layers">
    GPT, Claude, Gemini, DeepSeek, Doubao, Qwen — все через один шлюз
  </Card>

  <Card title="💰 Скидка 5% на Claude" icon="piggy-bank">
    Выберите группу ClaudeCode при создании token, чтобы сэкономить 5% на Claude, скидка суммируется с бонусами за пополнение
  </Card>

  <Card title="🛡️ Стабильное прямое подключение" icon="shield">
    `api.apiyi.com` напрямую доступен из материкового Китая — дополнительный proxy не нужен
  </Card>
</CardGroup>

<Info>
  **Информация о продукте**

  * 🔗 Международная версия: `www.trae.ai`
  * 🔗 Китайская версия: `www.trae.cn`
  * 👥 Разработчик: ByteDance
  * 📅 Впервые выпущен: январь 2025 года
  * 🧩 Режимы: Builder (агент) / Chat (боковая панель) / Inline Chat
  * 🌐 Поддерживаемые протоколы: OpenAI, Anthropic, а также многие другие сторонние провайдеры
</Info>

## Основные возможности

### Три режима взаимодействия

* **Режим Builder**: агент берет управление на себя — читает и записывает файлы, выполняет команды, создает каркас проектов
* **Режим Chat**: беседа в боковой панели, похожая на Cursor Chat / Cline, отлично подходит для вопросов и ответов и фрагментов
* **Inline Chat**: `Cmd/Ctrl + I` открывает встроенную в редакторе беседу — самый быстрый путь для завершения и рефакторинга

### MCP и экосистема инструментов

* Встроенная поддержка **MCP (Model Context Protocol)** для внешних tools и API
* Поддержка **Remote-SSH** — удаленная разработка ощущается так же, как локальная
* Файлы `.rules` для AI-поведения на уровне проекта

### Пользовательская модель (основная тема этого руководства)

Международная версия Trae поставляется с пресетами для **Anthropic, OpenAI, Gemini, xAI, OpenRouter, Ollama, DeepSeek, Volcano Engine, Aliyun, Tencent Cloud, SiliconFlow, PPIO, Novita, BytePlus** и других. Каждый пресет позволяет указать **пользовательский ID модели + API key + пользовательский URL запроса** — это и есть точка входа, которую мы будем использовать, чтобы подключить APIYI.

<Tip>
  **Почему стоит маршрутизировать через APIYI**: встроенные модели Trae ограничены по региону и версии, и нет способа разделять использование между несколькими upstream-аккаунтами. С APIYI **один token покрывает и OpenAI, и Anthropic** — переключение между GPT и Claude больше не требует возвращаться в настройки; просто выберите модель в выпадающем списке на верхней панели Trae.
</Tip>

<Warning>
  **⚠️ Совместимость моделей — прочитайте перед настройкой**

  1. **Trae не поддерживает протокол Responses**: у пользовательских моделей есть только два канала — `/v1/chat/completions` (протокол OpenAI) и `/v1/messages` (протокол Anthropic). Начиная с серии GPT-5.4, OpenAI ограничивает «reasoning + вызов tools» эндпоинтом `/v1/responses`, поэтому **`gpt-5.4` / `gpt-5.5` / `gpt-5.6` в сценариях Trae Builder / Chat (with tools) все возвращают 400 — по сути, непригодны к использованию**, даже `gpt-5.4` (подробности см. в FAQ ниже).
  2. **Совместимый с OpenAI режим chat плохо подходит для агентов**: даже с неограниченными моделями GPT поддержка рабочих процессов агента и расширенных разрешений для tools в режиме chat неполная — режим Builder часто зависает, а опыт использования ухудшается.
  3. **В Trae мы рекомендуем семейство Claude**: оно работает через нативный протокол Anthropic `/v1/messages` с полноценным и стабильным вызовом tools в режиме Builder — это наша рекомендация по умолчанию.
  4. **Для моделей, которые Trae не может запускать (последняя серия GPT), переключитесь на приложение [Codex](/ru/scenarios/programming/codex-cli)**: Codex нативно использует протокол Responses, поэтому `gpt-5.6-sol` / `gpt-5.5` работают на полной мощности.
</Warning>

## Краткий старт

### Шаг 1: Установите Trae

<Tabs>
  <Tab title="Международная версия (TRAE)">
    Скачайте с `www.trae.ai` — поддерживает macOS, Windows, Linux. Международная сборка из коробки включает пресеты GPT / Claude / Gemini.
  </Tab>

  <Tab title="Китайская версия (TRAE CN)">
    Скачайте с `www.trae.cn` — поддерживает macOS и Windows. В комплекте идут пресеты Doubao и DeepSeek; вход в аккаунт выполняется по номеру мобильного телефона.
  </Tab>
</Tabs>

### Шаг 2: Получите токен APIYI

1. Перейдите в консоль токенов APIYI: `api.apiyi.com/token`
2. Нажмите "New Token"
3. **Для интенсивного использования Claude**: выберите группу **ClaudeCode** — вызовы Claude получают **скидку 5%**, которая суммируется с бонусом пополнения 10%-20%
4. **Для смешанного использования GPT/Gemini/DeepSeek**: подойдет **группа по умолчанию**
5. Скопируйте ключ с префиксом `sk-`

### Шаг 3: Откройте панель пользовательской модели в Trae

* **Режим IDE**: нажмите значок ⚙️ в правом верхнем углу → **Models** в левом меню → "Add model" / "Custom model"
* **Режим SOLO**: нажмите ⚙️ в правом верхнем углу панели чата → **Models** → Add

### Шаг 4: Добавьте запись с протоколом OpenAI (GPT / Gemini / DeepSeek / Doubao и т. д.)

Заполните, как показано ниже. **Пользовательский URL запроса должен включать полный путь `/v1/chat/completions`** — не только домен:

<img src="https://mintcdn.com/apiyillc/vSACm1ThocKlKALW/images/trae-custom-model-openai.png?fit=max&auto=format&n=vSACm1ThocKlKALW&q=85&s=3b59889c3ae27a374a6da691beca2ffa" alt="Пользовательская модель Trae — подключение по протоколу OpenAI к APIYI с URL запроса https://api.apiyi.com/v1/chat/completions" width="477" height="521" data-path="images/trae-custom-model-openai.png" />

| Поле                             | Значение                                                         | Примечания                                 |
| -------------------------------- | ---------------------------------------------------------------- | ------------------------------------------ |
| **Поставщик**                    | `OpenAI`                                                         | Выберите пресет OpenAI                     |
| **Модель**                       | `Custom Model`                                                   | Последний пункт в выпадающем списке        |
| **ID модели**                    | например, `gpt-5.1`, `deepseek-v4-flash`, `gemini-3-pro-preview` | Полный ID нужной вам модели                |
| **API Key**                      | `sk-...`                                                         | Вставьте токен APIYI из шага 2             |
| **Пользовательский URL запроса** | `https://api.apiyi.com/v1/chat/completions`                      | **Должен включать `/v1/chat/completions`** |

<Warning>
  **Базовый URL должен содержать полный путь**: начиная с версии v3.3.51, поле baseURL для пользовательской модели Trae используется **без изменений** — теперь оно больше не добавляет автоматически `/chat/completions`. Если указать только `https://api.apiyi.com` или `https://api.apiyi.com/v1`, возникнет ошибка.
</Warning>

<Note>
  **Модели, для которых предназначена эта запись**: `gpt-5.1` / `gpt-5.2`, Gemini, DeepSeek, Doubao, Qwen и другие модели, не ограниченные чат-протоколом. **`gpt-5.4` и более новые модели GPT (серии 5.5 / 5.6) здесь НЕ работают** — см. "Model compatibility" выше; для них используйте [приложение Codex](/ru/scenarios/programming/codex-cli).
</Note>

### Шаг 5: Добавьте запись с протоколом Anthropic (семейство Claude)

Если вам также нужны Claude Opus 4.6 / Sonnet 4.6 / Haiku 4.5, добавьте вторую запись поставщика:

<img src="https://mintcdn.com/apiyillc/vSACm1ThocKlKALW/images/trae-custom-model-anthropic.png?fit=max&auto=format&n=vSACm1ThocKlKALW&q=85&s=18c4c41f103b88df7402ab92a99aa059" alt="Пользовательская модель Trae — подключение по протоколу Anthropic к APIYI с URL запроса https://api.apiyi.com/v1/messages" width="476" height="440" data-path="images/trae-custom-model-anthropic.png" />

| Поле                             | Значение                                                           | Примечания                                                                            |
| -------------------------------- | ------------------------------------------------------------------ | ------------------------------------------------------------------------------------- |
| **Поставщик**                    | `Anthropic`                                                        | Выберите пресет Anthropic                                                             |
| **Модель**                       | `Claude-Sonnet-4.6` (или другую версию Claude в выпадающем списке) | Используйте официальный пресет — переходить в "Custom model" не нужно                 |
| **API Key**                      | `sk-...`                                                           | Вставьте токен APIYI (желательно из группы ClaudeCode)                                |
| **Пользовательский URL запроса** | `https://api.apiyi.com/v1/messages`                                | **Должен включать `/v1/messages`** — обратите внимание, это НЕ `/v1/chat/completions` |

<Info>
  **Два протокола, два пути**: протокол OpenAI идет через `/v1/chat/completions`; протокол Anthropic идет через `/v1/messages`. APIYI размещает оба эндпоинта, поэтому один и тот же токен можно одновременно привязать к обеим записям поставщика в Trae без конфликта.
</Info>

### Шаг 6: Переключите модели и начните писать код

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

## Рекомендуемые наборы моделей

<CardGroup cols={2}>
  <Card title="Ежедневное программирование (лучшее соотношение цены и качества)" icon="code">
    **Claude Sonnet 4.6** (Anthropic) + **GPT-5.1** (OpenAI)

    Sonnet 4.6 обладает первоклассными возможностями программирования при отличной тарификации; GPT-5.1 быстрее для повседневного Chat
  </Card>

  <Card title="Сложная архитектура (флагман)" icon="crown">
    **Claude Opus 4.6** (Anthropic)

    Лучше всего подходит для крупных рефакторингов, межфайлового анализа и архитектурных решений — используйте вместе с режимом Builder
  </Card>

  <Card title="Глубокое рассуждение" icon="brain">
    **Claude Sonnet 4.6 Thinking** / **GPT-5.1 Thinking**

    Принудительное chain-of-thought — отлично подходит для алгоритмов, логических задач и проверки безопасности
  </Card>

  <Card title="Оптимизировано по стоимости (модели CN)" icon="yuan-sign">
    **DeepSeek V4** / **Doubao 1.5 Pro** / **Qwen3 Coder**

    Маршрутизируется через протокол OpenAI — низкая стоимость за token и естественный китайский вывод
  </Card>
</CardGroup>

<Info>
  **Почему последние модели GPT (5.4 и новее) отсутствуют в этом списке**: Trae не поддерживает протокол Responses, поэтому `gpt-5.4` / `gpt-5.5` / `gpt-5.6` все завершаются ошибкой 400 в сценариях Builder / Chat с вызовом tools (см. «Совместимость моделей» выше). Используйте [приложение Codex](/ru/scenarios/programming/codex-cli) для них; для agent-задач внутри Trae семейство Claude (нативный протокол Anthropic) — самый надежный выбор.
</Info>

<Card title="Смотрите полный список моделей и рекомендации по программированию" icon="star" href="/ru/api-capabilities/model-info">
  APIYI предоставляет более 400 моделей через единый шлюз. Страница рекомендаций по моделям регулярно обновляется с учетом последних сравнений производительности и цен.
</Card>

## Практические советы

<Steps>
  <Step title="Сохраните обе записи провайдера">
    Добавьте обе записи OpenAI и Anthropic — при переключении GPT/Gemini ↔ Claude больше не нужно редактировать baseURL.
  </Step>

  <Step title="Не можете найти в выпадающем списке самую новую модель?">
    Встроенные пресеты моделей в Trae отстают от фактического предложения APIYI. **Выберите «Custom model» и введите ID вручную** — для канонического ID сверяйтесь с консолью APIYI или страницей рекомендаций по моделям.
  </Step>

  <Step title="Предпочитайте Claude для режима Builder">
    Claude (особенно Sonnet 4.6 / Opus 4.6) заметно надежнее следует инструкциям и выполняет многошаговые вызовы tools в agent workflows.
  </Step>

  <Step title="Добавьте суффикс -thinking для сложных задач">
    Добавьте `-thinking` к ID модели (например, `claude-sonnet-4-6-thinking`), чтобы принудительно включить chain-of-thought. Заметно снижает галлюцинации при архитектурных решениях и аудитах безопасности в режиме Builder.
  </Step>

  <Step title="Разделяйте token по группе">
    Создайте один **token группы ClaudeCode** (95% тарифа) специально для записи Anthropic и один **token группы Default** для GPT/Gemini/DeepSeek. Более понятная тарификация и видимость квоты.
  </Step>
</Steps>

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

<AccordionGroup>
  <Accordion title="TRAE CN vs международный TRAE — есть ли разница для интеграции с APIYI?">
    **Разницы нет** — обе версии поддерживают Custom Model и обе позволяют одновременно добавить записи провайдеров OpenAI и Anthropic. Единственная реальная разница — встроенные предустановленные модели (CN ориентирована на Doubao/DeepSeek; международная — на GPT/Claude/Gemini).

    Рекомендация: выбирайте TRAE CN (`trae.cn`), если вы в материковом Китае, выбирайте международный TRAE (`trae.ai`) для глобальных команд или когда вам нужны зарубежные предустановленные модели.
  </Accordion>

  <Accordion title="Почему baseURL нужно указывать вплоть до /v1/chat/completions?">
    Начиная с **v3.3.51**, Trae изменил разбор custom-model baseURL — теперь он используется в запросе как есть, без автоматического добавления `/chat/completions`.

    Правильно:

    * Протокол OpenAI: `https://api.apiyi.com/v1/chat/completions`
    * Протокол Anthropic: `https://api.apiyi.com/v1/messages`

    Неверно (будет 404 или ошибка маршрутизации):

    * ❌ `https://api.apiyi.com`
    * ❌ `https://api.apiyi.com/v1`
  </Accordion>

  <Accordion title="Могу ли я использовать «Custom Model» у провайдера Anthropic, чтобы вводить любой model ID?">
    Да. Запись провайдера Anthropic тоже предлагает вариант «Custom Model» — вводите идентификаторы вроде `claude-opus-4-6` / `claude-sonnet-4-6-thinking` / `claude-haiku-4-5-20251001` напрямую. Эндпоинт `/v1/messages` в APIYI полностью совместим с официальными model ID.
  </Accordion>

  <Accordion title="Как получить скидку 5% на Claude?">
    При создании token в `api.apiyi.com/token`, **выберите группу ClaudeCode** — вызовы Claude автоматически получают **скидку 5%**, которая суммируется с бонусом за пополнение 10%-20%.

    Вставьте этот token группы ClaudeCode в запись провайдера Anthropic в Trae, и скидка применится автоматически.
  </Accordion>

  <Accordion title="Почему я не вижу GPT-5.1 / Claude 4.6 / последние модели в Trae?">
    Список предустановок Trae отстает от фактической доступности на upstream. **Лучший вариант: выберите «Custom model» и введите идентификатор вручную** — все, что поддерживает backend APIYI, будет работать; не нужно ждать, пока клиент Trae обновит свои предустановки.
  </Accordion>

  <Accordion title="Режим Builder зависает / вызовы инструментов не работают">
    1. **Отдавайте предпочтение Claude Sonnet 4.6 или Opus 4.6**: они заметно надежнее в сценариях с вызовами инструментов
    2. **Избегайте маленьких моделей без рассуждения**: DeepSeek-Chat / меньшие варианты Qwen могут зацикливаться в режиме Builder — переключитесь на вариант `thinking`
    3. **Следите за длиной контекста**: для крупных изменений в нескольких файлах переключайтесь на Opus 4.6 (контекст 200K)
    4. **Проверяйте актуальный статус APIYI**: периодические сбои upstream затрагивают всех клиентов — убедитесь, что проблема не в канале
  </Accordion>

  <Accordion title="gpt-5.6 / gpt-5.5 / gpt-5.4 возвращает 400: Function tools с reasoning_effort не поддерживаются?">
    Полный текст ошибки обычно такой: `Function tools with reasoning_effort are not supported for gpt-5.6-sol in /v1/chat/completions. To use function tools, use /v1/responses or set reasoning_effort to 'none'.` (400, `invalid_request_error`).

    Это **официальное ограничение OpenAI, введенное с серии GPT-5.4** — не проблема канала APIYI: на эндпоинте `/v1/chat/completions` function tools больше нельзя сочетать с `reasoning_effort`, кроме `none`. По умолчанию у этих моделей используется `reasoning_effort: medium`, поэтому ошибка возникает даже тогда, когда клиент не задает этот параметр — достаточно любого запроса с определениями инструментов. OpenAI предлагает два выхода: перейти на эндпоинт `/v1/responses` или явно установить `reasoning_effort` в `none` (отказавшись от рассуждения).

    Trae не может сделать ни то ни другое: custom models поддерживают только `/v1/chat/completions` (протокол OpenAI) и `/v1/messages` (протокол Anthropic) — без Responses API — и здесь нет настройки `reasoning_effort`. Режим Builder / Chat всегда отправляет определения инструментов, поэтому **обходного решения на стороне клиента нет**. JetBrains AI Assistant, opencode и другие клиенты упираются в ту же проблему на GPT-5.4+.

    Что делать:

    1. **Переключитесь на модель в Trae, на которую это не влияет**: `gpt-5.1` / `gpt-5.2` (протокол OpenAI), либо семейство Claude (протокол Anthropic через `/v1/messages`), Gemini / DeepSeek и т. д.
    2. **Оставайтесь внутри Trae**: установите плагин [Roo Code](/ru/scenarios/programming/roo-code) в Trae — его провайдер «OpenAI» использует `/v1/responses`, и мы проверили, что вызовы инструментов работают внутри Trae, фактически добавляя канал Responses. Учтите, что Roo Code снят с поддержки и его список предустановленных моделей заканчивается на `gpt-5.4`
    3. **Если вам нужны рассуждения gpt-5.5 / 5.6 вместе с вызовами инструментов**: используйте клиент с поддержкой Responses API — [Codex app / CLI](/ru/scenarios/programming/codex-cli) или [opencode](/ru/scenarios/programming/opencode); см. полную таблицу поддержки клиентов в [Нативном руководстве по OpenAI Responses API](/ru/api-capabilities/openai/native)
  </Accordion>

  <Accordion title="Что насчет телеметрии / отправки данных в Trae?">
    Trae — это клиент ByteDance и отправляет телеметрию и данные разговоров в соответствии с официальной политикой конфиденциальности. Если для вас чувствительна клиентская телеметрия, рассмотрите:

    * Добавление в allow-list на корпоративном выходе
    * Скрывайте чувствительные фрагменты перед входом в режим Builder
    * Выбирайте open-source / проверяемые клиенты, такие как [Claude Code](/ru/scenarios/programming/claude-code) или [Cline](/ru/scenarios/programming/cline), как альтернативу
  </Accordion>

  <Accordion title="Trae vs Cursor / Cline / Claude Code — как выбрать?">
    | Инструмент      | Тип            | Режим агента    | Интеграция с APIYI                       | Лучше всего подходит для                                       |
    | --------------- | -------------- | --------------- | ---------------------------------------- | -------------------------------------------------------------- |
    | **Trae**        | Отдельная IDE  | ✅ Builder       | Средняя (две записи для двух протоколов) | UX в стиле Cursor с сильной поддержкой китайского              |
    | **Cursor**      | Отдельная IDE  | ❌ (только Chat) | Просто (только протокол OpenAI)          | Лучшее в классе автодополнение и предварительный просмотр diff |
    | **Cline**       | Плагин VS Code | ✅               | Просто                                   | Если вы уже активно используете VS Code                        |
    | **Claude Code** | CLI            | ✅               | Просто                                   | Терминальный workflow, CI, удаленная разработка                |

    См. руководство по каждой интеграции: [Cursor](/ru/scenarios/programming/cursor) · [Cline](/ru/scenarios/programming/cline) · [Claude Code](/ru/scenarios/programming/claude-code) · [Codex CLI](/ru/scenarios/programming/codex-cli)
  </Accordion>

  <Accordion title="Как отлаживать ошибки 401 / 403?">
    1. Проверьте, что API key начинается с `sk-` и не содержит лишних пробелов
    2. Проверьте, что baseURL указан правильно — особенно конечный путь (`/v1/chat/completions` vs `/v1/messages`)
    3. В консоли APIYI проверьте, что token включен и целевая модель привязана к группе token
    4. Недостаточный баланс тоже может проявляться как 401 — еще раз проверьте баланс аккаунта
  </Accordion>
</AccordionGroup>

## Связанные ресурсы

<CardGroup cols={2}>
  <Card title="Рекомендации по моделям" icon="star" href="/ru/api-capabilities/model-info">
    Сравнение производительности и подбор для сценариев программирования среди более чем 400 моделей
  </Card>

  <Card title="Консоль APIYI" icon="settings" href="https://api.apiyi.com">
    Создавайте token, просматривайте использование, управляйте группами
  </Card>

  <Card title="Интеграция Cursor" icon="mouse-pointer-click" href="/ru/scenarios/programming/cursor">
    Руководство по настройке для еще одной популярной AI IDE
  </Card>

  <Card title="Плагин Cline" icon="puzzle" href="/ru/scenarios/programming/cline">
    Полнофункциональный агент внутри VS Code
  </Card>

  <Card title="Интеграция приложения Codex" icon="code" href="/ru/scenarios/programming/codex-cli">
    Нативный протокол Responses — подходящее место для новейшей серии GPT (5.4+)
  </Card>
</CardGroup>

<Info>
  **Нужна дополнительная помощь?** Посетите `api.apiyi.com` или присоединяйтесь к официальному сообществу за технической поддержкой.
</Info>