配置教程 · 截至 2026-11-22

Cline v4.1.27 与 Roo Code 配置 Claude Opus 5.5 / Fable 5.2:双协议 Base URL 与多模型工作流

截至 2026-11-22,在 Cline(最新 v4.1.27)或 Roo Code 中调用 claude-opus-5-5、claude-fable-5-2 或 claude-sonnet-5-5,必须在 API Provider 选 Anthropic、勾选 Use custom base URL 并填入 https://api.qcode.cc/api(末尾不带 /v1);调用 gpt-6.2-sol、deepseek-v4.1-flash 或 glm-5.3 则选 OpenAI Compatible 并填入 https://api.qcode.cc/openai/v1,同一把 API Key 即可跑通「规划 + 执行」双模型工作流。

更新于 2026-11-22

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

#Cline v4.1.27#Claude Opus 5.5#Fable 5.2#双协议 Base URL

四个先要记住的值

v4.1.27

2026-11-21 发布:保存密钥自动刷新模型列表

Cline v4.1.27 于 2026-11-21 发布,保存 API Key 或 Base URL 后会自动刷新提供商模型列表,密钥被拒时直接在模型选择器内报错;read_files 也不再截断在 8k 字符,完整传至 2000 行或约 48k 字符上限。

/api

Anthropic 模式不加 /v1,OpenAI 兼容加 /openai/v1

Claude 5 全系必须走 Anthropic 提供商并勾选 Use custom base URL,填 https://api.qcode.cc/api(不带 /v1);GPT、DeepSeek、GLM 等走 OpenAI Compatible,Base URL 填 https://api.qcode.cc/openai/v1(无尾斜杠)。

$4 / $20

Opus 5.5 官方标价;Fable 5.2 为 $8 / $40

Anthropic 官方每百万 token 标价:claude-fable-5-2 输入 $8、输出 $40,claude-opus-5-5 输入 $4、输出 $20,claude-sonnet-5-5 输入 $2、输出 $10;OpenAI 的 gpt-6.2-sol 为 $2.00/$10.00,Z.AI 的 glm-5.3 为 $1.4/$4.4。

2026-05-15

Roo Code 官方仓库已归档,新模型需手填 ID

GitHub 仓库 RooCodeInc/Roo-Code 处于 archived: true 状态,最后推送日期为 2026-05-15,内置下拉菜单停留在旧清单;继续使用 Roo Code 需在自定义提供商中手填模型 ID,或改用持续迭代的 Cline。

为什么配完就报 400/401/404:协议路径与归档清单

截至 2026-11-22,VS Code 开发者在 Cline 与 Roo Code 里接入 claude-opus-5-5 与 claude-fable-5-2 时,最常踩中三个坑。第一是协议混用:把 Claude 模型 ID 填进 OpenAI Compatible(对应 /openai/v1)或在 Anthropic 自定义地址末尾多写 /v1,服务端直接拒收请求或返回路径错误。

第二是漏勾开关:Cline 的 Anthropic 设置页默认指向官方地址,必须手动勾选「Use custom base URL」再填自定义端点才会生效。第三是工具清单过时:RooCodeInc/Roo-Code 自 2026-05-15 后归档,预设下拉列表里没有 Claude 5.5、Fable 5.2 或 GPT-6.2 Sol,不手填精确模型 ID 就会触发「Model Not Found」。把 Anthropic 协议与 OpenAI Compatible 协议拆成两套配置后,就能按任务难度随时切换旗舰与轻量模型。

2026-11-21:Cline v4.1.27 落地三项关键修复

Cline 于 2026-11-21 发布 v4.1.27,直接影响自定义 Base URL 与大仓库编码的改动有三项。

  1. 1模型列表自动刷新与即时报错:官方更新日志原句为 "A provider's model list refreshes after you save its API key or base URL, and a failed refresh (such as a rejected key) shows as an error in the model picker."——保存密钥或地址后自动拉取列表,密钥失效会立刻在选择器里显示错误,不再静默卡住。
  2. 2文件读取上限放宽:read_files 返回给模型的内容不再被截断到 8k 字符,而是完整传递至工具自身上限(2000 行或约 48k 字符),读大型源码文件更省来回轮次。
  3. 3推理强度覆盖修复:推理强度(reasoning effort)下拉框现在如实显示新任务实际生效的档位并提供 Default 清除项,且关闭推理(None)已能正确传递给带 Model Configuration 覆写的自定义模型,解决了此前部分对话端点拒绝工具调用的问题。

三个关键时间点:Roo Code 归档、Cline v4.1.27 与双协议核对

2026-05-15

