Trae 自定义模型接入指南：用第三方 API 调 Claude 与 GPT
截至 2026-10-07，Trae（官方文档现称 TraeCode）在「设置 > 模型」里点「添加模型」、选「自定义模型」，就能接第三方 API：API 格式选 Anthropic Messages 或 OpenAI Chat Completions，再填请求地址、模型 ID 和 API 密钥。官方写明 Anthropic Messages 格式适用于 Claude 系列，常见兼容服务包括「部分 Claude API 代理服务」。本页按 Trae 官方文档与 QCode 文档，把每个字段怎么填、Auto 模式的限制和常见报错一次说清。
更新于 2026-10-07
四个关键字段与限制
自定义模型的 API 格式
官方给出 OpenAI Chat Completions（兼容 /v1/chat/completions）与 Anthropic Messages（兼容 /v1/messages）两种；后者官方写明适用于 Claude 系列。
Anthropic Messages 基础地址
QCode 文档给的填法：关闭「完整 URL」时填 https://api.qcode.cc/api，打开时填 https://api.qcode.cc/api/v1/messages。
OpenAI Chat Completions 基础地址
关闭「完整 URL」时填 https://api.qcode.cc/openai/v1，打开时填 https://api.qcode.cc/openai/v1/chat/completions。
Auto 模式与自定义模型
Trae 官方 Auto 模式页写明：开启 Auto 模式后，系统不会调用你添加的自定义模型。要用自己加的模型，先把 Auto 关掉。
Trae 的自定义模型是什么
截至 2026-10-07，Trae 官方文档写明「除内置模型外，TraeCode 还支持接入自定义模型」。来源分两类：一类是从 TraeCode 预设的模型服务商里选，按界面提示填 API 密钥；另一类是「自定义配置」，通过配置 API 格式、请求地址、模型 ID 和鉴权信息，接入 TraeCode 未预设的模型。QCode 这类第三方 API 走的是第二类。截至 2026-10-07，官方内置模型列表里列的是 Seed、GPT、GLM、DeepSeek、Kimi、Gemini、MiniMax 等系列，未见 Claude；想在 Trae 内置 AI 里用 Claude，可以加一个 Anthropic Messages 格式的自定义模型。另一条路是装 Claude Code 扩展，它与内置 AI 互不影响、可以共存。
官方口径（Trae 文档与更新日志）
Trae 官方文档写明，Anthropic Messages 格式「兼容 Anthropic /v1/messages 接口规范，适用于 Claude 系列及兼容 Anthropic Messages API 的模型服务」，常见兼容服务包括 Anthropic Claude、部分 Claude API 代理服务等；OpenAI Chat Completions 格式则「适用于大多数 OpenAI 兼容模型服务」。更新日志显示，2025-03-11 的 Trae v1.1.0 起支持自定义模型、可通过 API 密钥接入自有模型资源；2026-04-14 的 TRAE v3.5.51 起支持为自定义模型配置自定义请求地址。点「添加模型」后，TraeCode 会调用服务商接口检测 API 密钥是否有效，连接失败时窗口里会展示错误信息和服务商返回的日志。
Trae 自定义模型的时间线
Trae v1.1.0 发布，官方更新日志写明支持自定义模型，可通过 API 密钥接入自有模型资源。
TRAE v3.5.51 发布，更新日志写明支持为自定义模型配置自定义请求地址。
QCode 文档《Trae 集成》页标注的更新日期；页内给出两种 API 格式对应的 QCode 地址，并注明是参考写法、未在 Trae 里实测；本页于 2026-10-07 按官方页核对。
已确认 vs 没有核实到的
已确认（官方页逐字可核）
以下都能在 Trae 官方文档或 QCode 文档里逐字核到：自定义模型从「设置 > 模型」进入，点「添加模型」添加；「自定义配置」要填 API 格式、请求地址、模型 ID 和鉴权信息；API 格式有 OpenAI Chat Completions 与 Anthropic Messages 两种，后者适用于 Claude 系列；请求地址有「完整 URL」开关，关掉时由 TraeCode 按所选格式拼接请求路径；添加时 TraeCode 会调用服务商接口检测密钥；开启 Auto 模式后不会调用自定义模型。QCode 侧：Claude 模型只能走 Anthropic 协议，GPT 系只能走 OpenAI 协议，GLM、Kimi、DeepSeek、Qwen 两种都能走；同一个 API Key 各协议通用。
未证实与文档没写的
三件事没有核实到：① QCode 文档注明，Trae 这套 QCode 填法是按官方语义给出的参考写法，没有在 Trae 里实测，第一次配置请以 Trae 添加模型时的密钥检测结果为准；② 高级配置里的「模型系列」（GPT-5 系列、Deepseek-4 系列等）是否适合 QCode 上的 gpt-6.1-sol、deepseek-v4-pro，Trae 与 QCode 文档都没有写，本页不做推荐，不确定就不选，官方写明未选择时使用默认配置；③ Trae CN 与国际版有什么差异，官方文档没有按地区说明（QCode 文档原话），本页也不对国内版的自定义模型界面下断言。
选哪种 API 格式、走哪条路
Anthropic Messages 对 OpenAI Chat Completions
按模型家族选。QCode 文档写明 Claude 模型只能走 Anthropic 协议，GPT 系只能走 OpenAI 协议，GLM、Kimi、DeepSeek、Qwen 两种协议都能走。所以 claude-sonnet-5-5、claude-opus-5-5 选 Anthropic Messages，基础地址 https://api.qcode.cc/api；gpt-6.1-sol 选 OpenAI Chat Completions，基础地址 https://api.qcode.cc/openai/v1；deepseek-v4-pro、glm-5.3 两种都行。把 Claude 型号放进 OpenAI 格式，QCode 会返回 model_not_available_on_endpoint。
内置 AI 自定义模型对 Claude Code 扩展
两条路互不影响、可以共存。自定义模型给 Trae 内置 AI（Agent 与 Chat）用，格式可选 Anthropic Messages 或 OpenAI Chat Completions；Claude Code 扩展只走 Anthropic Messages，地址读 ANTHROPIC_BASE_URL，并要求 ~/.claude/config.json 里有 primaryApiKey 字段。QCode 文档的建议是：已购买 QCode 服务的话，主要通过 Claude Code 扩展使用。
在 Trae 里添加 QCode 自定义模型的七步
① 打开「设置 > 模型」，进入模型管理面板；② 点「添加模型」，在弹窗里选「自定义模型」，不要选预设服务商；③ API 格式：Claude 型号选 Anthropic Messages，GPT 型号选 OpenAI Chat Completions，GLM、Kimi、DeepSeek、Qwen 两种都可；④ 请求地址：关闭「完整 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；展示名称不填就默认显示模型 ID；⑥ API 密钥填你的 QCode cr_ 密钥；⑦ 点「添加模型」，TraeCode 会调用接口检测密钥，连接成功后模型进入列表。用之前先关掉 Auto 模式，在对话输入框右下角点当前模型名，切到你加的模型。
在 QCode 上
一把 QCode API Key 在 Trae 里能同时配 Anthropic Messages 与 OpenAI Chat Completions 两种格式：QCode 文档写明同一个 API Key 三种协议都可用，协议由请求路径决定。截至 2026-10-07 可调的型号里，Claude 有 claude-sonnet-5-5、claude-opus-5-5、claude-sonnet-5，GPT 有 gpt-6.1-sol，国产有 deepseek-v4-pro、glm-5.3、qwen3.8-max、kimi-k3，在 Trae 里每个型号各加一条自定义模型。按 token 计费，各模型单价见 /models。北美与欧洲用户可把地址里的 api.qcode.cc 换成 us.qcode.cc（洛杉矶），同一把 key 照用；请求记录可在 probe.qcode.cc 输入 API Key 查看。
常见问题
Trae 能接 Claude API 吗？
能。Trae 官方文档写明自定义模型的 Anthropic Messages 格式兼容 /v1/messages 接口规范，适用于 Claude 系列及兼容服务，常见兼容服务包括「部分 Claude API 代理服务」。接 QCode 时：API 格式选 Anthropic Messages，基础地址填 https://api.qcode.cc/api，模型 ID 填 claude-sonnet-5-5 这类在售型号，密钥填 cr_ 密钥。QCode 文档注明这是参考写法、未在 Trae 里实测。
请求地址该填完整 URL 还是基础地址？
两种都行，看「完整 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 扩展？
两条路可以共存。只想在 Trae 的 Agent 与 Chat 里换模型，用自定义模型就够；想在 Trae 里用 Claude Code，就装扩展，它用 ANTHROPIC_BASE_URL 与 ANTHROPIC_AUTH_TOKEN 两个环境变量，另需在 ~/.claude/config.json 写 primaryApiKey 字段（值可以任意，注意是 config.json 不是 settings.json）。QCode 文档建议已购买 QCode 服务的用户主要通过 Claude Code 扩展使用。
GPT 和国产模型也能这样接吗？
能，但格式要选对。QCode 文档写明 GPT 系只能走 OpenAI 协议，所以 gpt-6.1-sol 选 OpenAI Chat Completions、基础地址 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 官方文档《内置模型 & 自定义模型》中英文版（自定义模型的两类来源、添加步骤、API 格式、完整 URL 开关、模型 ID、密钥检测、高级配置与内置模型清单）、《Auto 模式》页（开启后不调用自定义模型）与更新日志（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），同日抓取。
相关阅读
Cline 接 OpenAI 兼容 API 指南
另一款编辑器内工具：三项配置接 QCode，BYOK 按量与 $20 订阅怎么选。
Claude Code vs Cursor 对比
模型能力、上下文窗口、执行方式、价格与 Agent 能力的全面比较。
AI 编程工具全面对比
Claude Code、Cursor、Antigravity、OpenAI Codex、GitHub Copilot 等主流工具怎么选。
本页字段名、步骤与引语核对于 2026-10-07，以 Trae 官方文档与 QCode 文档为准；Trae 的界面与字段可能随版本调整，恕不另行通知。QCode 文档注明 Trae 的填法为参考写法、未在 Trae 里实测，请以 Trae 添加模型时的密钥检测结果为准。模型可用性以 /models 为准。