官方原文 · 截至 2026-11-10

Qoder 自定义模型 BYOK 怎么设置?能填 Base URL(2026 年 11 月)

截至 2026-11-10,Qoder 能用自己的 API Key(个人版):桌面端在 设置 → 模型 → 添加模型 的“自定义”分组选 OpenAI Compatible 或 Anthropic Compatible,填接口地址(Base URL)、API Key 和 Model ID;CLI 在 /model 的 Custom 页签按向导添加。据官方更新日志,2026-09-05 发布的 Qoder 0.1.8 起,个人版 BYOK 支持自定义 Base URL。接 QCode:Claude 选 Anthropic Compatible,填 https://api.qcode.cc/api;GPT 与国产模型选 OpenAI Compatible(Chat Completions API),填 https://api.qcode.cc/openai/v1;Key 用 cr_ 开头的那把。

更新于 2026-11-10

把这个工具接到 QCode 端点:一把 key 调 Claude、GPT 与国产模型。

#Qoder 自定义模型#Qoder BYOK#Qoder Base URL#OpenAI Compatible

官方来源里的四条事实

2 类接口

OpenAI 与 Anthropic 兼容

官方页写明自定义接口有 OpenAI Compatible 与 Anthropic Compatible 两类;选 OpenAI Compatible 后,再选 Chat Completions API 或 Responses API。

0.1.8

2026-09-05 起可自定义 Base URL

Qoder 0.1.8 的更新日志:个人版 BYOK 支持填写自定义 Base URL,可接入 OpenAI / Anthropic 兼容协议的模型服务。截至 2026-11-10,桌面端最新版本是 0.5.7(2026-11-09)。

设置 → 模型

桌面端入口

设置 → 左侧「模型」→「添加模型」,在「自定义」分组选接口类型,填「接口地址(Base URL)」、API Key 和至少一个 Model ID,再点「校验并添加模型」。

Credits

不占用 Qoder Credits

官方 FAQ:自定义模型的费用由服务商 API 账户直接结算,不占用 Qoder Credits;Repo Wiki 使用固定模型,仍会消耗 Credits。图片和视频生成暂不支持 BYOK 接入的模型。

Qoder 能用自己的 API Key 吗?

截至 2026-11-10,能。Qoder 官方自定义模型页写明,Qoder 支持通过 API 密钥接入第三方服务商的模型资源;CLI 页写“适用版本:个人版”,定价页也把“支持自有 API Key 接入(BYOK)”列在个人方案的体验版(Free)一栏。桌面端、CLI 和 QoderWork 三者不同。桌面端:设置 → 模型 → 添加模型,自定义接口填 Base URL、API Key 和 Model ID。CLI:输入 /model,切到 Custom 页签,选 Add custom model...,按向导添加。QoderWork:官方模型页列的是旗舰、高级、标准三档以及 Qwen3.7-Max、Qwen3.7-Plus,截至 2026-11-10 没有自定义模型入口;Qoder 下载页写明 QoderWork 将于 2027-09-05 正式停止运营,在此之前仍可正常下载使用,并建议提前迁移到内置数据导入工具的 Qoder 桌面版。国际站 qoder.com 与国内站 Qoder CN 的自定义步骤相同,区别在预置服务商的名单:Qoder CN 文档的预置名单里没有 OpenAI、Google、OpenRouter。

2026-09-05:Qoder 0.1.8 起个人版 BYOK 可自定义 Base URL

Qoder 0.1.8(2026-09-05)的更新日志标题是“BYOK 现已支持自定义 Base URL”,正文写个人版 BYOK 支持填写自定义 Base URL,可接入 OpenAI / Anthropic 兼容协议的模型服务。CLI 的 1.1.50 版(2026-09-11)更新日志写个人版用户可在 /model 的 Custom 页统一配置和管理自定义 URL 端点的 BYOK 模型;Qoder 官方 X 账号 2026-09-12 写道,从 v1.1.50 起 Qoder CLI 面向所有个人用户支持接入自定义模型,填入 Base URL、Model ID 和 API Key 即可连接。更早的 CLI 0.2.5(2026-04-29)更新日志已有“BYOK Custom URL”一条。截至 2026-11-10,桌面端最新版本是 0.5.7,CLI 是 1.1.86,均发布于 2026-11-09。

时间线

2026-04-30

Qoder IDE 0.16.0(IDE 与桌面端是两款产品)发布社区版(Community Edition),更新日志写社区版已开放 BYOK,支持接入阿里云百炼、Kimi、深度求索、智谱、MiniMax 等国内主流 MaaS 服务。

2026-09-05

Qoder 0.1.8:个人版 BYOK 支持自定义 Base URL,可接入 OpenAI / Anthropic 兼容协议的模型服务。

2026-09-11

