# 在 Cline 中使用 OAIRoute
> VS Code 里的 AI 编程助手
> 原生支持 OpenAI 兼容端点
> 可以直接改工作区文件，适合重构类任务
## 第一步：获取 API Key
在 [OAIRoute 控制台](https://api.oairoute.com/keys) 创建。
## 第二步：安装并配置
在 VS Code 扩展市场搜索 `Cline` 安装。装好后点侧边栏图标，进入设置：
- `API Provider` (string / 必填) — 选 `OpenAI Compatible`。
- `Base URL` (string / 必填) — 填 `https://api.oairoute.com/v1`
- `API Key` (string / 必填) — 你的 OAIRoute Key。
- `Model ID` (string / 必填) — 手动填模型 ID，例如 `claude-sonnet-5-5`。
## 第三步：验证
在 Cline 面板里输入一段自然语言任务，例如「读取当前目录的 package.json，告诉我有哪些依赖」，看它是否能正常调用工具读取文件。
## 适合的任务类型
Cline 的核心能力是「读文件 → 改文件 → 跑命令」，因此对模型的要求与纯对话不同：
| 任务 | 对模型的要求 |
|---|---|
| 局部改写 | 指令遵循好即可，小模型够用 |
| 跨文件重构 | 需要强工具调用与长上下文 |
| 排查报错 | 需要能读日志并定位 |
> **Note:** 
> Cline 会连续发起多次工具调用。如果用按次计费的模型，一次任务可能消耗几十次请求。建议先拿小任务试，确认成本可接受再放量。
## 安全设置
Cline 默认每次修改文件都会请求确认。建议保留这个设置，特别是让它跑 shell 命令时。
在设置里可以调整：
- **Auto-approve reads**：自动批准读取，提高效率
- **Auto-approve writes**：自动批准写入，风险较高，建议关闭
- **Auto-approve commands**：自动批准命令，强烈建议关闭
## 常见问题
**一直卡在 "Thinking"**
多为模型不支持工具调用。换用 `claude-sonnet-5-5` 或 `gpt-4o-mini`。
**修改文件失败**
检查工作区是否有写权限，以及 Cline 是否有该目录的访问授权。
**成本比预期高**
把任务拆小，一次只让它改一个文件。上下文越短，单次成本越低。
**配置项{Configuration}**
```
API Provider
OpenAI Compatible
Base URL
https://api.oairoute.com/v1
API Key
sk-xxxxxxxxxxxxxxxx
Model ID
claude-sonnet-5-5
```
**验证端点{Verify endpoint}**
```
curl https://api.oairoute.com/v1/chat/completions \
  -H "Authorization: Bearer YOUR_OAIRoute_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"claude-sonnet-5-5","messages":[{"role":"user","content":"ping"}]}'
```
**核对模型{Verify model}**
```
curl https://api.oairoute.com/v1/models \
  -H "Authorization: Bearer YOUR_OAIRoute_KEY"
```