ZCode 自定义模型怎么设置？用自己的 API Key 接入 Claude、GPT 与国产模型（2026 年 11 月）

能。ZCode 官方《连接模型》文档写明，ZCode 支持把任何兼容 Anthropic / OpenAI 协议的模型服务添加为自定义服务商：Add Provider，填接口地址和 API Key，再用 Add Model 手动填模型 ID。截至 2026-11-10 按 ZCode CLI 0.17.1 实测，QCode 的三种协议都能直接调用：Anthropic 填 https://api.qcode.cc/api，OpenAI Chat 与 Responses 填 https://api.qcode.cc/openai/v1，Key 用 cr_ 开头的 QCode Key，按 token 计费，各模型单价见 /models。

桌面版：点对话框里的模型名，在模型选择器底部点「管理模型」（英文界面 Manage Models），进入 设置 -> 模型设置，再点左侧列表底部的 Add Provider；首次启动还没有可用模型时，欢迎页的「使用 API Key」也会进入模型配置。CLI：写 ~/.zcode/v2/provider_config.json，不是桌面版的 ~/.zcode/v2/config.json；地址字段是 api.baseUrl，不是 options.baseURL。官方 CLI 文档还写明，ZCODE_BASE_URL 与产品服务端点有关，不能把模型 API 地址填进去。

ZCode 的自定义服务商支持 Anthropic 协议，可以填 QCode 的 Anthropic 地址 https://api.qcode.cc/api，调用 Claude 型号；截至 2026-11-10 按 ZCode CLI 0.17.1 实测，claude-haiku-5-5 直接返回回复，claude-sonnet-5-5、claude-opus-5-5 也在 /models 上。Claude 型号只走这个地址；GPT 型号走 OpenAI 地址 https://api.qcode.cc/openai/v1。

Anthropic 不用带，OpenAI 要带。ZCode 源码在 Anthropic 地址不以 /v1 结尾时自动补 /v1，再由 SDK 补 /messages，所以填 https://api.qcode.cc/api（按源码，写成 https://api.qcode.cc/api/v1 也会落到同一个 /api/v1/messages）；OpenAI Chat 与 Responses 在地址后直接补 /chat/completions、/responses，所以填 https://api.qcode.cc/openai/v1。截至 2026-11-10 按 ZCode CLI 0.17.1 实测这三种填法都通过；末尾都不加斜杠。

CLI 支持 Responses：api.type 填 openai-responses、api.baseUrl 填 https://api.qcode.cc/openai/v1，截至 2026-11-10 按 ZCode CLI 0.17.1 实测可用（gpt-6.1-terra）。桌面版官方配置页列的是 Anthropic 与 OpenAI 两种协议，没有单列 Responses；桌面版用 GPT 型号时填 OpenAI 接口地址 https://api.qcode.cc/openai/v1。ZCode 文档列出的 API 类型里没有 Gemini；在 QCode 上可以用 Claude、GPT 与 GLM、Kimi、DeepSeek、Qwen 四个家族，型号见 /models。

按报错对照处理。返回 model_not_available_on_endpoint：Claude 型号被加到了 OpenAI 地址的服务商下，把 claude-… 型号放进地址为 https://api.qcode.cc/api 的那个服务商。选最高思考档返回 400 参数错误：官方写明部分第三方部署只接受 xhigh 及以下，改选 high 即可。404：常见原因是地址末尾多了斜杠，路径会变成 //v1/messages，照上文填 /api 与 /openai/v1。图片被去掉：官方例子里同一个 GLM 模型走 Anthropic 兼容接口可以保留图片，走 OpenAI Chat 兼容接口会按不支持图片处理；自定义模型应在模型配置里明确声明图片能力。