Qoder CLI 1.1.50:个人版用户可在 /model 的 Custom 页配置和管理自定义 URL 端点的 BYOK 模型。

Qoder 官方写明了什么,还有什么没写清

官方文档写明的

① 桌面端“自定义”分组里有 OpenAI Compatible 与 Anthropic Compatible;选 OpenAI Compatible 后再选 Chat Completions API 或 Responses API。② 要填接口地址(Base URL)、API Key 和至少一个 Model ID;同一接口要配多个型号,点“添加 Model ID”。③ 官方原话:请填写模型服务商提供的准确 Base URL,Qoder 中展示的示例格式为 https://api.example.com/v1。④ “校验并添加模型”会验证连接,通过后才保存。⑤ 费用由服务商 API 账户直接结算,不占用 Qoder Credits。⑥ 图片和视频生成暂不支持 BYOK 接入的模型。⑦ CLI 页:不要在 settings.json 中手工配置 BYOK,请用 /model 的 Custom 向导。⑧ 添加失败时官方让你检查:Base URL 是否完整、协议和 API 类型是否匹配,Key 是否正确,Model ID 是否正确,余额是否充足,网络是否正常。⑨ 定价页把“支持自有 API Key 接入(BYOK)”列在个人方案的体验版(Free)一栏。

官方页面还没写清的

截至 2026-11-10:① 桌面端自定义模型页本身没有写适用版本;CLI 页写“适用版本:个人版”,桌面端更新日志写“个人版 BYOK”。② Qoder IDE 是同一家族里的另一款产品,它的自定义模型页只列预置服务商,并注明适用个人版用户;自定义 Base URL 是新版桌面端与 CLI 的功能。③ CLI 页没有逐项列出向导里的字段,并说可选服务商以向导实时展示的目录为准;自定义 URL 端点的说法出自更新日志和官方 X 帖。④ 文档没有按协议分别说明 Qoder 会在 Base URL 后拼哪段路径,只给了一个示例格式 https://api.example.com/v1;实际以“校验并添加模型”的结果为准。⑤ 社区有用户反馈试用结束后看不到自定义模型;官方定价页的体验版(Free)一栏列有 BYOK,CLI 页给的排查办法是确认当前账号和版本已开通 BYOK。

桌面端和 CLI 的入口

桌面端:设置 → 模型

点“添加模型”,在“自定义”分组里选 OpenAI Compatible 或 Anthropic Compatible,填 Base URL、API Key 和 Model ID,再点“校验并添加模型”。国内站 Qoder CN 的步骤相同。

CLI:/model → Custom

输入 /model,切到 Custom 页签,选 Add custom model... 并按 Enter,按向导依次选 Provider、模型类型、具体模型,填 API Key;验证通过后自动保存,选中后按 d 可删除。

Qoder 怎么用自己的 API Key、填 Base URL

① 从 Qoder 下载页装桌面端(macOS 12+、Windows 10+ 或 Linux)并登录;CLI 用 curl -fsSL https://qoder.com/install | bash(Windows PowerShell:irm https://qoder.com/install.ps1 | iex)。② 桌面端:设置 → 左侧“模型” → “添加模型” → 打开「供应商」,在“自定义”分组选 OpenAI Compatible 或 Anthropic Compatible;选 OpenAI Compatible 时再选 Chat Completions API 或 Responses API。③ 填“接口地址(Base URL)”、API Key 和 Model ID,按模型能力设好显示名称、上下文窗口、视觉和思考模式,点“校验并添加模型”,通过后在对话框里选这个模型。④ CLI:/model → Custom → Add custom model...,按向导走,不要手改 settings.json。⑤ Base URL 填模型服务商提供的准确地址,Qoder 展示的示例格式是 https://api.example.com/v1;文档没有按协议列出 Qoder 会拼接的路径,校验不通过时先对照服务商文档核对地址。

用 QCode 的 API Key 跑 Qoder

截至 2026-11-10,一把 QCode Key 同时提供 Anthropic 与 OpenAI 两种兼容接口,按 token 计费,各模型单价见 /models。Claude 选 Anthropic Compatible,Base URL 填 https://api.qcode.cc/api,Model ID 如 claude-sonnet-5-5、claude-opus-5-5。GPT 选 OpenAI Compatible 加 Chat Completions API,Base URL 填 https://api.qcode.cc/openai/v1,Model ID 如 gpt-6.1-sol;想用 Responses API 就选它,地址同样填 https://api.qcode.cc/openai/v1(QCode 的 /openai/responses 与 /openai/v1/responses 等价),配 GPT 型号使用。GLM、Kimi、DeepSeek、Qwen 走 Anthropic Compatible 或 OpenAI Compatible 的 Chat Completions API 都可以,如 deepseek-v4.1-flash、glm-5.3、kimi-k3、qwen3.8-max,型号 ID 以 /models 为准。地址末尾不加斜杠,填好后点“校验并添加模型”,以 Qoder 的校验结果为准;Anthropic Compatible 校验不通过时,把地址改成 https://api.qcode.cc/api/v1 再校验一次。三步开始:① 注册并充值(支持支付宝等主流支付方式);② 购买个人套餐或按量包,复制以 cr_ 开头的 API Key;③ 按上文填进 Qoder,QCode 文档 https://docs.qcode.cc/docs/ide/qoder 有同样的分步说明。不想包月?按量包 ¥26 起买一笔额度,7 天内用完为止。

