如何在 VS Code 里安装并使用 Cline:市场安装与第一次任务
从市场装上 Cline,接通提供商,然后只下一件能检查的仓库任务。
VS Code 已经打开仓库。你要一个会读文件、改文件、跑命令的助手,而且每一步都要你点头。官方扩展叫 Cline:从市场装上,配好接口,再下一件能检查的编码任务。
可检索的做法是 如何在 VS Code 里安装并使用 Cline:用扩展市场装官方扩展,在面板设置里选提供商并登录或粘贴密钥,然后在已打开的 git 文件夹里下一件有边界的任务。安装与授权以 docs.cline.bot 为准。
先装扩展,再配提供商
市场安装
按 Ctrl+Shift+X(Mac 用 ⌘⇧X)打开扩展视图,搜 Cline,点 Install。装完用活动栏图标,或命令面板里的 Cline: Open In New Tab。Windsurf / VSCodium 走 Open VSX,步骤相同。
提供商不是装饰
面板里点设置齿轮。API Provider 下拉框决定模型从哪来。没配好时,对话发不出去,仓库也不会被改。
| 路径 | 你要准备什么 | 适合谁 |
|---|---|---|
| Cline 记账 | 用 Google / GitHub / 邮箱登录,不必自己管密钥 | 想少配一步、按用量付 |
| ClinePass | 选 ClinePass,登录,按提示订阅 | 要固定月费的人 |
| 自带密钥 | 选 Anthropic、OpenRouter、OpenAI、Gemini 等,粘贴对应密钥并选模型 | 已有云厂商额度,或要跑本机 Ollama / LM Studio |
一遍走完:安装、接入、第一次任务
- 01从市场安装
确认装的是 Cline 扩展。装完打开 Cline 面板。若图标没出现,命令面板搜 Cline。
- 02配好提供商再说话
设置里选 API Provider。走 Cline 记账就 Sign In 完成 OAuth。走自带密钥就把密钥贴进对应字段并选模型。本机运行时要先自己把服务拉起来。
- 03只下一件有边界的编码任务
在已经是 git 仓库的文件夹里写清结果、目录、怎样算做成。Cline 会提议读文件、写文件或跑终端;每一步等你批准。不要把五件无关的活写进同一条。
- 04审完再留
读它改过的每个文件。拒绝越界的编辑和命令。测试自己跑。官方文档只保证工具回路,不保证补丁一次正确。
在 src/auth/session.ts 加守卫:缺少 user id
时返回 401。不要改 billing 目录。跑现有的
session 单测,失败就停。先列出要改的文件,
等我批准再写盘。
第一次任务常在哪里断
- 扩展装了,面板是空的
- 多数是提供商没配完。回设置完成登录或粘贴密钥,再选模型。
- 提示里没有边界
- Cline 会读得很宽。写明目录、测试、以及不许改的路径。
- 把提议的命令全点批准
- 终端命令能改仓库以外的东西。读命令再点。方向错了就停,不要在坏补丁上叠第二次。
先接通,再下一件任务,然后自己读文件。批准按钮不是审查。
密钥和额度在你这边
自带密钥的费用走云厂商账单。Cline 记账和 ClinePass 的价格以 app.cline.bot 为准。本教程不保证某家模型一定接得上。
两个人要对齐一次补丁再合入,把文件清单摊在同一页即可。用 oakmeet 开一间会过期的房:浏览器、空间码、不用注册。房间边界见 八人、大约一小时。
Cline 和 Cursor Agent 是一回事吗?
不是。Cline 是 VS Code 市场里的扩展,模型走你选的提供商。Cursor Agent 是 Cursor 编辑器自带的回路。两边都能改仓库,安装和账单分开。
一定要付费吗?
扩展本身从市场安装。对话要接上模型:Cline 记账、ClinePass,或你自己的密钥 / 本机运行时。现行说明看 docs.cline.bot。本页不售卖套餐。
密钥存在哪?
贴进 Cline 设置的密钥由 VS Code 密钥存储保管。官方排除里写过:清掉 IDE 密钥会导致反复重新登录。不要把密钥写进仓库。
第一次任务写多长?
一件能检查的事就够:一个文件或一个目录、一条测试、一条禁止改动的路径。做完再开下一件。