文档

Qoder

独立版 Qoder 桌面应用可在 Provider → Custom 下设置任意 Base URL。填写三个字段并手动输入模型 ID 后，Qoder 就能通过一个密钥调用 Claude 和 GPT——而它们都不在自己的模型目录中。

Qoder Settings → Models → + Add → Provider → Custom 需要 OpenAI 兼容的 Base URL、API Key 和手动输入的 Model IDs — 因此独立 Qoder 桌面应用可以访问 Claude 和 GPT，它们都不在自身目录中。

Qoder Settings → Models → + Add → Provider → Custom

Qoder Settings -> Models -> + Add -> Provider -> Custom

Provider              OpenAI Compatible     <- under "Custom", not a preset
API type              Chat Completions API  <- asked only for OpenAI Compatible
Base URL              https://api.kunavo.com/v1
API Key               sk-kn-...
Model ID              claude-sonnet-5       <- typed by hand
  Add Model ID        claude-opus-5
  Add Model ID        claude-haiku-4-5

Next ->
Display name              Kunavo · Sonnet 5
Supported Context Windows pick from what the model supports
Default Context Window    one of the values picked above
Vision                    on for models that take image input
Thinking Mode             on for reasoning models, then pick effort levels

Validate and Add Model

这是独立版 Qoder 应用，不是 Qoder IDE。“Qoder”是一系列分别编写文档的产品，只有独立桌面应用的文档说明了可使用任意端点：其自定义模型页面在 Custom 下提供 OpenAI Compatible 和 Anthropic Compatible；2026 年 9 月 5 日发布的版本说明 0.1.8 将此功能描述为“个人计划的 BYOK 现已支持为任何兼容 OpenAI 或 Anthropic 的模型服务设置自定义 Base URL”。Qoder IDE 的自定义模型页面只列出了具名提供商，且完全没有出现字符串 Base URL。如果你的屏幕上没有此字段，你可能打开的是另一个 Qoder 产品。

Base URL 需要保留 /v1 后缀。Qoder 页面要求“输入模型服务提供的完整 Base URL”，随后以 https://api.example.com/v1 展示其格式示例——因此，针对 OpenAI 兼容端点，该字段需要填写 /v1 根路径，而非不带路径的源站地址。这与 Anthropic 风格的客户端正好相反，后者需要填写 https://api.kunavo.com，并会自行追加路由。

Qoder 还提供 Anthropic Compatible 自定义提供商，Kunavo 也会返回 /v1/messages。其文档只发布了一个 Base URL 示例，没有说明各协议会追加哪个路由，因此无法据此确定该类型需要 https://api.kunavo.com 还是 https://api.kunavo.com/v1。上文的 OpenAI 兼容路径是 Qoder 自身示例所对应的格式；如果选择 Anthropic 类型，请预期需要尝试这两种格式。Qoder 自己的故障排查列表正是从这一点开始：“Base URL 是否完整，以及所选的兼容协议和 API 类型是否与端点匹配”。

Kunavo 未在 Qoder 中运行过会话。本页内容并非对该客户端进行的运行时测试：字段信息是根据下方所示日期的 Qoder 自有页面转录的，端点一侧则依据 Kunavo 已发布的接口。真正检查这组配置的是 Validate and Add Model 按钮；该检查在你的设备上运行，而不是在我们的设备上。

还没有密钥？创建 Kunavo 账户，创建一个密钥（以 sk-kn- 开头），并充值 $10 起——调用费用从该余额中扣除，失败的调用不会收费。随后，控制台会打开 Qoder 设置页面。

分步操作

