Skip to content

Cline

Cline(前身 Claude Dev)是开源的 VS Code 自主编码 Agent 插件,概念跟 Claude Code 类似,但跑在 VS Code 内。

关键优势:对第三方 API 中转支持远好于 Cursor,工具调用(read_file / write_to_file / execute_command)稳定,特别适合 agentic 工作流。支持 Claude / OpenAI / Gemini / 本地模型多 provider 切换。

学习曲线:需要理解 auto-approve 风险(Agent 可以自动跑 shell 命令),新手建议保留"Execute commands 手动确认"。

适合谁:用 VS Code 而不是 Cursor / 终端的开发者;想做长链路 agentic 任务但希望保留传统编辑器交互。

本教程:在 VS Code 里把 Cline 指向 claude-api.org,跑 Claude 或 GPT-5 系列。

VS Code 插件,开源的自主编码 Agent。比 Cursor 更灵活但学习曲线略陡。

推荐渠道

  • Claude 官方(不限客户端) (2.0x):Cline 默认推荐 Claude(工具调用更稳),稳定性良好。Claude 官方(仅限claude code) (1.4x) 会拒 Cline 客户端。
  • 低价claude (0.5x):价格最低,也接受 Cline,但质量 / 稳定性相对不稳定 — 能容忍偶发失败再选。
  • Claude sonnet 折扣 (0.5x):主用 Sonnet 想最便宜的话,sonnet 折扣组也接受 Cline,但仅限 Sonnet 系列模型
  • OpenAI:备用,GPT-5.4 也行但偶尔工具循环

安装

VS Code → Extensions → 搜 "Cline" → Install。

配置

点左边活动栏的 Cline 图标 → ⚙️ Settings:

text
API Provider:    Anthropic
API Key:         sk-你的key(绑 Claude 官方(不限客户端))
Model:           claude-sonnet-4-6
Anthropic Base URL:  https://claude-api.org
text
API Provider:    OpenAI Compatible
API Key:         sk-你的key(绑 OpenAI)
Base URL:        https://claude-api.org/v1
Model ID:        gpt-5.4

"OpenAI Compatible" 而不是 "OpenAI"

Cline 的 "OpenAI" provider 走特殊鉴权流程(要登 OpenAI 账号)。第三方中转必须选 "OpenAI Compatible"

验证

在 VS Code 打开任意项目,点 Cline 图标 → 发"列出当前目录的文件"。

如果 Cline 调用了 read_file 等工具并给出列表,接入成功。

进阶

上下文窗口设置

Cline 默认会读完整文件,长项目容易撞上下文上限。Settings → Context Window

  • Sonnet 4.6/4.7:填 200000(200K)
  • Opus 4.7:填 200000
  • Sonnet 4.7[1m](百万上下文):填 1000000,⚠️ 输入价格翻倍

auto-approve 开关

省事但危险。建议至少保留 Execute commands 需手动确认——Cline 会跑 shell 命令,自动批准等于把家给它了。

常见问题

一直 "Error: Connection error"

  • Anthropic Base URL 末尾不要加 /v1,写 https://claude-api.org 即可
  • 检查 Key 绑的渠道:跑 Claude 任务必须用 Claude 类渠道

工具调用一直循环

  • 切到 Claude 渠道(Anthropic 的 tool use 协议在 Cline 里最稳)
  • 如果必须用 GPT-5:用 OpenAI 渠道并在 Cline 配置中走 ChatCompletions(default),不要让 Cline 走 Responses API(工具语义不同)

任务跑一半余额不够

Cline agentic 任务一次可能消耗 $0.5–$5(含上下文重发)。建议钱包余额至少 $20 才开 agent 任务。

更多见 FAQ

本站为 API 反向代理服务,与 Anthropic / OpenAI / Google 无关联。