GitHub 官方仓库 RooCodeInc/Roo-Code 最后推送于 2026-05-15,并已标记为 archived: true。其内置模型清单停留在该时间点之前,下拉菜单默认不含 claude-opus-5-5、claude-fable-5-2 与 gpt-6.2-sol,继续留守 Roo Code 需要手动输入精确模型 ID。

2026-11-21

Cline 发布 v4.1.27:保存 API Key 或 Base URL 后自动刷新模型列表并在失败时于选择器报错,read_files 解除 8k 字符截断(完整传至 2000 行或约 48k 字符),同时修复推理强度覆盖与自定义模型工具调用问题,安全依赖 undici 也升至 7.30.1。

2026-11-22

双协议接入与官方价目核对:QCode 在售清单涵盖 claude-fable-5-2、claude-opus-5-5、claude-sonnet-5-5 及 gpt-6.2-sol、deepseek-v4.1-flash、glm-5.3、kimi-k3.1-pro,同一把 cr_ 密钥可在 Anthropic 与 OpenAI Compatible 两种模式下直接调用。

已核实配置事实 vs 常见误区与未公开项

已核实(Cline 官方文档与 v4.1.27 发布说明、GitHub 仓库元数据与各厂商官方价目页)

截至 2026-11-22 可逐条核对

  1. 1Anthropic 模式界面:Cline 设置里将 API Provider 选为 Anthropic、在 Anthropic API Key 填密钥,勾选 Use custom base URL 后填自定义地址;选中 Claude 模型后可在下方勾选 Enable Extended Thinking 开启扩展思考,官方说明按完整 thinking token 计费而不仅按摘要计费。
  2. 2OpenAI Compatible 界面:API Provider 选 OpenAI Compatible,填写 Base URL、API Key 与 Model ID,并可在 Model Configuration 自定义最大输出 token、上下文窗口、图像支持、工具调用及输入输出单价;常见排查提示含 "Invalid API Key" 与 "Model Not Found"。
  3. 3Cline v4.1.27(2026-11-21):保存密钥或地址自动刷新列表,read_files 上限放宽到 2000 行或约 48k 字符,compaction 不再对目录未收录的自定义模型退回基础摘要,取消或失败轮次的推理文本不再串入下一轮。
  4. 4Roo Code 状态:RooCodeInc/Roo-Code 已归档(archived: true,最后推送 2026-05-15)。
  5. 5各厂商官方每百万 token 标价:Anthropic 官方 API 中 Claude Fable 5.2 为 $8/$40(缓存读 $0.20)、Claude Opus 5.5 为 $4/$20(缓存读 $0.20)、Claude Sonnet 5.5 为 $2/$10(缓存读 $0.10);OpenAI 官方 Standard 档 gpt-6.2-sol 为 $2.00/$10.00(缓存读 $0.10);Z.AI 官方 GLM-5.3 为 $1.4/$4.4(缓存读 $0.26);DeepSeek 官方 DeepSeek-V4.1-Flash-1017 峰值输入 $0.3、输出 $1.2,非峰值输入 $0.15、输出 $0.6(缓存命中峰值 $0.006、非峰值 $0.003)。

常见误区与官方尚未公开的事项

以下误判常导致配置反复失败或账单偏差,请直接避开。

  1. 1「把 Claude 模型写进 OpenAI Compatible 一套地址全搞定」——错;Claude 5 全系必须走 Anthropic 协议端点 https://api.qcode.cc/api(不带 /v1),填进 /openai/v1 会直接报错或触发 Model Not Found。
  2. 2「Anthropic 自定义地址要加 /v1 才规范」——错;Cline 客户端会自动拼接请求路径,在 https://api.qcode.cc/api 后多加 /v1 会造成路径重复返回 404 或 400。
  3. 3「Roo Code 很快会发新版补齐 Opus 5.5 与 Fable 5.2」——官方仓库 RooCodeInc/Roo-Code 已处于 archived: true 状态,并无公开的后续版本发布计划,不要等待内置菜单自动更新。
  4. 4「在 Cline 里选 Claude Code 订阅模式和 API 模式体验完全一样」——Cline 官方文档明确提示,Claude Code 订阅模式使用订阅限额而非按 token 计费,响应可能无法逐 token 流式输出,且图片上传与提示词缓存均受限。
  5. 5QCode 各模型的实时执行单价不由上述厂商官方标价推导,请以 qcode.cc/models 实时清单为准。

全任务死磕旗舰单模型 vs 双协议「规划 + 执行」双模型分工

A:单模型到底(全流程用 Fable 5.2 或 Opus 5.5)

配置最省事,只建一套 Anthropic 端点即可覆盖读库、改代码与写单测;但批量机械修改、日志排查和模板代码同样按高阶模型消耗 token(Anthropic 官方标价 Fable 5.2 输入 $8/输出 $40,Opus 5.5 输入 $4/输出 $20),大仓库高频迭代时额度消耗快。

