Cline 自定义 Anthropic base URL 报 400:原因与修复
截至 2026-10-13,Cline 4.1.22 用自定义 Anthropic base URL(官方举例 Azure AI Foundry、企业网关)调 Claude 会报 400,原因是 4.1.22 开始在请求里发送一个只有 Anthropic 官方 API 接受的选项 fallbacks;修复办法是升级到 2026-10-07 发布的 4.1.23 或更新版本,CLI 与桌面版在同一天分别发了 cli-v3.0.69 与 desktop-v0.0.44,CLI 此后又发了 cli-v3.0.70(2026-10-08)与 cli-v3.0.71(2026-10-13)。本页按 Cline 官方 release notes 逐字说明原因、受影响版本与升级后的检查步骤。
更新于 2026-10-14
一把 Key 调用 Claude、GPT 与主流国产模型,按 token 计费,几分钟上手。
- 按 token 计费,实时单价见 /models
- 支付宝、微信支付、信用卡、加密货币均可付款
- 充值后自助开通、立刻生效
版本与字段速查
出问题的版本
2026-09-30 发布。4.1.23 的 release notes 写明:4.1.22 开始发送一个只有 Anthropic 官方 API 接受的选项。
修复版本(VS Code 扩展)
2026-10-07 发布,Fixed 一节写明:经自定义 Anthropic base URL 调 Claude 不再报 400。
被拒的那个选项
SDK v0.0.91(2026-10-07,与扩展 4.1.23 同一天发布)的说明:Anthropic 提供商现在只把 server-side refusal fallbacks 选项发给 api.anthropic.com,Azure AI Foundry 等自定义端点曾以 400 拒绝它。
CLI 与桌面版的修复版本
cli-v3.0.69 与 desktop-v0.0.44 都在 2026-10-07 发布,release notes 写了同一条修复:经自定义 Anthropic base URL 调 Claude 不再报 400。此后 CLI 又发了 cli-v3.0.70(2026-10-08)与 cli-v3.0.71(2026-10-13),桌面版又发了 desktop-v0.0.45(2026-10-08)。
400 从哪来
截至 2026-10-13,这个 400 的原因已由 Cline 官方写明:4.1.22 开始在 Anthropic 提供商的请求里带上一个只有 Anthropic 官方 API 接受的选项,你勾选 Use custom base URL 填了别的地址(第三方网关、中转服务也属于这一类)后,不认这个字段的端点就返回 400。
4.1.22 的 release notes 把这项改动写成「Direct Anthropic requests now use Anthropic's server-side refusal fallback.」;同日 SDK v0.0.88 的说明写明请求里带的是 anthropic.fallbacks: "default"。
4.1.23 起不再把这个选项发给自定义地址(同日的 SDK v0.0.91 写明它只发给 api.anthropic.com),所以升级后自定义 base URL 不再收到它。受影响要两个条件同时成立:API Provider 选的是 Anthropic,并且勾选了 Use custom base URL。
官方 release notes 原文(2026-10-07 至 2026-10-13)
4.1.23 的 Fixed 一节原文:「Claude through a custom Anthropic base URL (Azure AI Foundry, corporate gateways) no longer fails with a 400 error. 4.1.22 started sending an option only Anthropic's own API accepts.」同日的 SDK v0.0.91 写得更具体(下面这条引语略去原文里的代码格式标记):「The Anthropic provider sends the server-side refusal fallbacks option only to api.anthropic.com.
Custom endpoints such as Azure AI Foundry rejected it with a 400.」CLI 的 cli-v3.0.69(同日)写了同一件事:「Claude through a custom Anthropic base URL (Azure AI Foundry, corporate gateways) no longer fails with a 400 error」。
同一批版本还修了别的:Kimi K3 等只接受特定推理档位的模型不再拒绝请求;模型回复没有可识别的结束原因时,Cline 会让它再续写一次,而不是当作已完成。再往后的两版 CLI 改的是别的东西:cli-v3.0.70(2026-10-08)的原文包括「Refreshed the model catalog. Adds Claude Haiku 5.5.」,cli-v3.0.71 发布于 2026-10-13。
要注意 Cline 模型目录里的名字是 Cline 自己的显示名,不等于 QCode 的模型 ID;接 QCode 时 Model 按 /models 上的 ID 填,QCode 自 2026-10-09 起支持 claude-haiku-5-5。
从出问题到修复
Cline 4.1.22 发布,release notes 写明 Anthropic 直连请求开始使用 server-side refusal fallback。
GitHub 上有用户报告(issue #14816):升到 4.1.22 后,经 Azure AI Foundry 的自定义 Anthropic base URL 请求失败,端点返回 400「fallbacks: Extra inputs are not permitted」。
4.1.23 发布修复;CLI cli-v3.0.69 与桌面版 desktop-v0.0.44 同日发布,release notes 写了同一条修复。之后 CLI 又发了 cli-v3.0.70(2026-10-08)与 cli-v3.0.71(2026-10-13),桌面版又发了 desktop-v0.0.45(2026-10-08)。
已确认 vs 没有核实到的
已确认(官方 release notes 逐字可核)
以下都能在 Cline 官方 release notes 里逐字核到:4.1.22 于 2026-09-30 发布,Anthropic 直连请求开始使用 server-side refusal fallback;4.1.23 于 2026-10-07 发布,经自定义 Anthropic base URL(Azure AI Foundry、企业网关)调 Claude 不再报 400,原因写明是 4.1.22 开始发送一个只有 Anthropic 官方 API 接受的选项;SDK v0.0.91 写明这个选项改为只发给 api.anthropic.com;CLI cli-v3.0.69 与桌面版 desktop-v0.0.44 在同一天写了同一条修复;CLI 此后发到 cli-v3.0.70(2026-10-08)与 cli-v3.0.71(2026-10-13)。
QCode 一侧的写法出自 docs.qcode.cc 的 Cline 集成页(更新于 2026-09-25,最后核实 2026-09-18):Claude 用 Anthropic 提供商,Use custom base URL 填 https://api.qcode.cc/api。
未证实与官方未写的
四件事本页不下结论
- 1报错文字「fallbacks: Extra inputs are not permitted」只出现在 GitHub 用户报告里(issue #14816,端点是 Azure AI Foundry),官方 release notes 只写「a 400 error」,不同网关返回的文字可能不同。
- 2官方 release notes 给的处置就是升级到带这条修复的新版本;issue 里用户自述的变通做法不是官方口径,本页也不写。
- 3本页不对 QCode 端点是否接受这个字段下结论;4.1.23 起 Cline 本来就不再把它发给自定义地址。
- 4QCode 的 Cline 文档最后核实于 2026-09-18(依据 VS Code 扩展 4.1.19),更新版本的界面本页没有实测,以你的客户端为准;Cline 模型目录里的显示名也不等于 QCode 的模型 ID,接 QCode 时 Model 要按 /models 上的 ID 填。
两组对照:版本与提供商
4.1.22 对 4.1.23
4.1.22 让 Anthropic 提供商的请求带上 fallbacks 选项,自定义 base URL 也会收到;4.1.23 起不再把这个选项发给自定义地址,同日的 SDK v0.0.91 写明它只发给 api.anthropic.com。所以只要你用的是自定义 base URL,就该升到 4.1.23 或更新;CLI 与桌面版分别看 cli-v3.0.69 与 desktop-v0.0.44(都是 2026-10-07 发布),CLI 此后又发了 cli-v3.0.70 与 2026-10-13 的 cli-v3.0.71。
Anthropic 提供商 对 OpenAI Compatible
这条修复针对的是 Anthropic 提供商,改走 OpenAI Compatible 不是绕开它的办法:QCode 文档写明 OpenAI 兼容模式用不了 Claude,填 claude-* 会返回 model_not_available_on_endpoint。Claude 只能走 Anthropic 提供商(https://api.qcode.cc/api),OpenAI Compatible(https://api.qcode.cc/openai/v1)只配 GPT 与国产模型。
修复步骤
- 1看版本:在 VS Code 扩展面板(Ctrl+Shift+X / Cmd+Shift+X)搜索 Cline,确认当前安装的版本;4.1.22 就是 release notes 点名的版本。
- 2升级到 4.1.23 或更新;用 CLI 的升到 cli-v3.0.69 或更新(此后 CLI 又发了 2026-10-08 的 cli-v3.0.70 与 2026-10-13 的 cli-v3.0.71),用桌面版的升到 desktop-v0.0.44 或更新。
- 3配置保持不变:API Provider 仍选 Anthropic,勾选 Use custom base URL 并填你的地址;用 QCode 时填
https://api.qcode.cc/api,不要写成 /api/v1/messages,也不要带末尾斜杠。 - 4发一条消息验证。官方 release notes 给的处置就是升级到带这条修复的新版本;issue 里用户自述的变通做法不是官方口径,本页不写。
在 QCode 上
在 QCode 上用 Cline 调 Claude,文档给出的写法是:API Provider 选 Anthropic,API Key 填 QCode 密钥(cr_ 开头),勾选 Use custom base URL 并填 https://api.qcode.cc/api,Model 填 claude-sonnet-5(日常)或 claude-opus-5(难任务)。
截至 2026-10-08 实测:Base URL 填 https://api.qcode.cc/api 时,请求发到 /api/messages 与 /api/v1/messages 都返回 200,所以无论客户端在 Base URL 后接 /messages 还是 /v1/messages,这个地址都能用。北美与欧洲可改用 https://us.qcode.cc/api(洛杉矶)。
本页只讲这个 400;GPT 与国产模型走 OpenAI Compatible 的完整配置见「Cline 接 OpenAI 兼容 API 教程」。按 token 计费,各模型单价见 /models。
常见问题
Cline 4.1.22 用自定义 base URL 为什么报 400?
因为 4.1.22 开始在 Anthropic 请求里发送一个只有 Anthropic 官方 API 接受的选项。4.1.23 的 release notes 原文是「4.1.22 started sending an option only Anthropic's own API accepts.」,SDK v0.0.91 写明这个选项是 server-side refusal fallbacks,Azure AI Foundry 等自定义端点曾以 400 拒绝它。
怎么修?要升到哪个版本?
升级到 4.1.23 或更新版本(2026-10-07 发布)。4.1.23 起不再把这个选项发给自定义地址,你的自定义 base URL 也就收不到它。Cline CLI 对应 cli-v3.0.69,桌面版对应 desktop-v0.0.44,都是 2026-10-07 发布;CLI 在此之后还发了 cli-v3.0.70(2026-10-08)与 cli-v3.0.71(2026-10-13)。
报错原文是什么?
官方 release notes 只写了「a 400 error」,没有给出报错文字。GitHub 上有用户报告(issue #14816,端点是 Azure AI Foundry),返回的消息是「fallbacks: Extra inputs are not permitted」;这是用户报告,你的网关返回的文字可能不同。
不升级有临时办法吗?
官方没有给出。4.1.23 与 SDK v0.0.91 的 release notes 只写了修复本身,没有列出关闭这个选项的设置项;本页不写非官方的变通做法,建议直接升级。
改用 OpenAI Compatible 能绕开吗?
在 QCode 上调 Claude 不行。QCode 文档写明 OpenAI 兼容模式用不了 Claude,填 claude-* 会返回 model_not_available_on_endpoint;Claude 要用 Anthropic 提供商,Base URL 填 https://api.qcode.cc/api。GPT 与国产模型可以走 OpenAI Compatible(https://api.qcode.cc/openai/v1)。
升级后接 QCode 还报错,先查什么?
先按 QCode 文档核三处:API Provider 选的是 Anthropic;Base URL 只填到 /api,末尾没有多余的 /,也不要写成 /api/v1/messages;密钥以 cr_ 开头且复制完整。文档写明 401 通常表示路径正确、仅鉴权失败。主域名连接不稳定时,可以换备用节点,例如 https://us.qcode.cc/api。
信息来源
原因、受影响版本与修复:Cline GitHub 仓库的 Releases(v4.1.22、v4.1.23、SDK v0.0.88 与 v0.0.91、cli-v3.0.69、cli-v3.0.70、cli-v3.0.71、desktop-v0.0.44 与 desktop-v0.0.45 的发布说明),2026-10-13 抓取。用户报告:Cline GitHub issue #14816,同日抓取,只作现象参考。QCode 写法:docs.qcode.cc 的 Cline 集成页(更新于 2026-09-25,最后核实 2026-09-18,依据 VS Code 扩展 4.1.19)与接入点与 API 格式页,均于 2026-10-13 抓取;模型可用性另以 qcode.cc/models 与 Claude Haiku 5.5 指南页当天存档为准。
相关阅读
Cline 接 OpenAI 兼容 API 教程
完整配置:GPT 与国产模型走 OpenAI Compatible,Claude 走 Anthropic 提供商。
Claude Code 网关 400 报错修复表
Claude Code 经网关时的 400 与 beta 头报错,按版本号对照修复。
Cline v4.1.27 与 Roo Code 配置 Claude Opus 5.5 / Fable 5.2:双协议 Base URL 与多模型教程(2026-11)
截至 2026-11-22:Cline v4.1.27 与 Roo Code 调用 Claude Opus 5.5、Fable 5.2 选 Anthropic 填 https://api.qcode.cc/api(不加 /v1),执行模型选 OpenAI Compatible 填 /openai/v1,附 Roo Code 归档后手填 ID 技巧。
加密货币充值指南
9 种币、56 条网络,0 平台手续费购买 AI 编程 API 额度。
本页版本号与引语核对于 2026-10-13,以 Cline 官方 release notes 与 QCode 文档为准,之后的变化以官方页面为准。GitHub issue 里的报错文字是用户报告,不代表所有网关的返回。模型可用性以 /models 为准。