主题
Cline (VS Code)
Cline 是开源的 VS Code 内 AI agent 插件,支持自定义 API endpoint。
安装
VS Code 扩展市场搜 Cline 安装。
配置 Shuro
打开 Cline 侧边栏(机器人图标)→ 顶部 ⚙️ → 「API Provider」选择 「Anthropic」
| 字段 | 值 |
|---|---|
| API Provider | Anthropic |
| API Key | <您的 API Key> |
| Use custom base URL | ✅ 勾选 |
| Custom Base URL | https://shuro.vip |
| Model | claude-opus-4-7 |
Cline 用 Anthropic Provider
Cline 的 Anthropic 模式发请求到 /v1/messages,跟 Claude Code 同协议,base_url 不带 /v1。
也可以用 OpenAI 兼容模式
如果你想用 GPT 系列(gpt-5.5 / gpt-5.4)模型,切到 「OpenAI Compatible」:
| 字段 | 值 |
|---|---|
| API Provider | OpenAI Compatible |
| Base URL | https://shuro.vip/v1(带 /v1) |
| API Key | <您的 API Key> |
| Model | gpt-5.5 |
推荐设置
Cline 设置面板的几个重要选项:
| 选项 | 推荐值 | 原因 |
|---|---|---|
| Auto Approve | 个人项目可开,团队代码关 | 控制 agent 自由度 |
| Max Request Output Tokens | 8192 | 太大浪费 token |
| Model Reasoning Effort | medium | 平衡速度和质量 |
常见问题
"Invalid API key" 但 key 是对的
Cline 缓存 key。清空再填一次,或重启 VS Code。
模型下拉框没有 Claude 模型
Cline 的 Anthropic 模式有内置模型列表,不一定包含 claude-opus-4-7 这种新 ID。
解决:选 「Custom Model」 → 手动输入:
claude-opus-4-7一直 retry / 卡住
跟 Claude Code 的 retry 问题 一样的处理:
- 换 Haiku 测一下
- 检查 base_url 格式
- 关掉 Cline 设置里的 「Use streaming」 试试非流式
配置同步
Cline 配置存在 VS Code 工作区,不同项目可以用不同的 key/Provider。适合:
- 公司项目用账号 A
- 个人项目用账号 B
- 学习项目用免费模型