在 /app/keys 创建密钥并复制——它只会显示一次。
打开 Qoder Settings，在左侧导航中选择 Models，然后点击 + Add。
打开 Provider，在 Custom 下选择 OpenAI Compatible——不要选上方列出的预设提供商。然后选择 Chat Completions API 作为 API 类型。
输入 Base URL、API Key 和至少一个 Model ID。Qoder 的文档没有说明此字段支持发现模型列表，因此请手动输入 ID；对于同一端点上的每个额外模型，点击 Add Model ID。
点击 Next，设置 Qoder 无法推断的能力：Display name、Supported Context Windows，以及从这些值中选择一个 Default Context Window；如果模型支持，还要设置 Vision 和 Thinking Mode 开关。
点击 验证并添加模型。Qoder 的模型选择器页面说明，添加后，“该模型即可用于任务、Agent 和自动化模型选择器”。

已于 2026年9月21日对照独立版 Qoder 应用的自定义模型页面检查。第三方设置会发生变化；如果这里的字段名称不再与你看到的内容一致，应以该页面为准，而不是本页。

这是简要版本。完整教程——包括模型选择、真实会话成本和失败模式——见 Qoder 与 Claude Code 对比——使用哪种 Qoder、哪个端点，费用又是多少。

调试客户端前先验证

一个请求即可确定故障来自端点、密钥还是配置文件。如果返回 JSON，则相同的基础 URL 和密钥可以在 Qoder 中使用。

# Settles whether a failure is the endpoint, the key, or the client.
curl -sS https://api.kunavo.com/v1/models \
  -H "Authorization: Bearer sk-kn-..."

字段中应填写哪个模型 ID

每个文本模型都可通过模型 ID 访问——实时列表见 GET /v1/models，包含价格的目录见模型页面。费率单位为每 1M token 的美元，格式为输入 / 输出。

模型 ID	Kunavo 输入 / 输出	它在 Qoder 中的位置
`claude-sonnet-5`	$1.40 / $7.00	任务和 Agent 选择器的默认工作模型
`claude-opus-5`	$3.50 / $17.50	大型重构；错误的计划所耗费的成本高于 token 费用
`claude-haiku-4-5`	$0.70 / $3.50	高频自动化运行；请求数量是主要成本
`gpt-5-6-sol`	$2.00 / $12.00	来自不同系列的第二意见，使用相同的密钥和端点

计费方式是从预付余额中按 token 扣费，无月费——参见计费。对于重复上下文——这正是编辑器或聊天客户端发送内容的大部分——提示缓存对账单的影响大于模型选择。

为什么你的 Qoder 可能没有 Base URL 字段

三个 Qoder 产品界面都记录了自带密钥功能，但只有其中一个记录了可由你指定的端点。这是决定你当前界面能否进行上述配置的关键，因此在修改配置文件前值得先确认——而 CLI 页面明确建议不要修改配置文件。

界面	文档是否说明支持自定义 Base URL？	其自有页面的说明
Qoder（独立应用）	是	`OpenAI Compatible` 和 `Anthropic Compatible` 位于 Provider 列表的 Custom 下，可设置 Base URL、API Key，并手动输入 Model ID。本页。
Qoder IDE	否	其自定义模型页面写道：“适用对象：使用 Individuals 计划的用户”，并列出了提供商：阿里云 Model Studio、DeepSeek、Z.ai、Kimi、MiniMax、Xiaomi MIMO。页面中没有出现字符串 `Base URL`。
Qoder CLI	文档页面中没有	在 `/model` 下有一个包含 `Add custom model...` 的 Custom 选项卡，但该页面没有记载 Base URL，并警告：“不要在 `settings.json` 中手动配置 BYOK”。

CLI 的情况令人困惑，因为它自己的版本说明与文档互不一致。2026 年 9 月 11 日的版本说明 1.1.50 写道：“个人版用户现在可以在 Custom 页面集中配置和管理使用自定义 URL 端点的 BYOK 模型”；而更新后仍保留的自定义模型页面描述的却是目录：“可用的提供商、模型和凭据字段由当前账户可访问的 BYOK 目录决定”。这两者以及 IDE 页面都规定该功能仅对 Individual 计划开放。因此，如果 Custom 选项卡不存在或没有端点字段，应检查账户所属计划，以及该账户的目录提供哪些内容——而不是检查配置文件；CLI 页面建议不要手动编辑配置文件，而且该文件会根据目录重新生成。

