字节跳动的 TRAE、阿里的 Qoder（国内版叫 Qoder CN，也就是改名后的通义灵码）、腾讯的 CodeBuddy，都允许在内置模型之外接入你自己的模型。选型时真正被问到的往往更具体：自己的地址和 Key 填在哪、工具发出的是哪种协议、哪些功能根本不走你的 Key。本文逐款回答，并把文心快码 Comate、JoyCode 和几家的插件为什么接不了、或者文档没写，放进第二张表。第三方行为均按各家官方文档、更新日志或源码核对（2026-09-29）：TraeCode 国内版 3.3.101 / 国际版 3.5.91，Qoder 0.4.2 与 Qoder CN 0.4.3，CodeBuddy Code 2.159.0。Router One 这一侧三款都一样：一把 sk- Key，/models 上的精确模型 ID，每次请求在控制台 → 日志里留一条记录，写明模型、Token、费用、状态和 request_id。
一句话结论。TRAE（TraeCode）：「设置 > 模型 > 添加模型 > 自定义模型」，OpenAI Chat Completions 格式填 https://api.router.one/v1，Anthropic Messages 格式填 https://api.router.one；记得关掉 Auto 模式，它只调用内置模型。Qoder 与 Qoder CN 桌面端：0.1.8 起个人版 BYOK 可以填自定义 Base URL，OpenAI Compatible（Chat Completions API 或 Responses API）填 https://api.router.one/v1。CodeBuddy：CodeBuddy Code 与 CodeBuddy IDE 共用 models.json，只支持 OpenAI 格式，url 填完整的 https://api.router.one/v1/chat/completions。三款都能用一把 Key 调用目录里的全部对话模型。接不了或文档没写的：文心快码 Comate 个人版、JoyCode、TraeCode 的插件和 CLI（TRAE 企业版除外）、Qoder IDE 与 Qoder CN IDE，以及各家的 JetBrains / VS Code 插件。
对照表
| 工具（核对版本） | 在哪里添加 | 工具发出的协议 | Router One 地址怎么填 | 能用的 Router One 模型 | 要注意的边界（按文档） |
|---|---|---|---|---|---|
| TRAE / TraeCode（国内版 3.3.101，国际版 3.5.91） | 设置 > 模型 > 添加模型 > 自定义模型 | OpenAI Chat Completions 格式或 Anthropic Messages 格式 | 「完整 URL」关：OpenAI 格式填 https://api.router.one/v1，Anthropic 格式填 https://api.router.one；开：https://api.router.one/v1/chat/completions 或 https://api.router.one/v1/messages | OpenAI 格式：全部对话模型；Anthropic 格式：Claude 系列与 DeepSeek V4 | Auto 模式只调用内置模型；Max 模式文档列出的都是内置模型 |
| Qoder / Qoder CN 桌面端（0.4.2 / 0.4.3，0.1.8 起可填 Base URL） | 设置 → 模型 → + 添加 → 供应商 → 自定义 | OpenAI Compatible（Chat Completions API 或 Responses API）；Anthropic Compatible | OpenAI Compatible 两种类型都填 https://api.router.one/v1；Anthropic Compatible 的拼接方式文档未写，不给值 | Chat Completions：全部对话模型；Responses：GPT 系列、DeepSeek V4 与 Grok 对话模型 | 仅个人版 BYOK；Repo Wiki 用固定模型，消耗 Credits |
| Qoder CLI / Qoder CN CLI（1.1.63，个人版 1.1.50 起可配自定义 URL） | /model → Custom 页的向导 | 由向导决定 | 向导要求填 Base URL 时填 https://api.router.one/v1（向导字段文档未逐项写明） | 与桌面端相同的 ID 规则 | 可选供应商以账号的 BYOK 目录为准；文档要求不要手改 settings.json |
| CodeBuddy（Code 2.159.0，IDE 4.12.1） | ~/.codebuddy/models.json 或项目内 .codebuddy/models.json | 只支持 OpenAI Chat Completions | url：https://api.router.one/v1/chat/completions | 全部对话模型 | 不设 relatedModels 时，后台 lite 与 reasoning 请求回退到主模型 |
Router One 这一列跟着协议走，不跟着工具走。/v1/chat/completions 提供目录中的全部对话模型——Claude、GPT、Gemini、Grok 与 DeepSeek 的 ID——所以 OpenAI 格式的条目永远不用改；/v1/messages 提供 Claude 系列与 DeepSeek V4（deepseek-v4.1-flash、deepseek-v4-flash）；/v1/responses 提供 GPT 系列、DeepSeek V4 与 Grok 对话模型。选错会在调用任何模型之前失败：Claude 的 ID 发到 /v1/responses 返回 HTTP 400 model '<id>' must be called via /v1/messages or /v1/chat/completions；GPT、Gemini 或 Grok 的 ID 走 Anthropic 格式，会收到指明 /v1/chat/completions 的 400。每个模型的详情页都列出它支持的端点，接受与拒绝清单见 API 兼容性事实页。逐项表单、高级配置和常见报错不在本文重复，放在下面链接的三个接入页里。
先把名字对齐：TraeCode、Qoder CN 与各家插件
搜「通义灵码自定义模型」「Trae 插件自定义模型」的人，常常先卡在名字上：
- TRAE → TraeCode。 TRAE 国内版（trae.cn）和国际版（trae.ai）的文档都把 IDE 称为 TraeCode。同一个文档站还有 TraeWork、TraeCode Plugin（VS Code / JetBrains 插件，原 MarsCode 编程助手插件，VS Code 扩展 ID 仍是
MarsCode.marscode-extension）和 TraeCode CLI。本文说的自定义模型入口在 TraeCode 里；TraeWork 桌面版的文档也有同样的「添加模型」表单（只用于本地任务）；TraeCode Plugin 与 TraeCode CLI 的自定义模型只写在 TRAE 企业版的文档里：管理员开启成员自定义模型权限后，成员可以在插件中自行添加，CLI（仅企业版旗舰版）在 trae_cli.yaml 中配置。 - 通义灵码 → Qoder CN。 阿里云帮助中心写明，Qoder CN 系列原名「智能编码助手通义灵码」（Lingma），2026-05-20 正式更名，新文档站是 docs.qoder.cn。编程相关的有 Qoder CN 桌面端、Qoder CN IDE、JetBrains 插件、VS Code 插件（Marketplace 上显示为「Qoder CN（Formerly Lingma）」）和 Qoder CN CLI。
- Qoder 桌面端不是 Qoder IDE。 Qoder 桌面端（文档也称 New Qoder）由 Qoder IDE 的 Quest 模式发展而来，2026-08-27 独立发布，两款并行、互不替代。能填自定义 Base URL 的是桌面端。
- CodeBuddy（腾讯云代码助手）。 有 CodeBuddy IDE、命令行工具 CodeBuddy Code，以及 VS Code / JetBrains 插件；
models.json是 CLI 与 IDE 的功能。
TRAE（TraeCode）：两种 API 格式，外加「完整 URL」开关
在 TraeCode 的「设置 > 模型」里点「添加模型」，选「自定义模型」，填写 API 格式、自定义请求地址（带「完整 URL」开关）、模型 ID、模型展示名称和 API 密钥，另有可选的「高级配置」。自定义请求地址是 2026-04-14 上线的（国内版 v3.3.51、国际版 v3.5.51，见国内版更新日志），所以更早的教程说「TRAE 不能填 Base URL」，已经过时。开关关闭时，TraeCode 按所选格式在基础地址后拼接路径，国际版文档的示例是 https://api.openai.com/v1 和 https://api.anthropic.com，对应到 Router One 就是：OpenAI Chat Completions 格式填 https://api.router.one/v1，Anthropic Messages 格式填 https://api.router.one。开关打开时，直接填 https://api.router.one/v1/chat/completions 或 https://api.router.one/v1/messages。格式按模型 ID 选：OpenAI 格式能调用全部对话模型，Anthropic 格式只适用于 Claude 系列与 DeepSeek V4。点「添加模型」时，TraeCode 会先检测连接，通过后才把模型加入列表。
哪些模式会用到自定义模型：
- Auto 模式：不会。 TRAE 文档写明，Auto 模式「仅支持调用 TraeCode 的内置模型，不支持调用你添加的自定义模型」。在对话输入框右下角的模型菜单里关掉 Auto Mode，再按展示名称选中你的模型。
- Max 模式：不会。 文档列出的可开启 Max 模式的模型都是内置模型。
- CUE 代码补全：文档未提。 CUE 文档没有提到可以换用自定义模型。
- SOLO 模式：会。 文档写明，自定义模型可以在内置智能体「Agent」中使用。
「高级配置」里的采样参数（Temperature、Top P、Top K）首次测试请留空，留空即使用模型服务商的默认值；Anthropic 的 API 对 Claude Opus 4.7 及之后的 Opus 模型，遇到非默认的采样参数会返回 HTTP 400（见 Opus 5.5 迁移指南）。计费上，国内版计费文档写明「仅调用 TRAE 内置模型时会消耗积分；调用自定义模型不会消耗积分」；国际版计费文档没有提到自定义模型。逐项表单、高级配置和「添加模型」检测失败的排查：TRAE 接入 Router One。
Qoder 与 Qoder CN（原通义灵码）：只有桌面端能填 Base URL
Qoder 桌面端与 Qoder CN 桌面端从 0.1.8（2026-09-05）起，个人版 BYOK 支持填写自定义 Base URL；两边的自定义模型文档字段相同，只差预置供应商列表。在「设置」→「模型」→「+ 添加」中打开「供应商」，在「自定义」分组里选 OpenAI Compatible 或 Anthropic Compatible；选 OpenAI Compatible 时再选 Chat Completions API 或 Responses API，然后填「接口地址（Base URL）」、API Key 和至少一个 Model ID。Qoder 界面给出的示例格式是 https://api.example.com/v1，与 Router One 的 https://api.router.one/v1 写法相同，两种 API 类型都填它。API 类型作用于整个条目：Claude 与 Gemini 的 ID 放进 Chat Completions 条目；GPT 系列、DeepSeek V4 与 Grok 对话模型的 ID 想走 Responses 时，再单独加一个 Responses API 条目。文档没有说明 Anthropic Compatible 如何在 Base URL 后拼接 Messages 路径，本文不给这一项的填写值；Claude 的 ID 走 Chat Completions，就能调用同样的模型。
其余几款 Qoder 产品接不了或有条件。Qoder IDE 与 Qoder CN IDE 的 BYOK 只接预置供应商，截至 1.32.0（2026-09-23）的更新日志没有提到自定义 Base URL；两家的 JetBrains 插件在 2026-09-03 的更新日志里写了「BYOK 支持配置自定义模型」，没说能否填地址。Qoder CLI 与 Qoder CN CLI 从 1.1.50（2026-09-11）起，个人版可以在 /model 的 Custom 页配置自定义 URL 端点的 BYOK 模型，但文档只概述了向导流程，并要求不要在 settings.json 中手工配置 BYOK，所以 CLI 按「有条件」对待。费用上，两边文档都写明：自定义模型的费用由服务商 API 账户直接结算，不占用 Qoder Credits；Repo Wiki 使用固定模型，会消耗 Credits。逐项配置、模型能力设置与校验失败的排查：Qoder 接入 Router One。
CodeBuddy：CLI 与 IDE 共用一份 models.json
CodeBuddy Code（命令行，npm install -g @tencent-ai/codebuddy-code）和 CodeBuddy IDE 从同样的位置读取自定义模型：~/.codebuddy/models.json 对所有项目生效，项目里的 .codebuddy/models.json 覆盖 id 相同的条目。文档写明自定义模型目前只支持 OpenAI 接口格式，url 必须是完整的接口路径、一般以 /chat/completions 结尾，所以 Router One 填 https://api.router.one/v1/chat/completions；这个端点提供全部对话模型，Claude 也在内。按 CodeBuddy Code 2.159.0 的源码，自定义模型的 url 会被规范成只以一个 /chat/completions 结尾，但不会补 /v1，只填主机根地址会拼错。
有两个字段决定账单。maxInputTokens 按模型详情页的上下文窗口填、不要超过，CLI 按它做自动压缩。relatedModels.lite 指向同一文件里一个更便宜的 ID，例如 anthropic/claude-haiku-4.5：按 CodeBuddy 文档，自定义模型不继承产品内置的 lite 与 reasoning 变体，不设的话，后台摘要和 Explore 子代理的请求都会按主模型计费。CodeBuddy IDE 4.10.0 起可以在输入框里新建自定义模型，但文档没有写这个界面的字段，本文以 models.json 为准。完整示例、Token 上限与能力标记：CodeBuddy 接入 Router One。
接不了或文档没写的：Comate、JoyCode 与各家插件
下面这些，按 2026-09-29 能查到的官方文档，要么填不了自己的地址，要么文档没写，要么只对 TRAE 企业版开放。「文档没写」不等于一定不行，只是没有可引用的依据；产品升级后请以新文档为准。
| 工具 / 形态 | 文档怎么写 | 结论（按官方文档，2026-09-29 核对） |
|---|---|---|
| 文心快码 Comate（百度） | 「模型」文档（2026-08-14 更新）列出可选的内置模型，并写明「企业用户还可以添加更多第三方模型提供商的API」 | 个人版文档没有自定义端点的说明；企业版按文档可以添加第三方模型提供商 |
| JoyCode（京东） | 「添加自定义模型」：选服务商（列表以「等」结尾）、选模型或填模型 ID、填 API 密钥 | 没有请求地址字段，文档未说明能否改地址；它的 VS Code 插件在 Marketplace 上写明「目前该插件主要服务于京东内部业务，暂未对外开放」 |
| TraeCode Plugin（VS Code / JetBrains，原 MarsCode 编程助手插件） | 插件文档（AI 功能、FAQ、更新日志）没有模型设置；TRAE 官方社区 2026-07-13 的一条答复称 VS Code 插件暂不支持添加自定义模型，只有独立的 TRAE IDE 支持 | 个人版按现有插件文档没有自定义模型入口；TRAE 企业版的模型文档写明，管理员开启成员自定义模型权限后，成员可以在 TraeCode Plugin 中添加自定义模型。插件文档的更新日志停在 2025-04-15，而 Marketplace 版本已到 1.7.9，升级后以新文档为准 |
| TraeCode CLI | 文档写明「仅 TRAE 企业版的旗舰版套餐客户可使用」；CLI 的模型文档介绍了在 trae_cli.yaml 中添加自定义模型（需管理员开启成员自定义模型权限） | 个人用户用不到；旗舰版可在 trae_cli.yaml 中配置自定义模型 |
| Qoder IDE、Qoder CN IDE | 个人版 BYOK 只接预置供应商（Qoder CN IDE 的文档写的是「接入供应商的 Coding Plan」） | 截至 1.32.0（2026-09-23）的更新日志没有提到自定义 Base URL |
| Qoder、Qoder CN 的 JetBrains 插件 | 2026-09-03 的更新日志写有「BYOK 支持配置自定义模型」 | 没有说明能否填自定义地址 |
| Qoder CN VS Code 插件（原通义灵码插件，Marketplace 版本 2.6.10） | 文档更新日志停在 v2.6.3（2026-07-01），没有 BYOK 条目；文档还写明，统一订阅的 Qoder CN 账号不支持登录 VS Code 插件 | 文档没有自定义模型的说明 |
| CodeBuddy 的 VS Code / JetBrains 插件 | 插件文档的「模型配置」只列内置模型；另有「自定义服务接入智能体」，接的是你自建的智能体服务，不是模型 API 地址 | 模型配置里填不了自定义地址 |
钱花在哪：IDE 积分与你的 Key
IDE 自己的计量和 Router One 的计费是两本账，各家文档对两者关系的写法并不一样：
- TRAE：国内版计费文档写明「仅调用 TRAE 内置模型时会消耗积分；调用自定义模型不会消耗积分」；国际版计费文档按美元额度（Dollar Usage）计量每次模型请求，没有提到自定义模型。
- Qoder / Qoder CN：自定义模型的费用由服务商 API 账户直接结算，不占用 Qoder Credits；Repo Wiki 例外。
- CodeBuddy：积分说明写的是「所有对话相关请求均需消耗积分」，没有单独说明自定义模型。
Router One 这一侧：工具用你的 Key 发出的每个请求，都按该模型的公示价格计费，并出现在控制台 → 日志里，可以看到模型、输入输出 Token、费用、状态、总耗时，以及产生过输出的流式请求的首字延迟（TTFT）。走内置模型的请求——Auto 模式、预置供应商、插件——根本不会到达网关，日志里也不会有，这是判断工具是否真在用你的模型最快的办法。Agent 循环会放大请求数：每一轮工具调用、每次重试、每次后台摘要都是一次单独的请求，所以请在控制台 → API 密钥里为每个工具单独创建一把 Key，并设置 maxSpend 上限：触顶后该 Key 的请求返回 HTTP 402，其他 Key 照常可用。
怎么选
- 想在 IDE 里两种协议都能用：TRAE 的 TraeCode。OpenAI 格式的条目覆盖全部模型，Claude 的 ID 也可以另建 Anthropic 格式的条目；国内版文档写明自定义模型不消耗积分。记得关掉 Auto 模式。
- 习惯把整件任务交给 Agent：Qoder 或 Qoder CN 桌面端。想让 GPT 系列走 Responses，就单独加一个 Responses API 条目。
- 在终端里工作、希望配置能进 git：CodeBuddy Code 的
models.json，记得设置relatedModels.lite，并把apiKey写成${ROUTER_ONE_API_KEY}，由 CLI 启动时解析（不要把明文 Key 提交进 git；CodeBuddy IDE 不解析这种引用）。其他终端 Agent 用同一把 Key 的写法，见 Goose、OpenCode、Qwen Code、Aider 横评和 Qwen Code 接入 Router One。 - 团队统一用 VS Code 或 JetBrains 插件：上表几款插件的个人版文档目前都没有自定义端点（TRAE 企业版例外：管理员开启成员自定义模型权限后，成员可以在 TraeCode Plugin 中添加自定义模型）；要在编辑器里接自己的 Key，可以看编辑器插件自带 Key 横评和 Cline、Cursor、Claude Code 对比。
- 用 Claude Code 或 Codex CLI：见 Claude Code 国内接入和 Codex CLI 国内使用。
到 router.one 为每个工具建一把 Key 并设上限；所有编程工具走同一个网关是总览，/integrations 列出全部接入指南。中国大陆可以直连网关，无需 VPN。换完配置之后工具仍然报连接错误，说明端点其实没有换掉，先看 API 连接排错，状态码对照见错误码页。
常见问题
国产 AI IDE 里，哪些能接自己的 API（自定义 Base URL）？ 截至 2026-09-29，按各家官方文档：TRAE 的 TraeCode（自定义模型，2026-04-14 起可填请求地址）、Qoder 与 Qoder CN 桌面端（0.1.8 起，个人版 BYOK）、CodeBuddy Code 与 CodeBuddy IDE（models.json 的 url）都能填你自己的地址和 Key；Qoder CLI 个人版从 1.1.50 起也可以，但向导字段文档没写全。文心快码 Comate 个人版文档只列内置模型，JoyCode 的文档没有地址字段，TraeCode 插件（TRAE 企业版除外）、Qoder IDE 与各家插件的文档都没有写自定义端点。
TRAE 插件（原 MarsCode 编程助手）能加自定义模型吗？ 个人版目前没有文档依据：TraeCode Plugin 的文档里找不到模型配置项，TRAE 官方社区 2026-07-13 的一条答复也称 VS Code 里的插件暂不支持添加自定义模型，只有独立的 TRAE IDE 支持。TRAE 企业版不同：企业版的模型文档写明，管理员开启成员自定义模型权限后，成员可以在 TraeCode、TraeCode Plugin 和 TraeWork 桌面版中自行添加自定义模型；TraeCode CLI 只对企业版旗舰版套餐客户开放，自定义模型写在 trae_cli.yaml 里。个人版要在 TRAE 里用自己的 Key，请用 TraeCode 的「设置 > 模型 > 添加模型 > 自定义模型」。
在这些 IDE 里用 Claude，选 OpenAI 格式还是 Anthropic 格式？ 两种在 Router One 上都能用：Claude 系列 ID 同时在 /v1/chat/completions 和 /v1/messages 上提供。TRAE 两种格式都有；Qoder 请选 OpenAI Compatible + Chat Completions API，因为 Anthropic Compatible 的拼接方式文档没写；CodeBuddy 的 models.json 只支持 OpenAI 格式。只有一条要避开：Claude 的 ID 不要放进 Responses 条目，/v1/responses 会在调用模型之前返回 HTTP 400。
用了自定义模型，还会消耗 IDE 自己的积分或 Credits 吗？ TRAE 国内版计费文档写明调用自定义模型不消耗积分，国际版计费文档没有提到；Qoder 与 Qoder CN 文档写明不占用 Credits，但 Repo Wiki 例外；CodeBuddy 的积分说明没有单独讲自定义模型。走 Router One 的请求按你这把 Key 计费，每条都能在控制台 → 日志中查到。
文心快码 Comate 能接第三方模型 API 吗？ 按 Comate「模型」文档（2026-08-14 更新），用户从内置模型中选择；文档写明企业用户还可以添加更多第三方模型提供商的 API。个人版文档没有自定义端点的说明；想用自己的 Key，可以换用本文里能填地址的几款工具。
一把 Router One Key 能同时给几个 IDE 用吗？ 能，同一把 Key 在本文每个工具里都有效。但建议每个工具单独一把 Key，并各设 maxSpend：Agent 循环请求多，某把 Key 触顶后返回 402，其他 Key 不受影响；控制台 → 日志也可以按 Key 筛选，分开核对每个工具花了多少。