故障排查 · 截至 2026-10-13

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 计费,几分钟上手。

#Cline 4.1.23#Use custom base URL#400 报错#Anthropic 提供商

版本与字段速查

4.1.22

出问题的版本

2026-09-30 发布。4.1.23 的 release notes 写明:4.1.22 开始发送一个只有 Anthropic 官方 API 接受的选项。

4.1.23

修复版本(VS Code 扩展)

2026-10-07 发布,Fixed 一节写明:经自定义 Anthropic base URL 调 Claude 不再报 400。

fallbacks

被拒的那个选项

SDK v0.0.91(2026-10-07,与扩展 4.1.23 同一天发布)的说明:Anthropic 提供商现在只把 server-side refusal fallbacks 选项发给 api.anthropic.com,Azure AI Foundry 等自定义端点曾以 400 拒绝它。

cli-v3.0.69 / desktop-v0.0.44

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。

从出问题到修复

2026-09-30

Cline 4.1.22 发布,release notes 写明 Anthropic 直连请求开始使用 server-side refusal fallback。

2026-10-04

GitHub 上有用户报告(issue #14816):升到 4.1.22 后,经 Azure AI Foundry 的自定义 Anthropic base URL 请求失败,端点返回 400「fallbacks: Extra inputs are not permitted」。

2026-10-07

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. 1报错文字「fallbacks: Extra inputs are not permitted」只出现在 GitHub 用户报告里(issue #14816,端点是 Azure AI Foundry),官方 release notes 只写「a 400 error」,不同网关返回的文字可能不同。
  2. 2官方 release notes 给的处置就是升级到带这条修复的新版本;issue 里用户自述的变通做法不是官方口径,本页也不写。
  3. 3本页不对 QCode 端点是否接受这个字段下结论;4.1.23 起 Cline 本来就不再把它发给自定义地址。
  4. 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. 1看版本:在 VS Code 扩展面板(Ctrl+Shift+X / Cmd+Shift+X)搜索 Cline,确认当前安装的版本;4.1.22 就是 release notes 点名的版本。
  2. 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. 3配置保持不变:API Provider 仍选 Anthropic,勾选 Use custom base URL 并填你的地址;用 QCode 时填 https://api.qcode.cc/api,不要写成 /api/v1/messages,也不要带末尾斜杠。
  4. 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,接着用 Claude

Cline 选 Anthropic 提供商,Use custom base URL 填 https://api.qcode.cc/api,Model 填 claude-sonnet-5;按 token 计费,各模型单价见 /models。

不确定从哪开始?

先试一周

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

每天都用

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