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 робить із вашими діалогами та фрагментами коду: з нею вони не йдуть в аналітику та навчання. З боку шлюзу діалоги не зберігаються: промпти та відповіді не залишаються на ньому після відповіді, в кабінеті видно лише лічильники запитів і токенів.

Якщо потрібна робота з картинками — макет, скріншот помилки, — доручіть таке завдання вбудованій моделі із зором, а код, команди та файли залиште моделі мережі: перемикання займає один клік у списку моделей.