在 VSCode 中使用 Cline
- VS Code 里的 AI 编程助手
- 原生支持 OpenAI 兼容端点
- 可以直接改工作区文件，适合重构类任务
第一步：获取 API Key
在 OAIRoute 控制台 创建。
Create one in the OAIRoute console.
第二步：安装并配置
在 VS Code 扩展市场搜索 Cline 安装。装好后点侧边栏图标，进入设置：
选 OpenAI Compatible。
填 https://api.oairoute.com/v1
你的 OAIRoute Key。
手动填模型 ID，例如 claude-sonnet-5-5。
Search for Cline in the VS Code marketplace and install it. Then click the sidebar icon and open settings:
Choose OpenAI Compatible.
Enter https://api.oairoute.com/v1
Your OAIRoute key.
Enter the model ID manually, e.g. claude-sonnet-5-5.
第三步：验证
在 Cline 面板里输入一段自然语言任务，例如「读取当前目录的 package.json，告诉我有哪些依赖」，看它是否能正常调用工具读取文件。
In the Cline panel, type a task in plain language, e.g. "read package.json in the current directory and tell me which dependencies it has", and see whether it can call tools to read the file.
适合的任务类型
Cline 的核心能力是「读文件 → 改文件 → 跑命令」，因此对模型的要求与纯对话不同：
| 任务 | 对模型的要求 |
|---|---|
| 局部改写 | 指令遵循好即可，小模型够用 |
| 跨文件重构 | 需要强工具调用与长上下文 |
| 排查报错 | 需要能读日志并定位 |
Cline 会连续发起多次工具调用。如果用按次计费的模型，一次任务可能消耗几十次请求。建议先拿小任务试，确认成本可接受再放量。
Cline's core loop is "read file → edit file → run command", so it demands more from a model than plain chat:
| Task | What the model needs |
|---|---|
| Localized edits | Good instruction following; a small model is enough |
| Cross-file refactoring | Strong tool calling and long context |
| Debugging errors | Ability to read logs and locate the cause |
Cline fires many tool calls in a row. With per-call pricing, one task can consume dozens of requests. Try a small task first and confirm the cost is acceptable before scaling up.
安全设置
Cline 默认每次修改文件都会请求确认。建议保留这个设置，特别是让它跑 shell 命令时。
在设置里可以调整：
- Auto-approve reads：自动批准读取，提高效率
- Auto-approve writes：自动批准写入，风险较高，建议关闭
- Auto-approve commands：自动批准命令，强烈建议关闭
By default Cline asks for confirmation on every file change. Keep it, especially when it runs shell commands.
Settings you can adjust:
- Auto-approve reads: approve reads automatically for speed
- Auto-approve writes: approve writes automatically — higher risk, best left off
- Auto-approve commands: approve commands automatically — strongly recommended to leave off
常见问题
一直卡在 "Thinking"
多为模型不支持工具调用。换用 claude-sonnet-5-5 或 gpt-4o-mini。
修改文件失败
检查工作区是否有写权限，以及 Cline 是否有该目录的访问授权。
成本比预期高
把任务拆小，一次只让它改一个文件。上下文越短，单次成本越低。
Stuck on "Thinking"
Usually the model doesn't support tool calling. Switch to claude-sonnet-5-5 or gpt-4o-mini.
File edits fail
Check whether the workspace has write permission and whether Cline is authorized for that directory.
Costs higher than expected
Break tasks into smaller ones, one file at a time. The shorter the context, the lower the cost per call.