B:双协议分工(高难规划用 Claude 5.5/5.2,批量执行切 Sol / DeepSeek / GLM)

架构拆解、跨文件疑难重构与代码审查走 Anthropic 模式调 claude-fable-5-2 或 claude-opus-5-5;大批量样板修改、单元测试生成与常规迭代切到 claude-sonnet-5-5(Anthropic 官方 $2/$10)、OpenAI Compatible 下的 gpt-6.2-sol(OpenAI 官方 $2.00/$10.00)、glm-5.3(Z.AI 官方 $1.4/$4.4)或 deepseek-v4.1-flash(DeepSeek 官方峰值 $0.3/$1.2),同一把 API Key 几秒切换,兼顾推理上限与日常 token 成本。

五步配通:Cline v4.1.27 与 Roo Code 双协议配置步骤

  1. 1确认扩展版本:在 VS Code 扩展栏将 Cline 升级到 v4.1.27(2026-11-21 发布),即可获得保存后自动刷新模型列表与 read_files 48k 字符完整读取;仍在使用 Roo Code 的用户请直接跳到第
  2. 2与 第 ④ 步并手动输入模型 ID。② 配置 Anthropic 模式(跑 Claude 5 全系):点击 Cline 面板右上角设置图标,API Provider 选 Anthropic,在 Anthropic API Key 粘贴你的 cr_ 开头密钥,务必勾选 Use custom base URL 并填入 https://api.qcode.cc/api(中国大陆可选 https://asia.qcode.cc/api,北美/欧洲可选 https://us.qcode.cc/api,末尾不加 /v1)。
  3. 3选择 Claude 旗舰型号与思考选项:在 Model 选择 claude-opus-5-5、claude-fable-5-2 或 claude-sonnet-5-5;处理复杂架构任务时可按需勾选模型菜单下方的 Enable Extended Thinking,保存后在模型选择器确认无报错。
  4. 4新增 OpenAI Compatible 模式(跑执行模型):新建配置文件或切换 API Provider 为 OpenAI Compatible,Base URL 填入 https://api.qcode.cc/openai/v1(带 /v1 且无尾斜杠;大陆可用 https://asia.qcode.cc/openai/v1,北美/欧洲可用 https://us.qcode.cc/openai/v1),API Key 粘贴同一把 cr_ 密钥,Model ID 手填或选择 gpt-6.2-sol、deepseek-v4.1-flash、glm-5.3 或 kimi-k3.1-pro;如使用 Roo Code,可顺手在 Model Configuration 填入最大输出与上下文参数。
  5. 5发一条实测任务验证:先在 Anthropic 配置下让 claude-opus-5-5 或 claude-fable-5-2 阅读核心文件并输出重构清单,再切到 OpenAI Compatible 下的 gpt-6.2-sol 或 glm-5.3 执行批量改动与单测;若遇到 Invalid API Key 或 Model Not Found,按两套地址是否多写或漏写 /v1 逐项核对即可。

QCode 一把 Key 跑通双协议:免月费绑定与全球支付

QCode 是独立的 API 接入服务,与 Anthropic、OpenAI 等厂商无隶属关系。只需一把 cr_ API Key,即可在 Cline 与 Roo Code 中同时打通两套协议:Anthropic 模式填 https://api.qcode.cc/api(大陆可用 https://asia.qcode.cc/api,北美与欧洲可用 https://us.qcode.cc/api)调用 claude-fable-5-2、claude-opus-5-5、claude-sonnet-5-5 与 claude-haiku-5-5;OpenAI Compatible 模式填 https://api.qcode.cc/openai/v1(大陆可用 https://asia.qcode.cc/openai/v1,北美与欧洲可用 https://us.qcode.cc/openai/v1)调用 gpt-6.2-sol、gpt-6.2-astra、deepseek-v4.1-flash、deepseek-v4-pro、glm-5.3、glm-5.3-flash、kimi-k3.1-pro 与 qwen3.8-max,无需在多家平台分别开户换密钥,也不受固定订阅 5 小时滚动窗口硬锁。

按 token 计费,各模型实时单价统一以 /models 为准。不想包月?按量包 ¥26 起买一笔额度,7 天内用完为止;已有个人套餐的用户额度不够时买加油包。充值支持国际信用卡(Visa / Mastercard)、Apple Pay、Google Pay、支付宝、微信支付、俄罗斯本地银行卡与 СБП(及独联体银行卡),以及多网络 USDT 加密货币(支持 18 条网络,0% 平台手续费,通常数分钟到账,最长 12 小时)。

常见问题

为什么在 Cline 里填了 claude-opus-5-5 或 claude-fable-5-2 却报 400、401 或 Model Not Found?

