# 在 Qoder 中把 Router One 添加为 OpenAI Compatible 自定义模型

> https://router.one/zh/integrations/qoder 的 Markdown 镜像，供 AI 助手与爬虫使用。Router One 是 OpenAI 兼容的统一 LLM API 网关。
> 最后更新：2026-09-27

Qoder 桌面端（官方文档也称 New Qoder）由 Qoder IDE 的 Quest 模式发展而来，2026-08-27 作为独立产品发布，与 Qoder IDE 并行提供。自 Qoder 0.1.8（2026-09-05）起，个人版 BYOK 支持填写自定义 Base URL：在「设置」→「模型」→「+ 添加」中打开「供应商」，「自定义」分组里有 OpenAI Compatible（可再选 Chat Completions API 或 Responses API）和 Anthropic Compatible。填入 https://api.router.one/v1、Router One Key 和精确的目录模型 ID 后，Qoder 的任务、Agent 和自动化都可以使用这些模型，费用由 Router One 按这把 Key 计费，不消耗 Qoder Credits。按 Qoder 0.4.2（2026-09-24）与 Qoder 自定义模型文档核对（2026-09-27）。

## 本指南适用于哪个 Qoder 产品

Qoder 旗下有好几款产品，模型各自单独配置。本指南针对 Qoder 桌面端：它的自定义模型文档写明了下文用到的每一个字段。按 Qoder 文档，自定义模型的费用由模型服务商的 API 账户直接结算（这里就是你的 Router One Key），不占用 Qoder Credits；Repo Wiki 使用固定模型、单独计费，会消耗 Qoder Credits，生成时会有提示。

| Qoder 产品 | 能否填自定义 Base URL | Qoder 文档说明 |
| --- | --- | --- |
| Qoder 桌面端（0.1.8 及以后） | 能 | 「设置」→「模型」→「+ 添加」→「供应商」→「自定义」：OpenAI Compatible（Chat Completions API 或 Responses API）或 Anthropic Compatible，再填「接口地址（Base URL）」、API Key 和 Model ID |
| Qoder CLI（1.1.50 及以后） | 能（据更新日志） | 1.1.50 更新日志（2026-09-11）：个人版用户可在 /model 的 Custom 页配置自定义 URL 端点的 BYOK 模型；CLI 文档只概述了向导流程，并要求不要在 settings.json 中手工配置 BYOK |
| Qoder IDE | 更新日志未提及 | BYOK 使用预置供应商；截至 1.32.0（2026-09-23）的 IDE 更新日志没有提到自定义 Base URL |

## 把 Qoder 配置到 Router One base URL

进入 Qoder 设置，在左侧导航栏选择「模型」。点「+ 添加」，打开「供应商」，在「自定义」分组中选择 OpenAI Compatible，首次测试时再选 Chat Completions API。「接口地址（Base URL）」填 https://api.router.one/v1，「API Key」填专用的 Router One Key，「Model ID」填 /models 上的精确 ID；同一接口要配多个模型时，点「添加 Model ID」。Qoder 界面给出的示例格式 https://api.example.com/v1 与 Router One 的 /v1 地址写法相同，不要在后面追加 /chat/completions 或 /responses。点「下一步」按下文设置模型能力，再点「校验并添加模型」：Qoder 会先验证连接，通过后才保存模型。之后这个模型会出现在任务、Agent 和自动化的模型选择器中：

`qoder-settings-models-custom`