常见问题

Qoder 能用自己的 API Key 吗?

能。官方自定义模型页写,Qoder 支持通过 API 密钥接入第三方服务商的模型资源;桌面端入口是 设置 → 模型 → 添加模型,CLI 入口是 /model 的 Custom 页签。CLI 页写适用版本为个人版。桌面端的自定义接口分 OpenAI Compatible 与 Anthropic Compatible 两类。接 QCode 的具体值见上文。

Qoder 的 Base URL 怎么填?

在“添加模型”的自定义接口里填“接口地址(Base URL)”,官方要求填模型服务商提供的准确地址,示例格式是 https://api.example.com/v1。接 QCode:Anthropic Compatible 填 https://api.qcode.cc/api,OpenAI Compatible 填 https://api.qcode.cc/openai/v1,末尾不加斜杠;Anthropic Compatible 校验不通过时改填 https://api.qcode.cc/api/v1 再试。校验不通过时,官方让先查 Base URL 是否完整、协议和 API 类型是否匹配,再查 Key、Model ID、余额和网络。

Qoder 用自己的 Key 还会消耗 Credits 吗?

官方 FAQ 的回答是:自定义模型的费用由服务商 API 账户直接结算,不占用 Qoder Credits。例外写在同一条里:Repo Wiki 使用固定模型,使用时会消耗 Qoder Credits,生成时会有提示。用 QCode 的 Key 时按 token 计费,各模型单价见 /models。

Qoder CLI 怎么添加自定义模型?

在 CLI 里输入 /model,切到 Custom 页签,选 Add custom model... 并按 Enter,按向导依次选择 Provider、模型类型、具体模型,填写 API Key 等信息;验证通过后自动保存,可立即切换。官方特别说明:不要在 settings.json 中手工配置 BYOK。没看到 Custom 页签时,先确认当前账号和版本已开通 BYOK。

QoderWork 能添加自定义模型吗?

截至 2026-11-10,QoderWork 的官方模型页列出旗舰、高级、标准三档以及 Qwen3.7-Max、Qwen3.7-Plus,没有自定义模型入口。Qoder 下载页写明 QoderWork 将于 2027-09-05 正式停止运营,在此之前仍可正常下载使用;Qoder 账号及积分可继续用于其他 Qoder 产品,官方建议提前迁移到 Qoder 桌面版,它内置数据导入工具,可导入任务记录、技能与记忆。要接自己的模型,用 Qoder 桌面端或 CLI 按上文添加。

Qoder 体验版(Free)能用自己的 API Key 吗?

能。截至 2026-11-10,Qoder 定价页把“支持自有 API Key 接入(BYOK)”列在个人方案的体验版(Free)一栏;Qoder 官方 X 账号 2026-09-12 也写,从 v1.1.50 起 Qoder CLI 面向所有个人用户支持接入自定义模型。没看到 Custom 页签或添加入口时,CLI 页的建议是确认当前账号和版本已开通 BYOK。另据官方通知(2026-09-04 发布),“轻量”(Lite)模型档位已于 2026-09-18 14:00(新加坡时间,UTC+8)从各端模型选择器下线;这是模型档位的调整,定价页的个人方案里仍有 Lite 方案。

资料来源

Qoder 官方:docs.qoder.com 的自定义模型页(中文、英文、日文)、CLI 自定义模型页、模型选择页、定价页、QoderWork 模型页和 Lite 档位下线通知,docs.qoder.cn 的自定义模型页,桌面端、CLI 与 Qoder IDE 的更新日志(changelog.qoder.com),qoder.com 下载页,以及 Qoder 官方 X 账号 2026-09-12 的帖子,均于 2026-11-10 读取。QCode:qcode.cc/models、qcode.cc/pricing、qcode.cc/pay-as-you-go 和 docs.qcode.cc 的接入端点页,2026-11-10 抓取。

用自己的 Key 跑 Qoder

一把 QCode API Key,在 Qoder 里用 Anthropic Compatible 接 Claude、用 OpenAI Compatible 接 GPT 与国产模型,按 token 计费,各模型单价见 /models。

不确定从哪开始?

先试一周

小包 ¥26($30 额度,7 天)

每天都用

体验版 ¥63/月,每天 $5 额度;每 $1 额度只要 ¥0.42,中包约 ¥0.79