Cline 上手指南：从装 VS Code 到填好 API 跑起来

（说明：本文为公开资料收集整理，非官方说明，步骤可能随版本变动，使用前请自行核实。不引导你购买任何服务、不含任何返利链接。）

Cline 是 VS Code 上的开源 AI 编程扩展：你用大白话下指令，它读你的代码、改文件、跑命令、自己修报错。本篇只做一件事——带你从零装到能跑第一个任务，不评测、不对比。

需要什么（前置依赖）

Cline 本身是个扩展，跑起来只需两样：

1. VS Code（编辑器，Cline 寄生于它）。
2. 一个"大脑"= 大模型，二选一：

- 云端 API key：去 Anthropic / OpenAI / Google Gemini / DeepSeek 任选一家注册，拿一串 key（多数有免费额度，新手推荐 Google Gemini 免费档 或 DeepSeek）。

- 本地模型：装 Ollama，拉一个代码模型（如 qwen2.5-coder、deepseek-coder），零成本、不联网也能用，但要本机有点内存。

不需要显卡也能用（云端 key 方案不吃本地算力）；本地模型方案才会吃内存。

第一步：下载并安装 VS Code

1. 打开 https://code.visualstudio.com/
2. 点首页下载按钮，按你的系统选（Windows / macOS / Linux）。
3. 双击安装包，一路下一步装完，打开 VS Code。

第二步：安装 Cline 扩展

1. 在 VS Code 里按 Ctrl+Shift+X（Mac 是 Cmd+Shift+X）打开扩展商店。
2. 搜索框输入 Cline，找到作者为 cline 的那个（图标是蓝白小猫头），点 Install。
3. 安装完，左侧活动栏会出现 Cline 图标；也可以按 Ctrl+Shift+P（Mac Cmd+Shift+P）输入 Cline: Open In New Tab 打开。

第三步：填 API（在哪填、填什么）

打开 Cline 面板后：

1. 点面板顶部右侧的齿轮（设置）图标，或点模型/供应商那一栏。
2. 找到 API Provider（供应商） 下拉框，选你用的那家：

- 选 OpenAI / Anthropic / Google Gemini / DeepSeek 等 → 下方出现 API Key 输入框，把刚拿到的 key 粘进去，再选个模型，保存。

- 选 Ollama → 不用填 key，Cline 自动连本机 http://localhost:11434，从下拉里挑个已拉取的模型即可。

1. 也有个 Sign In 按钮：登 Cline 账号（cline.bot）能直接拿它家额度调一些前沿模型，适合不想管多家 key 的人。

填完 key 看到模型出现在输入框上方，就说明通了。

第四步：跑起来（第一个任务）

在 Cline 对话框里用大白话写一句，比如：

写一个 Python 的 hello world 脚本，并帮我运行它。

Cline 会：列出要做的步骤 → 创建/修改文件 → 执行终端命令 → 把运行结果回给你。每一步它都会等你在 VS Code 里点"批准"才动手（想全自动可在设置里开 auto-approve）。看到输出，就是跑通了。

国内最省方案：Cline 接 DeepSeek（附极简例子）

如果你在国内、想花钱最少，DeepSeek 是首选：价格低、对国内网络友好。Cline 官方支持 DeepSeek，DeepSeek 自己也有一份接入说明（官方文档在此：https://github.com/deepseek-ai/awesome-deepseek-agent/blob/main/docs/cline.zh-CN.md）。

1. 拿 DeepSeek 的 key

打开 https://platform.deepseek.com → 注册 → 左侧「API keys」→ 创建 → 复制那一串 key（只在创建时显示一次，存好）。

2. 在 Cline 里接上（官方给两种方式）

方式一（最直接）：回到本文第三步的 API Provider 下拉，直接选 DeepSeek → 把 key 粘进去 → 选个模型 → 保存。

方式二（OpenAI 兼容，最稳，文档主推）：API Provider 选 OpenAI Compatible →

• Base URL：https://api.deepseek.com
• API Key：你的 DeepSeek key
• Model ID：deepseek-chat（文档示例也给出 deepseek-v4-pro 等新版，以下拉里实际能选的为准；拿不准就选 deepseek-chat，最稳）

模型名会随版本变。官方文档当前示例用 deepseek-v4-pro 一类，但你下拉里实际出现的为准——能选上、能对话，就说明通了。

3. 一个特别简单的例子（从头到跑通）

1. VS Code 里装好 Cline（本文第二步）。
2. 打开 Cline 设置 → API Provider 选 DeepSeek（或按方式二填好三项）。
3. 粘好 DeepSeek key、选模型、保存。
4. 对话框输入一句话，比如：

> 帮我在当前目录新建一个 hello.py，里面打印「你好，DeepSeek」。

1. 点「批准」→ Cline 创建 hello.py → 你打开看到那行代码已经写好了。

到这里，Cline + DeepSeek 就跑通了。这就是最简的一条路：一个 key、一句话、点一下批准。

一个可抄的最小路径

装 VS Code → 装 Cline → 填 API key（或开 Ollama）→ 输一句话任务 → 点批准 → 跑通

照这四步，十来分钟就能让 Cline 替你写并运行第一段代码。

边界与注意

• key 别外泄：API key 等同你的账号余额，别截图发群里、别提交进代码仓库。
• 版本会变：Cline 迭代快，面板文案/位置可能和你看到的不完全一致，但"设置里选供应商、粘 key"这条主线不会变。
• 本地模型吃内存：Ollama 跑 7B/14B 代码模型，建议本机有 8G+ 空闲内存，否则会卡。
• 它是助手不是替身：复杂活要你把关——批准前看一眼它要改什么文件、跑什么命令。

小结（不替你选）

想零成本就走 Ollama 本地；想最省事就拿一个云端免费 key。本篇只管"装到能跑"，后续怎么用它干活，按需再探。