```text
# Qoder 设置 → 模型 → + 添加 → 供应商 → 自定义
# Qoder Settings → Models → + Add → Provider → Custom
供应商 / Provider:            OpenAI Compatible
API:                          Chat Completions API   # Responses API：仅 GPT、DeepSeek V4、Grok 对话模型 / GPT, DeepSeek V4, Grok chat IDs only
接口地址 / Base URL:          https://api.router.one/v1
API Key:                      sk-your-router-one-key
Model ID:                     anthropic/claude-sonnet-5
添加 Model ID / Add Model ID: google/gemini-3.7-flash

# 下一步 → 每个模型的能力 / Next → capabilities for each model
显示名称 / Display name:                       Claude Sonnet 5 (Router One)
支持的上下文窗口 / Supported Context Windows:  不超过模型详情页的上下文窗口 / values up to the model page's context window
默认上下文窗口 / Default Context Window:       从已选值中选一个 / one of the selected values
视觉 / Vision:                                 仅当模型详情页列出图片输入时开启 / On only if the model page lists image input
思考模式 / Thinking Mode:                      首次校验时关闭 / Off for the first validation

# 校验并添加模型 / Validate and Add Model
```

## Chat Completions API 还是 Responses API：哪些 Router One ID 放在哪里

API 类型作用于整个接口条目，同一条目下添加的所有 Model ID 都按同一种方式调用。Router One 在 Chat Completions 上提供全部对话模型，在 Responses 上原生提供 GPT 系列、DeepSeek V4 的 ID 与 Grok 对话模型；每个模型的详情页都列出它支持的端点。Claude 与 Gemini 的 ID 请放进 Chat Completions 条目；GPT 的 ID 两种都可以，想让 Qoder 对它们走 Responses 时，再单独添加一个选 Responses API 的条目。Claude 系列 ID 发到 Responses 时，会在调用任何模型之前被拒绝，返回 HTTP 400 invalid_request_error：model '<id>' must be called via /v1/messages or /v1/chat/completions。「自定义」分组里还有 Anthropic Compatible，但 Qoder 文档没有说明它如何在 Base URL 后拼接 Messages 路径，因此本指南不给出这一项的填写值；Router One 在 Chat Completions 上同样提供这些 Claude 系列 ID。

| Qoder 条目 | 接口地址（Base URL） | 适用的 Router One 模型 ID | Router One 端点 |
| --- | --- | --- | --- |
| OpenAI Compatible + Chat Completions API | https://api.router.one/v1 | 全部对话模型：Claude、GPT、Gemini、Grok 与 DeepSeek 的 ID | POST /v1/chat/completions |
| OpenAI Compatible + Responses API | https://api.router.one/v1 | 详情页列出 POST /v1/responses 的 GPT 系列 ID（如 openai/gpt-5.5）、DeepSeek V4 ID 与 Grok 对话模型 ID | POST /v1/responses |
| Anthropic Compatible | 本指南不涉及 | Router One 的 Messages 端点提供 Claude 系列与 DeepSeek V4 ID；Qoder 的路径拼接方式文档未说明 | — |

## 模型能力设置：上下文窗口、视觉与思考模式

点「下一步」后，Qoder 会让你按模型服务商公布的能力完成设置；Router One 把这些能力写在每个模型的详情页上。这一步不能修改 Model ID；按 Qoder 文档，「编辑」只能更新模型使用的 API Key，之后要改这些设置，需要删除模型再重新添加：

- 显示名称：模型在 Qoder 选择器中显示的名称，例如 Claude Sonnet 5 (Router One)。
- 支持的上下文窗口与默认上下文窗口：只选不超过模型详情页上下文窗口的值（anthropic/claude-sonnet-5 为 1,048,576 tokens，openai/gpt-5.5 为 1,050,000，anthropic/claude-haiku-4.5 为 200,000）。默认值是任务开始时使用的窗口；窗口越大，长任务每次请求可带的输入越多，而每个输入 Token 都会计费。需要释放上下文空间时，可以在任务中输入 /compact 压缩，Qoder 也可能自动压缩。
- 视觉：只有模型详情页列出图片输入时才开启。
- 思考模式：验证连接时先关闭；之后再开启，只勾选模型支持的思考强度，并到控制台 → 日志确认请求仍然成功。
- 工具调用：Qoder 的 Agent 会调用工具，优先选详情页列出工具调用的 ID；其他 ID 先试一次工具调用。

## 在日志中核对 Qoder Agent 的请求

