Cline VS Code 编程助手接入统一 API

先说结论:设置里的三个字段

在 VS Code 里打开 Cline 面板,点设置齿轮。API Provider 下拉选 OpenAI Compatible,填三个字段:Base URL https://api.kkaiapi.com/v1,你的 Key 填进 API Key,目录里精确的模型 ID 填进模型字段,比如 claude-sonnet-4-6。 因为 Cline 没法知道一个任意端点背后的模型能做什么,这个 provider 会暴露一批模型配置项,要如实填写:上下文窗口大小、最大输出 token、图片支持这类能力开关,还有可选的输入输出价格,让 Cline 自己的成本显示对得上真实情况。窗口和限额按模型文档填。保存之后,Agent 下一个任务就经网关跑,ID 随时能换,不影响你的工作流。

API Provider:  OpenAI Compatible
Base URL:      https://api.kkaiapi.com/v1
API Key:       sk-你的kkaiapi密钥
模型:          claude-sonnet-4-6

模型配置:      上下文窗口 + 最大输出 token
               按模型文档填写,
               只有真支持图片的 ID 才开图片支持

Cline 怎么用配置好的模型

Cline(约 65K GitHub 星标)是 VS Code 里的自主编程 Agent:读你的代码库、改文件、跑终端命令、对失败结果迭代,过程中设有人工审批关卡。这个循环对模型的要求有个特定的形状:文件树、diff、终端输出这类长上下文输入,工具调用和代码输出,一个任务里往往有很多轮。 OpenAI Compatible provider 把这个循环按标准 chat completions 发到你的 Base URL,模型 ID 按纯字符串传递。厂商对协议来说无所谓,这也是模型比较在这里能落地的原因:claude-sonnet-4-6、kimi-k2.7-code、gpt-5.3-codex-spark 是同一套三个字段背后可互换的后端,不是三套分别的供应商配置和三个厂商账号。 能力开关值得认真对待,因为 Agent 的行为依赖它们。Cline 会按你声明的东西做计划:开了图片支持会给一个可能不接受图片的模型发截图,虚报的上下文窗口会在长任务深处引发上下文截断的失败。按模型文档如实声明,不要按你的期望声明。

Plan 与 Act:两种模式,两个模型

Cline 把工作拆成 Plan 模式(探索代码库、制定策略,不动文件)和 Act 模式(执行)。API 配置跟着这个拆分走:打开"不同模式用不同模型"选项后,设置里会出现按模式分开的标签页,每个模式记住自己的 provider 和模型,随你切换模式自动跟着换。 这个拆分的经济账才是重点。Plan 模式是深度推理值回票价的地方:claude-opus-4-7 或 gpt-5.5 读代码库、写方案。Act 模式是很多轮快速工具调用去执行一个已经存在的方案,正好是 kimi-k2.7-code 或 claude-sonnet-4-6 的舒适区。因为两个模式都走同一个网关 Key 计费,这套搭配只是设置里的选择,不是一个多厂商项目。 issue 追踪里有个诚实的提醒:按模式选模型这个功能,和 OpenAI Compatible provider 搭配时有过一些粗糙的边角,包括有报告说 Act 模式悄悄沿用了 Plan 模式的模型。配好拆分之后,跑一个任务,在任务头部确认每个模式实际调用的是哪个模型,再看一眼用量日志;只有亲眼看到两个 ID 都出现过,才能把这个拆分当成验证过的。

Plan 模式:  claude-opus-4-7      (读、推理、定策略)
Act 模式:   kimi-k2.7-code       (执行、编辑、跑命令、迭代)

验证方法:跑一个任务,确认每个模式实际用的是哪个 ID,
再确认用量日志里两个 ID 都出现过

给 Agent 循环选编码模型

Agent 循环放大 token 消耗的方式是聊天从来没有的;一个 Cline 任务可能是几十次带着文件上下文的请求。这让模型选择变得可衡量:同一类任务在两个 ID 上跑一周,再看按模型的花费,以及你需要人工介入的频率。

• claude-sonnet-4-6 是 Act 模式工作的默认答案:工具调用可靠,diff 质量高,判断力足够从失败命令里恢复
• kimi-k2.7-code 是长 Agent 会话的走量选择;代码专精、速度快,价格适合 Cline 实际跑的多轮循环
• gpt-5.3-codex-spark 适合快速的定点修改和修测试的任务,单轮延迟决定了会话体验
• claude-opus-4-7 属于 Plan 模式里的难任务:架构改动、跨文件重构、需要看全局的调试
• gpt-5.5 是值得在你自己的代码库上、而不是跑分上和 Claude 做 A/B 的强通用模型

主力模型价格

价格按 kkaiapi 中文区实时价格计算,单位 ¥/1M tokens(输入/输出)。

Cline 专属的翻车点

任务深处出现失忆或截断行为,是上下文窗口声明的问题:按模型文档的真实窗口填写,记住 Cline 打包文件上下文很激进,虚报的窗口偏偏会在最大、最烦人的任务上出问题。 工具调用异常、编辑格式错乱,或者 Agent 光叙述不动手,通常是选的 ID 函数调用能力弱;切到 claude-sonnet-4-6 先把配置问题和模型选择问题分开。 硬错误的对应很清晰:鉴权问题查 Key 字段;模型不存在是 ID 拼写和 /v1/models 列表对不上;每个请求都 404 是 Base URL 漏了 /v1 或者重复了。provider 会在你给的 base 后面拼接路由路径。 按模式的坑值得再提一次,因为漏看它是真花钱的事:如果配了不同的 Plan 和 Act 模型,一定要在一个真实任务上验证两个 ID 分别服务了各自的模式。每次 Act 轮次都悄悄退回到贵的 Plan 模型,这种事用量日志当天就能抓到,信用卡账单要到月底才发现。

哪些人会把 Cline 接到一个网关上

• 想用 Claude 驱动 Agent、又不想开 Anthropic 官方账号的开发者,用预充值余额,起步不用卡
• 在自己真实代码库上对比编码模型的人,每个候选只是改一下模型字段
• 重度 Cline 用户,把贵的 Plan 模型和快速的 Act 模型搭配,长会话不失控又不牺牲规划质量
• 按开发者或按项目计量 Agent 花费的团队,用按 Key 的用量,不用去猜共享账单
• 已经在把终端和编辑器工具接进一个网关、想让 VS Code Agent 也用同一个 Key 和日志的开发者

验证接入与排查首个任务

先 curl 一遍模型列表和一次聊天补全,用你打算配置的精确 ID。两个都通过,说明网关这一侧没问题,剩下的症状都在 provider 设置里。 然后给 Cline 一个小而真实的任务,一个文件,目标清晰,看头几轮。干净的工具调用和合理的编辑说明 ID 和能力开关都对了。错误对应三个字段;奇怪的 Agent 行为对应模型选择或声明的能力。如果开了按模式选模型,这第一个任务也是验证拆分是否生效的验证跑。 任务跑起来之后,kkaiapi 控制台会显示每次请求的模型、token 数和花费。Agent 循环是消耗 token 最猛的用法,按 Key 的用量视图是把一周的 Cline 变成一个具体数字的地方,按模型、按天,如果拆了 Key 还能按模式。

curl -s https://api.kkaiapi.com/v1/models \
  -H "Authorization: Bearer $KKAIAPI_KEY" | head -50

curl -s https://api.kkaiapi.com/v1/chat/completions \
  -H "Authorization: Bearer $KKAIAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"kimi-k2.7-code",
       "messages":[{"role":"user","content":"ping"}]}'

常见问题