面向开发者的 Cline 上手教程，从安装到实战，教你用 VS Code 扩展和 CLI 完成编码任务。
Cline 是一个开源 AI 编程代理，运行在你的 IDE 和终端里。它适合想用 AI 辅助编码、又不希望被单一模型绑定的开发者。能帮你跨文件改代码、跑命令、做自动化，所有操作都经过你的审批。
Cline 不是简单的代码补全工具，而是一个能独立完成任务的代理。它读取你的项目结构，理解文件之间的关系，然后跨文件修改代码。它还能直接执行终端命令，比如安装依赖、跑测试、启动开发服务器。
为什么要用它？我总结了几点：
模型自由：Cline 不锁定任何一家 AI 提供商。你可以用 Anthropic 的 Claude、OpenAI 的 GPT、Google 的 Gemini，也可以用 Ollama 跑本地模型，甚至接任何兼容 OpenAI 的 API。
人机协作：默认情况下，Cline 的每次文件修改和命令执行都需要你批准。它把改动以 diff 形式展示，你可以逐行审查、修改或回退。
计划与执行分离：Plan 模式下 Cline 只探索和提问，不碰代码。你确认方案后切到 Act 模式，它才开始动手。
可扩展：通过插件或 MCP 服务器，你可以给 Cline 添加自定义工具，比如连接数据库、调用内部 API。
Cline 有几种形态：VS Code 扩展、JetBrains 插件、命令行工具（CLI）、网页看板（Kanban），以及一个 Node.js SDK。入门阶段，你只需要 VS Code 扩展或 CLI 就够了。
打开 VS Code，进入扩展市场，搜索“Cline”，找到由 saoudrizwan.claude-dev 发布的扩展，点击安装。安装后侧边栏会出现 Cline 图标。
如果你用 IntelliJ IDEA、PyCharm、WebStorm 或 GoLand，可以在 JetBrains Marketplace 搜索“Cline”安装。插件和 VS Code 版体验一致。
CLI 通过 npm 安装，需要先有 Node.js 环境。在终端执行：
npm i -g cline装完后验证一下：
cline --version如果提示找不到命令，检查 npm 全局 bin 目录是否在 PATH 里。
想用网页看板并行跑多个代理，可以安装 Kanban：
npm i -g kanban想自己构建 AI 代理或写插件，用 SDK：
npm install @cline/sdkCline 支持很多模型提供商。你需要准备对应提供商的 API Key，比如 Anthropic、OpenAI、OpenRouter 等。在 VS Code 扩展的设置面板里填入 Key，或通过环境变量传给 CLI。具体配置方式以官方文档 docs.cline.bot 为准。
打开一个项目文件夹，点击侧边栏的 Cline 图标，在输入框里输入：
给这个项目写一个 README.md，内容包括项目简介和启动方式Cline 会先扫描项目结构，然后生成 README 内容，并以 diff 形式展示。你点击“接受”后文件就创建了。整个过程不需要你手动写一行代码。
在终端里，进入你的项目目录，执行：
cline "列出当前目录下的所有文件"Cline 会调用 shell 命令并返回结果。这个例子虽然简单，但能验证 CLI 是否正常工作。
如果你想让 Cline 直接干活，可以试试：
cline "Run tests and fix any failures"它会自动运行测试，看到失败后修改代码，再重新跑测试，直到通过。每一步改动都会显示出来。
Cline 能同时修改多个文件。比如你输入“把用户接口的返回信息改成中文”，它会找到相关文件，逐个修改，并显示每个文件的 diff。
Cline 可以直接执行命令，比如：
cline "安装 lodash 并写一个使用它的示例"它会运行 npm install，然后创建示例文件。对于长时间运行的命令（比如 dev server），Cline 会在后台持续观察输出，发现编译错误或崩溃会主动处理。
在 VS Code 扩展的输入框上方有 Plan / Act 切换开关。Plan 模式下，Cline 只读代码、提问、给方案，不修改任何文件。你确认方案后切到 Act，它才开始执行。
在项目根目录创建 .clinerules 文件，写入你的编码规范，比如“所有函数必须写 JSDoc”“禁止使用 any 类型”。Cline 会自动读取并遵守这些规则。CLI、VS Code 扩展和 JetBrains 插件都会自动加载。
在设置里可以随时切换模型。比如从 Claude 切到 GPT，或连到本地 Ollama。不同模型对同一任务的表现会有差异，建议多试几个。
MCP（Model Context Protocol）是一种让 AI 工具连接外部系统的标准协议。你可以通过 MCP 服务器让 Cline 查询数据库、调用云服务 API。在 CLI 中，用 cline mcp 管理服务器。
Cline 支持多个代理协同工作。一个协调代理把任务拆分成子任务，分派给多个专业代理，每个代理有自己的工具和上下文。团队状态会持久保存，下次可以接着干。
示例：
cline --team-name auth-sprint "Plan and implement user authentication with tests"这个命令会启动一个名为 auth-sprint 的团队，规划并实现带测试的用户认证功能。
你可以让 Cline 按 cron 计划自动运行。比如每天早上 9 点生成 PR 摘要：
cline schedule create "PR summary" \
--cron "0 9 * * MON-FRI" \
--prompt "List all open PRs and their review status" \
--workspace /path/to/repo计划独立于终端会话运行，重启也不会丢失。
Cline 可以接入 Telegram、Slack、Discord 等，让你在聊天软件里指挥它。每个对话线程对应一个代理会话，支持权限控制。
连接 Telegram：
cline connect telegram -k $BOT_TOKEN连接 Slack（webhook 模式）：
cline connect slack --bot-token $SLACK_TOKEN --signing-secret $SECRET --base-url $URL无头（headless）模式指不需要人工交互，适合写脚本和集成到 CI 管道。你可以用管道把内容喂给 Cline，并拿到 JSON 输出。
git diff origin/main | cline "Review these changes for issues"cline --json "List all TODO comments" | jq -r 'select(.type == "agent_event" and .event.text) | .event.text'SDK 允许你注册自定义工具和生命周期钩子。比如创建一个部署工具：
import { Agent, createTool } from "@cline/sdk"
const deployTool = createTool({
name: "deploy",
description: "Deploy the current branch to staging.",
inputSchema: { type: "object", properties: { env: { type: "string" } }, required: ["env"] },
execute: async (input) => {
// your deployment logic
},
})
const agent = new Agent({ tools: [deployTool], /* ... */ })假设你有一个 Node.js 项目，测试挂了。你只需要在项目根目录运行：
cline "Run tests and fix any failures"Cline 会先执行 npm test，看到失败信息后定位到相关代码，修改后重新运行测试。如果还有问题，它会继续修，直到全部通过。整个过程你可以在终端看到实时输出。
打开你的 Web 项目，在 Cline 输入框里写：
实现用户登录接口，包括数据库模型、路由和前端表单，使用 JWT 认证Cline 会分析现有代码结构，创建模型文件、路由文件、前端组件，并安装需要的依赖。每个文件的改动都会以 diff 形式呈现，你可以逐个确认。
用定时任务功能，每天下班前自动扫描代码中的 TODO 和 FIXME：
cline schedule create "Daily health report" \
--cron "0 18 * * MON-FRI" \
--prompt "Scan the codebase for TODO and FIXME comments, summarize by module" \
--workspace /path/to/reponpm 全局安装需要写权限。如果遇到 EACCES，可以尝试用 sudo npm i -g cline，或者按 npm 官方文档配置全局目录。配置后记得把 bin 路径加到 PATH。
说明 API Key 不对或已过期。检查环境变量或 VS Code 设置里的 Key 是否正确。如果用的是 OpenRouter，确认账户有余额。
在 VS Code 中，确保你打开的是项目根目录，而不是单个文件。CLI 模式下，确认当前工作目录正确。如果项目里有大型二进制文件，Cline 可能会跳过。
VS Code 扩展的审批通知可能被系统拦截。检查 VS Code 的通知设置，或者看 Cline 面板里是否有待处理的请求。CLI 模式下，如果卡住，按 Ctrl+C 中断后重新运行。
某些长任务（如大型构建）可能超过默认超时时间。你可以在设置里调整超时时间，或者把任务拆分成小步骤。具体参数以官方文档为准。
Cline 把 AI 编程代理做成了开源、模型无关、可扩展的工具。你可以在 IDE 里交互使用，也可以在终端里跑自动化，甚至通过 SDK 构建自己的代理。它的审批机制让你对改动有完全控制，规则文件让 AI 遵循你的项目规范。
下一步建议：找一个你手头的小项目，用 VS Code 扩展让 Cline 完成一次小重构，比如重命名一个变量或添加一个单元测试。跑通之后，再尝试用 CLI 的 headless 模式接入 CI。遇到问题可以查阅官方文档 docs.cline.bot，或者去 Discord 和 r/cline 社区提问。
评论 (0)
暂无评论，来发表第一条评论吧