Skip to main content

​
Обзор

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

🔌 Поддержка двух протоколов

Настройте провайдеров OpenAI и Anthropic — один token, два протокола

🤖 400+ моделей

GPT, Claude, Gemini, DeepSeek, Doubao, Qwen — все через один шлюз

💰 Скидка 5% на Claude

Выберите группу ClaudeCode при создании token, чтобы сэкономить 5% на Claude, скидка суммируется с бонусами за пополнение

🛡️ Стабильное прямое подключение

api.apiyi.com напрямую доступен из материкового Китая — дополнительный proxy не нужен
Информация о продукте
  • 🔗 Международная версия: www.trae.ai
  • 🔗 Китайская версия: www.trae.cn
  • 👥 Разработчик: ByteDance
  • 📅 Впервые выпущен: январь 2025 года
  • 🧩 Режимы: Builder (агент) / Chat (боковая панель) / Inline Chat
  • 🌐 Поддерживаемые протоколы: OpenAI, Anthropic, а также многие другие сторонние провайдеры

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

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

  • Режим 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.
Почему стоит маршрутизировать через APIYI: встроенные модели Trae ограничены по региону и версии, и нет способа разделять использование между несколькими upstream-аккаунтами. С APIYI один token покрывает и OpenAI, и Anthropic — переключение между GPT и Claude больше не требует возвращаться в настройки; просто выберите модель в выпадающем списке на верхней панели Trae.
⚠️ Совместимость моделей — прочитайте перед настройкой
  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: Codex нативно использует протокол Responses, поэтому gpt-5.6-sol / gpt-5.5 работают на полной мощности.

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

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

Скачайте с www.trae.ai — поддерживает macOS, Windows, Linux. Международная сборка из коробки включает пресеты GPT / Claude / Gemini.

​
Шаг 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 — не только домен: Пользовательская модель Trae — подключение по протоколу OpenAI к APIYI с URL запроса https://api.apiyi.com/v1/chat/completions
Базовый URL должен содержать полный путь: начиная с версии v3.3.51, поле baseURL для пользовательской модели Trae используется без изменений — теперь оно больше не добавляет автоматически /chat/completions. Если указать только https://api.apiyi.com или https://api.apiyi.com/v1, возникнет ошибка.
Модели, для которых предназначена эта запись: gpt-5.1 / gpt-5.2, Gemini, DeepSeek, Doubao, Qwen и другие модели, не ограниченные чат-протоколом. gpt-5.4 и более новые модели GPT (серии 5.5 / 5.6) здесь НЕ работают — см. “Model compatibility” выше; для них используйте приложение Codex.

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

Если вам также нужны Claude Opus 4.6 / Sonnet 4.6 / Haiku 4.5, добавьте вторую запись поставщика: Пользовательская модель Trae — подключение по протоколу Anthropic к APIYI с URL запроса https://api.apiyi.com/v1/messages
Два протокола, два пути: протокол OpenAI идет через /v1/chat/completions; протокол Anthropic идет через /v1/messages. APIYI размещает оба эндпоинта, поэтому один и тот же токен можно одновременно привязать к обеим записям поставщика в Trae без конфликта.

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

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

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

Ежедневное программирование (лучшее соотношение цены и качества)

Claude Sonnet 4.6 (Anthropic) + GPT-5.1 (OpenAI)Sonnet 4.6 обладает первоклассными возможностями программирования при отличной тарификации; GPT-5.1 быстрее для повседневного Chat

Сложная архитектура (флагман)

Claude Opus 4.6 (Anthropic)Лучше всего подходит для крупных рефакторингов, межфайлового анализа и архитектурных решений — используйте вместе с режимом Builder

Глубокое рассуждение

Claude Sonnet 4.6 Thinking / GPT-5.1 ThinkingПринудительное chain-of-thought — отлично подходит для алгоритмов, логических задач и проверки безопасности

Оптимизировано по стоимости (модели CN)

DeepSeek V4 / Doubao 1.5 Pro / Qwen3 CoderМаршрутизируется через протокол OpenAI — низкая стоимость за token и естественный китайский вывод
Почему последние модели GPT (5.4 и новее) отсутствуют в этом списке: Trae не поддерживает протокол Responses, поэтому gpt-5.4 / gpt-5.5 / gpt-5.6 все завершаются ошибкой 400 в сценариях Builder / Chat с вызовом tools (см. «Совместимость моделей» выше). Используйте приложение Codex для них; для agent-задач внутри Trae семейство Claude (нативный протокол Anthropic) — самый надежный выбор.

Смотрите полный список моделей и рекомендации по программированию

APIYI предоставляет более 400 моделей через единый шлюз. Страница рекомендаций по моделям регулярно обновляется с учетом последних сравнений производительности и цен.

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

1

Сохраните обе записи провайдера

