Trae + JoinGonka Gateway — модели сети Gonka в AI-IDE

Сборка и версия. У Trae две ветки: международная (документация на docs.trae.ai) и китайская (docs.trae.cn). Форма Custom Model есть в обеих и устроена одинаково; различаются встроенные модели и набор пресетов в дополнительных настройках. Произвольный адрес запроса для своей модели поддерживается с версии 3.5.51 от 14 апреля 2026 — если ваша сборка старше, обновитесь. Международная сборка доступна не во всех странах: до установки сверьтесь со списком поддерживаемых стран и регионов.

Система. macOS 12 и новее, Windows 10 или 11 (x64), Linux в пакетах .deb и .rpm. При первом запуске Trae предложит выбрать тему и язык, импортировать настройки из VS Code или Cursor и войти в аккаунт.

Ключ JoinGonka. Зарегистрируйтесь на шлюзе, откройте в кабинете раздел «API-ключи» и нажмите «Создать ключ». Ключ начинается с jg- и показывается один раз — сохраните его сразу. Удобно завести под Trae отдельный ключ: в разделе «Использование» его расход будет виден отдельной строкой.

Тариф Trae. Свою модель нужно выбирать в списке моделей вручную, а в таблице тарифов Trae у бесплатного плана в строке выбора модели значится только режим Auto — в нём свои модели не используются. Распространяется ли это ограничение на модели, добавленные своим ключом, документация прямо не говорит. Практическое правило простое: если на вашем плане Auto Mode в списке моделей выключается, всё готово; если нет — понадобится платный план.

1. Откройте Settings → Models — панель управления моделями.
2. Нажмите Add Model. В открывшемся окне выберите вариант Custom Model, а не провайдера из готового списка.
3. Заполните поля значениями из таблицы. Столбцов два — под каждый из форматов API; выберите один.
4. Нажмите Add Model. Trae сделает пробный вызов API и проверит ключ: при успехе модель появится в списке, при неудаче окно покажет сообщение об ошибке и лог ответа провайдера.

Остальные поля от формата не зависят:

Какой формат выбрать. Начните с OpenAI Chat Completions: это основной путь шлюза, на нём работает большинство инструментов. Anthropic Messages пригодится, если вы привыкли к этому формату в других инструментах или хотите сравнить поведение агента на двух протоколах — ключ и баланс у них общие.

Как работает Full URL. Переключатель решает, кто дописывает путь. Выключен — вы даёте базовый адрес, а Trae добавляет путь по выбранному формату: /chat/completions к адресу с /v1 для OpenAI и /v1/messages к корню для Anthropic. Включён — адрес используется как есть, и путь должен стоять в нём целиком. Самая частая ошибка — смешать режимы: вписать полный путь при выключенном переключателе или базовый адрес при включённом.

Одна запись — одна модель. Повторите шаги для остальных моделей сети, чтобы переключаться между ними без возврата в настройки: deepseek-ai/DeepSeek-V4-Flash-0731, MiniMaxAI/MiniMax-M2.7 и zai-org/GLM-5.3-Flash. Актуальный список отдаёт GET https://gate.joingonka.ai/v1/models. Добавленную модель потом можно отредактировать, отключить (она останется в панели, но пропадёт из списка в чате) или удалить.

Под основными полями есть сворачиваемый список Advanced Settings. Его можно не трогать — Trae подставит значения по умолчанию, — но две настройки стоит задать осознанно: серию модели и окно контекста.

Цена у моделей сети одинаковая, так что выбор — про поведение. Все модели из таблицы поддерживают нативный tool calling, на котором держится работа агентов Trae.

Как устроен бюджет рассуждений и почему reasoning-модели нельзя занижать лимит выхода, разобрано в обзоре GLM-5.3 Flash; сравнение моделей на задачах разработки — в статье про лучшие модели для кода.

Свои модели живут в общем списке: нажмите на имя текущей модели в правом нижнем углу поля ввода чата и выберите добавленную. Там же находится переключатель Auto Mode — он должен быть выключен: в режиме Auto Trae сам выбирает модель из встроенных и добавленные вами не использует.

Дайте агенту задачу, где нужен инструмент, например: «Прочитай package.json и перечисли скрипты сборки». Агент должен открыть файл и ответить по существу — значит, цикл «запрос — вызов инструмента — ответ» через шлюз собирается. Затем откройте кабинет шлюза, раздел «Использование»: в блоке «По ключам» у ключа Trae появятся запросы и время последнего обращения, в блоке «По моделям» — выбранная модель.

Если что-то пошло не так, смотрите на текст ошибки. Ответ своей модели Trae не прячет: ошибку провайдера он показывает как есть, с собственным кодом 4028.

Агент в IDE тратит токены быстрее чата: в каждый запрос уходят системные инструкции, описание инструментов, открытые файлы и история шагов. Поэтому цена за токен определяет, можно ли запускать агента на каждую мелочь или приходится экономить.

Через JoinGonka Gateway токены стоят $0.0069 за миллион на входе и $0.021 за миллион на выходе — цена одинакова для всех моделей сети и подставляется на этой странице из живого источника. Порядок сумм по ценам на сентябрь 2026:

Сравнение с самим Trae получается наглядным, потому что открытые модели есть и среди встроенных, а Trae публикует их прайс-лист за миллион токенов. DeepSeek-V4-Flash и MiniMax-M2.7 стоят там $0.30 на входе и $1.20 на выходе, а GLM-5.3 Flash во встроенном списке международной сборки нет вовсе. Через шлюз разница по тем же моделям — примерно ×43 на входе и ×58 на выходе.

Своя модель работает там, где есть список моделей. Это чат и агенты — и в режиме IDE, и в SOLO (свои модели поддерживаются в нём с версии 3.3.0). Автодополнение и предсказание правок — отдельный механизм CUE со своей панелью настроек: выбора модели в ней нет, а его лимиты задаёт тариф Trae.

Инструменты и MCP. Агенты Trae выступают MCP-клиентами, и подключённые вами серверы остаются доступны агенту на своей модели: все модели сети поддерживают нативный вызов инструментов. Если Trae сообщит, что схема аргументов инструмента несовместима с моделью (код 4027), попробуйте соседнюю модель сети или другой MCP-сервер.

TraeWork. В отдельном приложении TraeWork форма добавления своей модели такая же, но, по документации, работает она только в TraeWork Desktop и только для задач в локальном окружении.

Плагин для чужих редакторов. В документации плагина TraeCode для VS Code и JetBrains раздела о своих моделях нет — этот гайд относится к настольной IDE. Если вы остаётесь в VS Code, тот же шлюз подключается через агентные расширения, например Cline.

Приватность. Настройка Privacy Mode (Settings → Account) управляет тем, что сам Trae делает с вашими диалогами и фрагментами кода: с ней они не идут в аналитику и обучение. Со стороны шлюза диалоги не хранятся: промпты и ответы не остаются на нём после ответа, в кабинете видны только счётчики запросов и токенов.

Если нужна работа с картинками — макет, скриншот ошибки, — поручите такую задачу встроенной модели со зрением, а код, команды и файлы оставьте модели сети: переключение занимает один клик в списке моделей.