Qoder 的任务是一个 Agent 循环：规划、读取文件、调用工具、核对结果，循环中的每一次模型调用都是一次单独计费的请求。自定义模型也会出现在「自动化」的模型选择器中，用 Router One 模型运行的定时任务会在你离开时继续消耗费用。请给 Qoder 单独一把设了 maxSpend 的 Key：触顶后该 Key 的请求返回 HTTP 402，其他 Key 不受影响。Qoder 文档没有说明「校验并添加模型」是否会发出计费请求，添加后可到控制台 → 日志查看。之后运行一个小任务，按时间、模型和 request_id 找到对应请求：日志中可以看到 Token、花费、状态、总耗时，以及产生过输出的流式请求的首字延迟（TTFT）。

## Qoder 该填哪个模型 ID？

从 /models 页复制精确的模型 ID，保留大小写、连字符和版本后缀，不要用展示名称代替。打开该模型的详情页，核对支持的 API 端点、上下文窗口和工具调用等能力，再与 Qoder 当前选择的 provider 和功能对应。模型出现在目录里，不等于当前客户端能调用它的所有功能。建议为每个客户端或应用单独建 API Key，并设置 maxSpend 消费上限。

## Qoder 用的是哪种 API 协议？

OpenAI 兼容描述的是接口格式，不能据此推断 Chat Completions（/v1/chat/completions）、Responses（/v1/responses）和 Anthropic Messages（/v1/messages）可以互换。先核对工具当前版本、provider 配置和实际请求路径，再查模型详情与 API 兼容性事实页。一次普通对话成功，也不能证明服务端工具、历史状态或文件编辑功能都受支持。

## 在请求日志里核对 Qoder 的调用

先在 Qoder 发出一次简单文本请求，再到控制台 → 日志按时间、模型和 request_id 找到这条记录，核对 Token、花费、总耗时和状态码。成功后再分别验证流式输出、工具调用和多轮历史。失败时保留实际请求路径、完整错误消息及 request_id；没有对应日志时，先查客户端配置和网络，不能仅凭客户端报错认定是网关或上游故障。

## 常见问题

### 在 Qoder 里用 Router One 会消耗 Qoder Credits 吗？

模型调用不会。Qoder 文档说明，自定义模型的费用由模型服务商的 API 账户直接结算，不占用 Qoder Credits；接入 Router One 后，Router One 按模型公示价格对这把 Key 的每个请求计费。Qoder 点名的例外是 Repo Wiki：它使用固定模型、单独计费，会消耗 Qoder Credits，生成时会有提示。按 0.1.8 的更新日志，自定义 Base URL 是个人版 BYOK 的功能。

### Qoder CLI 或 Qoder IDE 能接入 Router One 吗？

Qoder CLI 可以填自定义 URL 端点：1.1.50 的更新日志（2026-09-11）写明，个人版用户可在 /model 的 Custom 页配置自定义 URL 端点的 BYOK 模型。CLI 文档只概述了这个向导，可选供应商以你账号实时展示的 BYOK 目录为准，因此本指南不给出 CLI 逐项的填写值；如果向导要求填 Base URL，Router One 的地址是 https://api.router.one/v1，上文的模型 ID 规则同样适用。请按 Qoder 文档的要求通过向导配置，不要在 settings.json 中手工填写。Qoder IDE 的 BYOK 使用预置供应商，截至 1.32.0（2026-09-23）的 IDE 更新日志没有提到自定义 Base URL。升级后请重新核对这两款产品。

### 「校验并添加模型」失败，应该查什么？

把接口地址与 https://api.router.one/v1 逐字比对，/v1 后面不要再带任何路径。确认 API 类型与模型 ID 匹配：Claude 系列 ID 放在 Responses API 下，会返回 HTTP 400，提示该模型必须走另一条路径；Gemini 的 ID 在 Responses 上同样不提供。401 表示 Key 缺失或错误，请重新复制并去掉多余空格；402 表示钱包余额或该 Key 的 maxSpend 已用完。Model ID 要从 /models 精确复制并保留前缀，例如 anthropic/claude-sonnet-5；gpt-image-2 这类图片生成 ID 不是对话模型。如果错误信息点名了某个参数，先关闭「视觉」和「思考模式」再试。

