Cline 自定义 Anthropic base URL 报 400:原因与修复
截至 2026-10-08,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)。本页按 Cline 官方 release notes 逐字说明原因、受影响版本与升级后的检查步骤。
更新于 2026-10-08
版本与字段速查
出问题的版本
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 的说明:Anthropic 提供商现在只把 server-side refusal fallbacks 选项发给 api.anthropic.com,Azure AI Foundry 等自定义端点曾以 400 拒绝它。
CLI 与桌面版的修复版本
两个版本都在 2026-10-07 发布,release notes 写了同一条修复:经自定义 Anthropic base URL 调 Claude 不再报 400。
400 从哪来
截至 2026-10-08,这个 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 把这个选项限定为只发给 api.anthropic.com,所以升级后自定义 base URL 不再收到它。受影响要两个条件同时成立:API Provider 选的是 Anthropic,并且勾选了 Use custom base URL。
官方 release notes 原文(2026-10-07)
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.」同一版本还修了别的:Kimi K3 等只接受特定推理档位的模型不再拒绝请求;模型回复没有可识别的结束原因时,Cline 会让它再续写一次,而不是当作已完成。
从出问题到修复
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 写了同一条修复。
已确认 vs 没有核实到的
已确认(官方 release notes 逐字可核)
以下都能在 Cline 官方 release notes 与 CHANGELOG 里逐字核到: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 写明 fallbacks 选项改为只发给 api.anthropic.com;CLI cli-v3.0.69 与桌面版 desktop-v0.0.44 写了同一条修复。QCode 一侧的写法出自 docs.qcode.cc 的 Cline 集成页:Claude 用 Anthropic 提供商,Use custom base URL 填 https://api.qcode.cc/api。
未证实与官方未写的
四件事本页不下结论:① 报错文字「fallbacks: Extra inputs are not permitted」只出现在 GitHub 用户报告里(Azure AI Foundry),官方 release notes 只写「400」,不同网关返回的文字可能不同。② 除了升级,官方没有给出其它临时办法,本页也不写非官方的变通做法。③ 本页不对 QCode 端点是否接受这个字段下结论;4.1.23 起 Cline 本来就不再把它发给 api.anthropic.com 以外的地址。④ QCode 的 Cline 文档按 VS Code 扩展 4.1.19 核实,4.1.23 的界面本页没有实测,以你的客户端为准。
两组对照:版本与提供商
4.1.22 对 4.1.23
4.1.22 让 Anthropic 提供商的请求带上 fallbacks 选项,自定义 base URL 也会收到;4.1.23 起只发给 api.anthropic.com,其它地址不再收到。所以只要你用的是自定义 base URL,就该升到 4.1.23 或更新;CLI 与桌面版分别看 cli-v3.0.69 与 desktop-v0.0.44。
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 与国产模型。
修复步骤
① 看版本:在 VS Code 扩展面板(Ctrl+Shift+X / Cmd+Shift+X)搜索 Cline,确认当前安装的版本;4.1.22 就是 release notes 点名的版本。② 升级到 4.1.23 或更新;用 CLI 的升到 cli-v3.0.69 或更新,用桌面版的升到 desktop-v0.0.44 或更新。③ 配置保持不变:API Provider 仍选 Anthropic,勾选 Use custom base URL 并填你的地址;用 QCode 时填 https://api.qcode.cc/api,不要写成 /api/v1/messages,也不要带末尾斜杠。④ 发一条消息验证。除了升级,官方没有给出其它临时办法。
在 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 起这个选项只发给 api.anthropic.com,自定义 base URL 不再收到。Cline CLI 对应 cli-v3.0.69,桌面版对应 desktop-v0.0.44,都是 2026-10-07 发布。
报错原文是什么?
官方 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 与 CHANGELOG.md(v4.1.22、v4.1.23、SDK v0.0.88 与 v0.0.91、cli-v3.0.69、desktop-v0.0.44 的发布说明),2026-10-08 抓取。用户报告:Cline GitHub issue #14816 与修复 PR #14834,同日抓取,只作现象参考。Cline 侧配置项名称:docs.cline.bot 的 Anthropic 提供商页。QCode 写法:docs.qcode.cc 的 Cline 集成页(最后核实 2026-09-18,按 VS Code 扩展 4.1.19)与接入点与 API 格式页(更新于 2026-09-25),均于 2026-10-08 抓取。
相关阅读
Cline 接 OpenAI 兼容 API 教程
完整配置:GPT 与国产模型走 OpenAI Compatible,Claude 走 Anthropic 提供商。
Claude Code 网关 400 报错修复表
Claude Code 经网关时的 400 与 beta 头报错,按版本号对照修复。
支持自定义 API 的 AI 编程工具:16 款对照
各工具的协议、配置位置与能否用 Claude。
本页版本号与引语核对于 2026-10-08,以 Cline 官方 release notes 与 QCode 文档为准,上游调整不另行通知。GitHub issue 里的报错文字是用户报告,不代表所有网关的返回。模型可用性以 /models 为准。