Skip to content

Cline (VS Code)

Cline 是开源的 VS Code 内 AI agent 插件,支持自定义 API endpoint。

安装

VS Code 扩展市场搜 Cline 安装。

配置 Shuro

打开 Cline 侧边栏(机器人图标)→ 顶部 ⚙️ → 「API Provider」选择 「Anthropic

字段
API ProviderAnthropic
API Key<您的 API Key>
Use custom base URL✅ 勾选
Custom Base URLhttps://shuro.vip
Modelclaude-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 ProviderOpenAI Compatible
Base URLhttps://shuro.vip/v1/v1
API Key<您的 API Key>
Modelgpt-5.5

推荐设置

Cline 设置面板的几个重要选项:

选项推荐值原因
Auto Approve个人项目可开,团队代码关控制 agent 自由度
Max Request Output Tokens8192太大浪费 token
Model Reasoning Effortmedium平衡速度和质量

常见问题

"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
  • 学习项目用免费模型

内容采用 CC BY-NC-ND 4.0 协议 · 禁止商业使用 / 禁止改编 / 禁止训练 AI 模型