通常是把 Claude 填进了 OpenAI Compatible,或在 Anthropic 地址末尾多写了 /v1,或漏勾 Use custom base URL。调用 Claude 5 全系必须在 API Provider 选 Anthropic、勾选 Use custom base URL 并填 https://api.qcode.cc/api(不带 /v1)。在 Cline v4.1.27 中,保存 API Key 或 Base URL 后会自动刷新模型列表,若密钥被拒(返回 401)或额度耗尽(按量包返回 402),直接在选择器与日志中就能定位。

Roo Code 菜单里找不到 Opus 5.5 和 Fable 5.2 怎么办?

可以直接在自定义提供商里手动输入精确模型 ID,或迁移到持续更新的 Cline v4.1.27。GitHub 仓库 RooCodeInc/Roo-Code 已处于 archived: true 状态(最后推送 2026-05-15),内置下拉清单停留在早先版本;在自定义提供商里按协议填好 Base URL 后,手填 claude-opus-5-5、claude-fable-5-2 或 gpt-6.2-sol、deepseek-v4.1-flash、glm-5.3 即可调用。

按量包会不会自动扣月费?7 天到期后原来的 Key 还能继续用吗?

不会自动扣月费,按量包是一次性额度,7 天有效、并发上限 5,到期后如需继续使用只需再买一个按量包即可在同一把 API Key 上恢复并累加额度(额度用尽返回 HTTP 402,到期返回 HTTP 401,购买后不支持退款)。注意个人套餐 Key 与按量包不同:个人套餐按月计期,到期后不能在原 Key 上续期,需重新开通换新密钥。

已有 Cline 或 Roo Code 的旧配置,切到 QCode 需要改代码或重装插件吗?

不需要改代码或重装插件,只需在设置面板替换两处字段。跑 Claude 时保留 Anthropic 提供商,勾选 Use custom base URL 填 https://api.qcode.cc/api 并换上 cr_ 密钥;跑 GPT-6.2 Sol、DeepSeek V4.1 Flash 或 GLM-5.3 时在 OpenAI Compatible 里把 Base URL 改为 https://api.qcode.cc/openai/v1 并填入同一把 cr_ 密钥,原项目会话与 MCP 工具设置不受影响。

开启 Enable Extended Thinking 或频繁读大文件时,token 和缓存怎么算?

Cline 官方文档明确说明,勾选 Enable Extended Thinking 后模型输出 thinking 块,账单按完整 thinking token 计费而不仅按摘要计费,且 Claude 支持提示词缓存以降低重复上下文开销;以 Anthropic 官方标价为例,claude-opus-5-5 与 claude-fable-5-2 缓存读取均为每百万 token $0.20。此外 Cline v4.1.27 已解除 read_files 的 8k 字符截断(完整传递至 2000 行或约 48k 字符),读大文件减少重复调用;QCode 自身按 token 计费,实时单价见 /models。

没有海外信用卡怎么充值?支持哪些付款方式?

QCode 支持支付宝、微信支付、国际信用卡(Visa / Mastercard)、Apple Pay、Google Pay、俄罗斯本地银行卡与 СБП(及独联体银行卡),以及多网络 USDT 加密货币(18 条网络,0% 平台手续费,人工链上核验,通常数分钟到账,最长 12 小时)。无需境外信用卡即可充值并购买按量包或个人套餐。

参考来源

Cline 发布说明 v4.1.27(github.com/cline/cline/releases/tag/v4.1.27,2026-11-21);Cline 官方 Anthropic 与 OpenAI Compatible 配置文档(github.com/cline/cline/blob/main/docs/provider-config,核对于 2026-11-22);Roo Code GitHub 仓库元数据(github.com/RooCodeInc/Roo-Code,archived: true,最后推送 2026-05-15);Anthropic API 定价页(platform.claude.com/docs/en/about-claude/pricing,核对于 2026-11-22);OpenAI API 定价页(developers.openai.com/api/docs/pricing,核对于 2026-11-22);DeepSeek API 定价页(api-docs.deepseek.com/quick_start/pricing,核对于 2026-11-22);Z.AI 定价页(docs.z.ai/guides/overview/pricing,核对于 2026-11-22)。

一把 cr_ Key,同时跑通 Claude 5.5/5.2 与执行模型

无需绑定固定月费,注册 QCode 创建 cr_ 密钥即可直接填入现有 Cline 或 Roo Code 的 Anthropic(https://api.qcode.cc/api)与 OpenAI Compatible(https://api.qcode.cc/openai/v1)配置,先买一笔 7 天有效的按量包试跑多模型工作流,各模型实时单价见 /models。

不确定从哪开始?

先试一周

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

每天都用

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