Добавьте обе записи OpenAI и Anthropic — при переключении GPT/Gemini ↔ Claude больше не нужно редактировать baseURL.
2

Не можете найти в выпадающем списке самую новую модель?

Встроенные пресеты моделей в Trae отстают от фактического предложения APIYI. Выберите «Custom model» и введите ID вручную — для канонического ID сверяйтесь с консолью APIYI или страницей рекомендаций по моделям.
3

Предпочитайте Claude для режима Builder

Claude (особенно Sonnet 4.6 / Opus 4.6) заметно надежнее следует инструкциям и выполняет многошаговые вызовы tools в agent workflows.
4

Добавьте суффикс -thinking для сложных задач

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

Разделяйте token по группе

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

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

Разницы нет — обе версии поддерживают Custom Model и обе позволяют одновременно добавить записи провайдеров OpenAI и Anthropic. Единственная реальная разница — встроенные предустановленные модели (CN ориентирована на Doubao/DeepSeek; международная — на GPT/Claude/Gemini).Рекомендация: выбирайте TRAE CN (trae.cn), если вы в материковом Китае, выбирайте международный TRAE (trae.ai) для глобальных команд или когда вам нужны зарубежные предустановленные модели.
Начиная с 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
Да. Запись провайдера Anthropic тоже предлагает вариант «Custom Model» — вводите идентификаторы вроде claude-opus-4-6 / claude-sonnet-4-6-thinking / claude-haiku-4-5-20251001 напрямую. Эндпоинт /v1/messages в APIYI полностью совместим с официальными model ID.
При создании token в api.apiyi.com/token, выберите группу ClaudeCode — вызовы Claude автоматически получают скидку 5%, которая суммируется с бонусом за пополнение 10%-20%.Вставьте этот token группы ClaudeCode в запись провайдера Anthropic в Trae, и скидка применится автоматически.
Список предустановок Trae отстает от фактической доступности на upstream. Лучший вариант: выберите «Custom model» и введите идентификатор вручную — все, что поддерживает backend APIYI, будет работать; не нужно ждать, пока клиент Trae обновит свои предустановки.
  1. Отдавайте предпочтение Claude Sonnet 4.6 или Opus 4.6: они заметно надежнее в сценариях с вызовами инструментов
  2. Избегайте маленьких моделей без рассуждения: DeepSeek-Chat / меньшие варианты Qwen могут зацикливаться в режиме Builder — переключитесь на вариант thinking
  3. Следите за длиной контекста: для крупных изменений в нескольких файлах переключайтесь на Opus 4.6 (контекст 200K)
  4. Проверяйте актуальный статус APIYI: периодические сбои upstream затрагивают всех клиентов — убедитесь, что проблема не в канале
Полный текст ошибки обычно такой: 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 в Trae — его провайдер «OpenAI» использует /v1/responses, и мы проверили, что вызовы инструментов работают внутри Trae, фактически добавляя канал Responses. Учтите, что Roo Code снят с поддержки и его список предустановленных моделей заканчивается на gpt-5.4
  3. Если вам нужны рассуждения gpt-5.5 / 5.6 вместе с вызовами инструментов: используйте клиент с поддержкой Responses API — Codex app / CLI или opencode; см. полную таблицу поддержки клиентов в Нативном руководстве по OpenAI Responses API
Trae — это клиент ByteDance и отправляет телеметрию и данные разговоров в соответствии с официальной политикой конфиденциальности. Если для вас чувствительна клиентская телеметрия, рассмотрите:
  • Добавление в allow-list на корпоративном выходе
  • Скрывайте чувствительные фрагменты перед входом в режим Builder
  • Выбирайте open-source / проверяемые клиенты, такие как Claude Code или Cline, как альтернативу
См. руководство по каждой интеграции: Cursor · Cline · Claude Code · Codex CLI
  1. Проверьте, что API key начинается с sk- и не содержит лишних пробелов
  2. Проверьте, что baseURL указан правильно — особенно конечный путь (/v1/chat/completions vs /v1/messages)
  3. В консоли APIYI проверьте, что token включен и целевая модель привязана к группе token
  4. Недостаточный баланс тоже может проявляться как 401 — еще раз проверьте баланс аккаунта

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

Рекомендации по моделям

Сравнение производительности и подбор для сценариев программирования среди более чем 400 моделей

Консоль APIYI

Создавайте token, просматривайте использование, управляйте группами

Интеграция Cursor

Руководство по настройке для еще одной популярной AI IDE

Плагин Cline

Полнофункциональный агент внутри VS Code

Интеграция приложения Codex

Нативный протокол Responses — подходящее место для новейшей серии GPT (5.4+)
Нужна дополнительная помощь? Посетите api.apiyi.com или присоединяйтесь к официальному сообществу за технической поддержкой.