Свои модели в Trae: подключение стороннего API для Claude и GPT
По состоянию на 2026-10-07 Trae (в официальной документации теперь TraeCode) подключает сторонний API так: откройте Settings > Models, нажмите Add Model и выберите Custom Model, затем укажите формат API — Anthropic Messages или OpenAI Chat Completions, — URL запроса, ID модели и API-ключ. В официальной документации сказано, что формат Anthropic Messages подходит для серии Claude, а среди совместимых сервисов названы «some Claude API proxy services». Ниже — как заполнить каждое поле, ограничение режима Auto и частые ошибки, по документации Trae и QCode.
Обновлено 2026-10-07
Четыре ключевых поля и ограничения
Форматы API для своих моделей
Официально доступны OpenAI Chat Completions (совместим с /v1/chat/completions) и Anthropic Messages (совместим с /v1/messages); второй прямо назван подходящим для серии Claude.
Базовый URL для Anthropic Messages
По документации QCode: при выключенном Full URL — https://api.qcode.cc/api, при включённом — https://api.qcode.cc/api/v1/messages.
Базовый URL для OpenAI Chat Completions
При выключенном Full URL — https://api.qcode.cc/openai/v1, при включённом — https://api.qcode.cc/openai/v1/chat/completions.
Режим Auto и свои модели
На официальной странице режима Auto сказано: после включения Auto система не использует добавленные вами модели. Чтобы работать со своей моделью, выключите Auto.
Что такое свои модели в Trae
По состоянию на 2026-10-07 официальная документация Trae прямо пишет: «In addition to TraeCode's built-in models, you can also add custom models». Источников два: предустановленный провайдер, где модель выбирается из списка TraeCode и вводится API-ключ, и пользовательская конфигурация, где вы сами задаёте формат API, URL запроса, ID модели и данные аутентификации, чтобы добавить модель, которой в TraeCode нет. Сторонний API вроде QCode подключается вторым способом. В официальном списке встроенных моделей на 2026-10-07 перечислены семейства Seed, GPT, GLM, DeepSeek, Kimi, Gemini и MiniMax, моделей Claude в нём не видно; чтобы работать с Claude во встроенном AI Trae, можно добавить свою модель в формате Anthropic Messages. Второй путь — расширение Claude Code: оно работает независимо от встроенного AI, и их можно использовать вместе.
Официальная формулировка (документация и журнал изменений Trae)
Документация Trae описывает формат Anthropic Messages так: «Compatible with the Anthropic /v1/messages API specification. Suitable for the Claude series and model services compatible with the Anthropic Messages API», а в примерах — Anthropic Claude и «some Claude API proxy services»; формат OpenAI Chat Completions — «Suitable for most OpenAI-compatible model services». По журналу изменений, в Trae v1.1.0 от 2025-03-11 появилось добавление своих моделей с собственными API-ключами, а в TRAE v3.5.51 от 2026-04-14 — собственный URL запроса для своих моделей. После нажатия Add Model TraeCode обращается к API провайдера и проверяет ключ; если соединение не удалось, в окне показываются сообщения об ошибке и логи, которые вернул провайдер.
Хронология своих моделей в Trae
Выходит Trae v1.1.0; в официальном журнале изменений — поддержка своих моделей с собственными API-ключами.
Выходит TRAE v3.5.51 с поддержкой собственного URL запроса для своих моделей.
Дата обновления, указанная на странице документации QCode об интеграции с Trae; там приведены адреса QCode для обоих форматов API с пометкой, что это справочная схема, не проверенная внутри Trae; эта страница сверена с официальными источниками 2026-10-07.
Подтверждено vs не подтверждено
Подтверждено (дословно по официальным страницам)
Всё перечисленное дословно проверяется по документации Trae или QCode: свои модели добавляются в Settings > Models кнопкой Add Model; пользовательская конфигурация требует формат API, URL запроса, ID модели и аутентификацию; форматов два — OpenAI Chat Completions и Anthropic Messages, второй подходит для серии Claude; у URL запроса есть переключатель Full URL, и при выключенном TraeCode сам дописывает путь запроса под выбранный формат; при добавлении TraeCode обращается к API провайдера и проверяет ключ; при включённом Auto свои модели не используются. Со стороны QCode: модели Claude работают только по протоколу Anthropic, GPT — только по OpenAI, GLM, Kimi, DeepSeek и Qwen — по обоим; один API-ключ подходит для всех протоколов.
Не подтверждено или не описано в документации
Три вещи не подтверждены: ① документация QCode помечает свою схему для Trae как справочную, составленную по официальному описанию и не проверенную внутри Trae, поэтому при первой настройке ориентируйтесь на проверку ключа, которую Trae делает при добавлении модели; ② подходят ли пресеты Model Series в расширенных настройках (GPT-5 series, Deepseek-4 series и другие) для gpt-6.1-sol или deepseek-v4-pro на QCode, не сказано ни у Trae, ни у QCode, поэтому здесь ничего не рекомендуется; если сомневаетесь, ничего не выбирайте — по официальной документации тогда применяется конфигурация по умолчанию; ③ официальная документация не описывает различия между Trae CN и международной версией по регионам (это отмечает и документация QCode), и об экране своих моделей в китайской версии эта страница ничего не утверждает.
Какой формат API выбрать и каким путём идти
Anthropic Messages vs OpenAI Chat Completions
Выбор зависит от семейства моделей. По документации QCode модели Claude работают только по протоколу Anthropic, GPT — только по OpenAI, а GLM, Kimi, DeepSeek и Qwen — по обоим. Значит, для claude-sonnet-5-5 и claude-opus-5-5 нужен Anthropic Messages с базовым URL https://api.qcode.cc/api, для gpt-6.1-sol — OpenAI Chat Completions с базовым URL https://api.qcode.cc/openai/v1, а deepseek-v4-pro и glm-5.3 работают в любом формате. Если указать модель Claude в формате OpenAI, QCode вернёт model_not_available_on_endpoint.
Своя модель во встроенном AI vs расширение Claude Code
Оба пути независимы и могут работать вместе. Своя модель обслуживает встроенный AI Trae (Agent и Chat) в формате Anthropic Messages или OpenAI Chat Completions; расширение Claude Code работает только по Anthropic Messages, берёт адрес из ANTHROPIC_BASE_URL и требует поле primaryApiKey в ~/.claude/config.json. Документация QCode советует тем, кто купил услуги QCode, пользоваться в основном расширением Claude Code.
Семь шагов: QCode как своя модель в Trae
① Откройте Settings > Models — это панель управления моделями. ② Нажмите Add Model и в окне выберите Custom Model, а не предустановленного провайдера. ③ Формат API: для моделей Claude — Anthropic Messages, для GPT — OpenAI Chat Completions; GLM, Kimi, DeepSeek и Qwen работают с любым. ④ URL запроса: при выключенном Full URL введите базовый адрес https://api.qcode.cc/api (Anthropic) или https://api.qcode.cc/openai/v1 (OpenAI), путь TraeCode допишет сам; при включённом — https://api.qcode.cc/api/v1/messages или https://api.qcode.cc/openai/v1/chat/completions. ⑤ ID модели — точно как в списке qcode.cc/models, символ в символ, например claude-sonnet-5-5; если Display Name оставить пустым, отображается ID модели. ⑥ В поле API-ключа вставьте свой ключ QCode с префиксом cr_. ⑦ Нажмите Add Model: TraeCode проверит ключ и при успешном соединении добавит модель в список. Перед работой выключите Auto, нажмите на имя текущей модели в правом нижнем углу поля ввода чата и выберите свою модель.
На QCode
Одного API-ключа QCode хватает на оба формата в Trae: документация QCode пишет, что один и тот же API-ключ работает со всеми тремя протоколами, а протокол определяется путём запроса. Среди моделей, которые можно вызвать через QCode по состоянию на 2026-10-07, — claude-sonnet-5-5, claude-opus-5-5 и claude-sonnet-5 из Claude, gpt-6.1-sol из GPT, а также deepseek-v4-pro, glm-5.3, qwen3.8-max и kimi-k3 из китайских моделей; в Trae каждая добавляется отдельной своей моделью. Оплата за токены, цены по каждой модели — на /models. Пользователи из Северной Америки и Европы могут заменить в адресе api.qcode.cc на us.qcode.cc (Лос-Анджелес) с тем же ключом, а историю запросов можно посмотреть на probe.qcode.cc, введя API-ключ.
Частые вопросы
Можно ли подключить Claude API к Trae?
Да. В официальной документации Trae сказано, что формат Anthropic Messages для своих моделей совместим со спецификацией /v1/messages и подходит для серии Claude и совместимых сервисов, среди которых названы «some Claude API proxy services». Для QCode: формат Anthropic Messages, базовый URL https://api.qcode.cc/api, ID модели из списка, например claude-sonnet-5-5, и ключ cr_. Документация QCode отмечает, что эта схема справочная и внутри Trae не проверялась.
Указывать полный URL или базовый?
Подходит и то и другое — зависит от переключателя Full URL. Если он включён, введите полный адрес: https://api.qcode.cc/api/v1/messages или https://api.qcode.cc/openai/v1/chat/completions. Если выключен, достаточно базового https://api.qcode.cc/api или https://api.qcode.cc/openai/v1, а путь запроса, по официальной документации, TraeCode допишет под выбранный формат API. Документация QCode также предупреждает пользователей SDK: косая черта в конце даёт //v1/messages и ошибку 404, так что и в Trae её лучше не ставить.
Что означает model_not_available_on_endpoint?
Выбран не тот протокол, ключ ни при чём. По документации QCode модели Claude работают только по протоколу Anthropic; если указать модель Claude в OpenAI Chat Completions, вернётся эта ошибка, причём проверка идёт до аутентификации, а при неверном ключе приходит Invalid API key. Переключите формат API на Anthropic Messages, а адрес — на https://api.qcode.cc/api. Документация Trae говорит, что при неудачном соединении окно показывает сообщения об ошибке и логи провайдера — по ним удобно искать причину.
Модель добавлена — почему она не используется в чате?
Скорее всего, включён режим Auto. Документация Trae прямо говорит: после включения Auto система не использует добавленные вами модели. Выключите Auto, нажмите на имя текущей модели в правом нижнем углу поля ввода чата и выберите свою модель. Кроме того, отключённая своя модель остаётся на панели управления моделями, но не появляется в списке моделей поля ввода чата.
Своя модель во встроенном AI или расширение Claude Code?
Можно использовать оба. Если нужно только переключать модели во встроенных Agent и Chat, хватит своей модели. Чтобы работать с Claude Code внутри Trae, поставьте расширение: оно использует переменные окружения ANTHROPIC_BASE_URL и ANTHROPIC_AUTH_TOKEN и требует поле primaryApiKey в ~/.claude/config.json (значение любое; обратите внимание — config.json, а не settings.json). Документация QCode советует купившим услуги QCode пользоваться в основном расширением Claude Code.
А GPT и китайские модели подключаются так же?
Да, если выбрать правильный формат. По документации QCode GPT работает только по протоколу OpenAI, поэтому для gpt-6.1-sol нужен OpenAI Chat Completions с базовым URL https://api.qcode.cc/openai/v1; GLM, Kimi, DeepSeek и Qwen работают по обоим протоколам, так что deepseek-v4-pro, glm-5.3, qwen3.8-max и kimi-k3 подойдут в любом формате. ID моделей сверяйте с актуальным списком на /models символ в символ.
Источники
Со стороны Trae: официальная страница документации Trae «Built-in models & custom models» на английском и китайском (два источника своих моделей, шаги, форматы API, переключатель Full URL, ID модели, проверка ключа, расширенные настройки и список встроенных моделей), страница «Auto mode» (при включённом режиме свои модели не используются) и журнал изменений (записи 2025-03-11 о v1.1.0 и 2026-04-14 о v3.5.51), всё получено 2026-10-07. Со стороны QCode: страница документации QCode об интеграции с Trae (обновлена 2026-09-18: адреса QCode для обоих форматов, ключ cr_, настройка расширения Claude Code) и страница об эндпоинтах и форматах API (обновлена 2026-09-25: какие семейства моделей работают по каким протоколам, ошибка model_not_available_on_endpoint, три домена, probe.qcode.cc), получены в тот же день.
Один ключ для Claude и GPT в Trae
Форматы Anthropic Messages и OpenAI Chat Completions работают с одним API-ключом QCode; claude-sonnet-5-5, gpt-6.1-sol и другие модели оплачиваются за токены, цены по каждой модели — на /models.
Читайте также
Гид: Cline и OpenAI-совместимый API
Ещё один инструмент в редакторе: QCode подключается заполнением трёх полей, плюс выбор между BYOK с оплатой по факту и подпиской за $20.
Claude Code vs Cursor
Полное сравнение моделей, контекстного окна, режимов работы, цен и агентских возможностей.
Полное сравнение AI-инструментов для кодинга
Как выбрать между Claude Code, Cursor, Antigravity, OpenAI Codex, GitHub Copilot и другими.
Названия полей, шаги и цитаты на этой странице сверены 2026-10-07 с официальной документацией Trae и документацией QCode, приоритет за ними; интерфейс и поля Trae могут меняться от версии к версии без предупреждения. Документация QCode помечает схему для Trae как справочную и не проверенную внутри Trae, поэтому ориентируйтесь на проверку ключа, которую Trae делает при добавлении модели. Доступность моделей — по списку на /models.