### Claude 模型要不要选 Anthropic Compatible？

本指南不涉及这一项。Qoder 文档只给出一个示例地址 https://api.example.com/v1，没有说明 Anthropic Compatible 如何在其后拼接 Messages 路径，仅凭文档无法确定 Router One 该填哪个值。Router One 在 Chat Completions 上提供 Claude 系列 ID，所以用 OpenAI Compatible + Chat Completions API、接口地址 https://api.router.one/v1，就能调用同样的模型。Router One 自己的 Messages 端点是 POST https://api.router.one/v1/messages，适用于 Claude 系列与 DeepSeek V4 ID。

### Qoder 能通过网关用哪些模型？

选用当前目录中同时支持 Qoder 所用端点和所需功能的模型。精确 ID、当前单价与能力以 /models 及模型详情为准；不要仅按 GPT、Claude 等系列名判断兼容性。客户端能列出模型，只说明它从自身配置或 GET /v1/models 读到了这个 ID，仍需验证实际调用。

### 能列出模型，但调用报 400 或 404，怎么办？

先记录实际请求路径和错误消息，再核对精确模型 ID。400 可能是参数、工具类型或模型与端点不匹配；404 可能是请求路径或资源不存在，不能直接判定模型下线。若错误提示 must be called via，按它指明的端点调整客户端 provider，或换用支持当前端点的模型。不要在所有工具里统一增删 /v1 或 /chat/completions。

### 中国大陆能直连吗？

能。网关在大陆可直连、无需 VPN，配置与全球环境完全一致。

### 报 401/402/403/429 怎么排查？

先到控制台 → 日志核对这条请求及错误消息。401 查 Key 是否传入和有效；402 查钱包余额与 maxSpend；403 查 Key 权限和访问限制；429 查请求频率、token 限额及上游限流，按错误来源处理。保留 request_id，再按错误码速查页逐项排查。

## 相关页面

- 全部接入指南：https://router.one/zh/integrations
- Qoder 的 API 错误排查：https://router.one/zh/llm-api-error-codes
- API 兼容性：端点与功能对照：https://router.one/zh/facts/api-compatibility.md
- Responses API 配置与限制：https://router.one/zh/codex-responses-api
- CodeBuddy 接入：https://router.one/zh/integrations/codebuddy
- Cline 接入：https://router.one/zh/integrations/cline
- Qwen Code 接入：可自填 base URL 的终端 Agent：https://router.one/zh/integrations/qwen-code
- 连接与 /v1 路径排查：https://router.one/zh/api-connection-troubleshooting
- 跨模型工具调用：https://router.one/zh/llm-tool-calling
- Qoder 官方文档：自定义模型：https://docs.qoder.com/zh/qoder/custom-models
- Qoder 更新日志（0.1.8：BYOK 自定义 Base URL）：https://docs.qoder.com/zh/release-notes/qoder
- Qoder 常见问题：Qoder 与 Qoder IDE 的关系：https://docs.qoder.com/zh/qoder/faq
- Qoder CLI 更新日志（1.1.50：自定义 URL 端点）：https://docs.qoder.com/zh/release-notes/qoder-cli
- Qoder CLI 官方文档：自定义模型：https://docs.qoder.com/zh/cli/custom-models
- 统一 LLM API 网关概览：https://router.one/zh/llm-api-gateway
- OpenAI 兼容 API：https://router.one/zh/openai-compatible-api
- API 文档：https://router.one/zh/docs
- 本页规范地址：https://router.one/zh/integrations/qoder
- 模型与每模型 token 价格：https://router.one/zh/models （markdown：https://router.one/zh/models.md ）
- 定价：https://router.one/zh/pricing
- API 文档（markdown）：https://router.one/zh/docs.md
- 公司事实（markdown）：https://router.one/zh/facts/company.md