Cline

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

推荐渠道

• Claude 官方：Cline 默认推荐 Claude（工具调用更稳）
• OpenAI 兼容：备用，GPT-5.4 也行但偶尔工具循环

安装

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

配置

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

配 Claude

API Provider:    Anthropic
API Key:         sk-你的key（绑 Claude 官方）
Model:           claude-sonnet-4-7
Anthropic Base URL:  https://claude-api.org

配 OpenAI

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 兼容 而不是 Codex Plus（Codex Responses API 工具语义不同）

任务跑一半余额不够

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

更多见 FAQ。