常见问题

如何向 Qoder 添加自定义提供商？

在独立版 Qoder 桌面应用中：打开 Qoder Settings，在左侧导航中选择 Models，点击 + Add，然后打开 Provider，并在 Custom 下选择“OpenAI Compatible”或“Anthropic Compatible”。对于 OpenAI 类型，还需选择 Chat Completions API 或 Responses API。输入 Base URL、API Key 和至少一个 Model ID；如需在同一端点上添加其他模型，使用 Add Model ID。点击 Next 后，设置 Display name、Supported Context Windows、Default Context Window、Vision 和 Thinking Mode，然后点击 Validate and Add Model。Qoder 会在保存前验证连接。

Qoder 的 Base URL 末尾需要加 /v1 吗？

对于兼容 OpenAI 的端点，需要。Qoder 的自定义模型页面要求输入模型服务提供的准确 Base URL，并以 https://api.example.com/v1 展示示例格式，因此该字段需要 /v1 根路径，而不是不带路径的源地址；Kunavo 的地址为 https://api.kunavo.com/v1。对于 Anthropic Compatible 类型，页面没有提供单独的示例，也没有说明会追加哪个路由，因此其文档无法确定这种情况；请先尝试 /v1 根路径，如果验证失败，再尝试不带路径的源地址。

为什么我的 Qoder 没有 Custom 选项卡或 Base URL 字段？

因为三个 Qoder 产品界面的 BYOK 规则各不相同。只有独立版 Qoder 桌面应用的文档说明可以使用任意 Base URL。Qoder IDE 的自定义模型页面列出具名提供商，完全没有提到 Base URL；Qoder CLI 页面则说明，可用的提供商、模型和凭据字段由当前账户可访问的 BYOK 目录决定。IDE 和 CLI 页面还都将该功能限制为 Individual 计划。如果缺少该字段，请检查当前打开的是哪个 Qoder 产品，以及账户计划和目录允许哪些功能——CLI 页面特别警告，不要在 settings.json 中手动配置 BYOK。

没有 Anthropic 账户，Qoder 能使用 Claude 模型吗？

可以通过自定义提供商实现；Qoder 的内置目录则是另一回事。其模型选择器页面列出 Qwen、DeepSeek、GLM、Kimi 和 MiniMax 模型，没有列出任何 Claude、GPT 或 Gemini 模型，因此自带密钥是文档说明的接入方式。此处的“OpenAI Compatible”指的是线上协议选择，而不是厂商选择：你输入的 Model ID 会在所配置的 Base URL 上解析；只要端点提供该模型，Claude ID 就能使用，而你持有的凭据属于该端点，并非 Anthropic。

Qoder 中的自定义模型仍会消耗 Qoder Credits 吗？

Qoder 的自定义模型页面说明，自定义模型费用直接计入你的提供商 API 账户，不会使用 Qoder Credits；例外是 Repo Wiki，因为它使用固定模型并单独计费，生成时会显示提示。Kunavo 这边的费用按 token 计，从预付余额中扣除，没有月费。另请注意，Qoder 对已保存自定义模型的 Edit 操作只会更新 API key；如果要更改 Base URL，必须删除该条目并重新添加。

Kunavo 在 Qoder 中测试过此配置吗？

没有。Kunavo 未在任何 Qoder 产品界面中运行过会话，本页也不是运行时兼容性报告：字段名称及其顺序是根据所示日期的 Qoder 自有自定义模型页面转录的，端点一侧则依据 Kunavo 已发布的 API。关键的检查在你的设备上运行——Qoder 的 Validate and Add Model 按钮会在保存前一并测试 Base URL、密钥和 Model ID；对相同的 Base URL 和密钥执行普通 curl 请求，则可判断故障出在端点还是客户端。