Cline：VS Code 内自主读写文件、执行命令与调用浏览器的开源 AI 编程 Agent｜部署与使用全指南

项目仓库： https://github.com/cline/cline

开源协议：Apache 2.0（© 2026 Cline Bot Inc.） · 交付形态：VS Code 扩展、JetBrains 插件、桌面应用、命令行 CLI、@cline/sdk · 模型接入：Anthropic / OpenAI / Gemini / OpenRouter / Bedrock / Vertex / Groq / Cerebras / Ollama / LM Studio / 任意 OpenAI 兼容接口 · 本地 Hub 面板默认端口 8787 · 官方文档：docs.cline.bot

非官方声明：Cline 是开源社区项目，与 Anthropic、OpenAI、Google 等模型厂商不存在隶属、授权或合作关系；文章中出现的模型与服务名称仅用于说明兼容目标。项目名称中的 “Claude” 仅对应早期扩展标识，不代表官方出品。API Key、订阅账号与模型服务条款由对应厂商约束，使用者须自行确认合规边界。

1 项目简介

Cline 是一款开源编程 Agent，同时提供 VS Code 扩展、JetBrains 插件、macOS / Windows 桌面应用、终端 CLI 与可二次开发的 SDK。在编辑器内，Cline 可以读取项目结构、跨文件协调修改、执行终端命令、浏览网页并调用 MCP 外部工具；每一次文件编辑与命令执行默认以人工审批（human-in-the-loop）方式确认，也可以开启自动批准进入自主运行状态。

1.1 核心信息一览

1.2 适用场景

• 在 VS Code / JetBrains 中让 Agent 完成“读懂现有代码 → 提出方案 → 改文件 → 跑构建与测试 → 修复报错”的完整循环，每步操作可审阅、可回滚。
• 在终端里用交互式 TUI 结对编程，或用无头模式把 Agent 接入 CI/CD、脚本与自动化流水线。
• 团队需要多个专项 Agent 并行协作、按 cron 定时跑代码评审 / 依赖检查 / 仓库健康报告。
• 通过 Telegram、Slack、Discord、Google Chat、WhatsApp、Linear 等聊天平台向 Agent 发任务，每个会话线程对应一个带完整上下文的 Agent 会话。
• 基于 @cline/sdk 二次开发自定义工具、多 Agent 团队与自动化集成。

1.3 能力边界（官方口径）

• 官方 README 自述定位为 “The open source coding agent in your IDE, terminal, & desktop”；工具能力包括创建文件、运行命令、浏览网页、调用 MCP 服务器，编辑以可审阅差异（diff）形式呈现，所有改动通过检查点（checkpoint）跟踪，可 /undo 回退。
• 模型不绑定单一厂商：可使用 Anthropic、OpenAI、Google Gemini、OpenRouter、Vercel AI Gateway、AWS Bedrock、Azure / GCP Vertex、Cerebras、Groq、Ollama、LM Studio 以及任意 OpenAI 兼容端点；具体模型可用性与计费由对应提供者决定。
• JetBrains 插件为官方市场分发的客户端，仓库中未开源 JetBrains 插件源码；桌面应用基于 Tauri 外壳、Bun sidecar 与 Next.js UI。
• Agent 能读写文件、执行命令并访问网络；审批策略、工作目录与工具白名单需要使用者自行约束，项目不提供绕过平台风控或保证代码安全的承诺。

2 功能特性

2.1 跨文件代码修改与检查点

• 读取项目结构与文件依赖关系，在多个文件之间做协调修改；工作过程中持续监听 linter 与编译器报错，在用户看到之前修复缺失导入、类型不匹配与语法错误。
• VS Code 与 JetBrains 中每次编辑都以 diff 展示，可审阅、修改或撤销；所有改动由检查点跟踪，需要回退时使用 /undo 回到之前的工作区状态。

2.2 计划模式与执行模式

• Plan 模式：先探索代码库、提出澄清问题、整理实施方案；与用户对齐后再切换到 Act 模式执行计划。
• 默认每个文件编辑与终端命令都需要人工批准；也可以切换自动批准，让 Cline 自主连续运行。

2.3 终端命令与长任务观察

• 直接在终端执行命令：安装依赖、跑构建脚本、执行测试、部署应用、管理数据库；开发服务器等长驻进程在后台继续运行，Agent 实时观察新输出，及时捕获编译错误、测试失败与服务崩溃。

2.4 规则与技能（.clinerules）

• 在项目中用 .clinerules 文件定义编码规范、架构约定、部署流程与测试要求；规则会被 CLI、VS Code 扩展与 JetBrains 插件自动读取。
• 通过技能（skills）让模型在需要时加载特定规则，扩展项目专属工作方式。

2.5 插件、MCP 与 SDK 扩展

• 基于 SDK 可以编程注册自定义工具与生命周期钩子，用于日志、审计、策略执行或领域专用能力；也可以通过 MCP 连接数据库、查询 API、管理云基础设施与外部系统。
• CLI 中用 cline mcp 管理 MCP 服务器；社区服务器可直接复用，也可以让 Cline 临时生成自定义工具。

2.6 多 Agent 团队与定时任务

• 团队模式：协调多个 Agent 协作完成复杂任务，协调者把工作拆成子任务分派给各专项 Agent；团队状态跨会话持久，可在历史基础上继续。
• 定时任务：按 cron 周期或外部事件触发 Agent 运行，例如每日 PR 摘要、每周依赖检查、仓库健康报告；调度配置跨重启保留，独立于终端会话存在。

2.7 聊天平台连接器

• 支持从 Telegram、Slack、Discord、Google Chat、WhatsApp、Linear 等平台与 Agent 对话；每个聊天线程映射为一个带完整上下文的 Agent 会话，可配置访问控制限制谁能与 Agent 交互。

2.8 无头模式与 CI/CD

• 零交互运行：管道输入、JSON 事件流输出、命令串联，直接接入 CI/CD 流水线；--json 输出 NDJSON 事件，便于下游工具按事件类型解析。

3 官方界面预览

3.1 CLI 终端界面

下图为官方 CLI README 中的终端界面截图：顶部为 ASCII 标识，底部状态栏显示 Plan / Act 切换、当前模型、工作区改动统计与自动批准状态。

3.2 编辑器内交互

VS Code 扩展中，对话面板展示 Agent 的思考、工具调用请求与文件 diff；Plan 模式下先给出方案，Act 模式下逐步执行，工具调用在批准后才落地到工作区。界面细节以安装版本为准，更多截图见官方文档 docs.cline.bot。

4 官方跳转链接汇总

5 前置要求与环境配置

5.1 软件前提

• VS Code：安装 VS Code 扩展使用；JetBrains 全家桶（IntelliJ IDEA、PyCharm、WebStorm、GoLand 等）安装 JetBrains 插件使用。
• Node.js / npm：仅在通过 npm 安装 CLI 时需要；CLI 分发给 macOS、Linux、Windows 的 arm64 与 x64 原生二进制，安装时不要求本机预装 Node、Bun 或 Zig 运行时。
• 模型凭据：Cline 账号 OAuth、ChatGPT 订阅（openai-codex），或 Anthropic / OpenAI / Google Gemini / OpenRouter / AWS Bedrock / GCP Vertex / Cerebras / Groq 等提供者的 API Key；本地模型可走 Ollama、LM Studio 或任意 OpenAI 兼容端点。
• Git：在真实代码仓库内工作，便于查看改动、提交与回退。

5.2 硬件与系统建议

5.3 端口与目录

6 方式一：VS Code 扩展与桌面应用（推荐日常使用）

6.1 安装 VS Code 扩展

1. 打开 VS Code Marketplace 的 Cline 页面，点击 Install 唤起 VS Code，再次确认安装。
2. 在侧边栏打开 Cline 面板，按引导登录 Cline 账号，或选择提供者并填入 API Key；也可以在后续设置中切换模型。
3. 打开项目文件夹，在对话输入框描述任务；Plan 模式先出方案，Act 模式逐步执行；每次工具调用按提示批准或拒绝。

6.2 安装 JetBrains 插件

1. 在 JetBrains IDE 中打开 Settings → Plugins，在 Marketplace 搜索 Cline。
2. 从 JetBrains 市场插件页 安装；扩展与 CLI 共享同一套 Agent 核心，Plan / Act、MCP、检查点、规则与模型配置行为一致。

6.3 安装桌面应用

前往 cline.bot/desktop 下载 macOS 或 Windows 原生安装包。桌面应用可以在任意文件夹中运行 Agent 会话、定时例程，并集中管理模型、插件与 MCP 服务器。

6.4 接入本地模型

在模型设置中选择 Ollama / LM Studio 或任意 OpenAI 兼容端点，填写本机服务地址（例如 Ollama 默认 http://localhost:11434）与模型名；本地模型不支持工具调用时，注意在设置中核对模型能力说明，必要时更换支持工具调用的模型。

7 方式二：命令行 CLI 安装与无头运行

7.1 安装 CLI

# 稳定版
npm install -g cline

# 夜间构建（需要最新功能时）
npm install -g cline@nightly

安装包按平台解析对应原生二进制，无需额外安装 Node / Bun / Zig 运行时。

7.2 交互式与单轮运行

# 交互式 TUI 多轮会话
cline

# 带开场提示的交互模式
cline -i "Let's work on this together. First, analyze the current state."

# 单轮任务后退出
cline "Audit this package and propose fixes"

# 管道输入
cat file.txt | cline "Summarize this"

7.3 模型提供者认证

# 交互式登录（Cline 账号 / ChatGPT 订阅 / OCA / 自带 API Key）
cline auth

# Cline OAuth 登录
cline auth cline

# 直接指定提供者、Key 与模型
cline auth --provider anthropic --apikey sk-... --modelid claude-sonnet-4-6
cline auth --provider openai-native --apikey sk-... --modelid gpt-5 --baseurl https://api.example.com/v1

OAuth 提供者（cline、openai-codex、oca）不会在普通启动时自动拉起浏览器，需要先显式执行 cline auth <provider> 完成登录；非交互运行时若选择了 OAuth 提供者且没有已保存凭据，CLI 会直接报认证错误，而不是弹出隐藏浏览器流程。

7.4 无头模式接入 CI/CD

# 单轮任务，自动批准全部工具
cline --yolo "Run tests and fix any failures"

# 管道传入 diff 做评审
git diff origin/main | cline "Review these changes for issues"

# NDJSON 事件流，供下游脚本解析
cline --json "List all TODO comments" | jq -r 'select(.type == "agent_event" and .event.text) | .event.text'

7.5 团队、定时任务与连接器

# 多 Agent 团队：同名团队跨会话延续
cline --team-name my-team "Plan, implement, and verify release checklist"
cline --team-name my-team "Continue yesterday's team workflow"

# 定时任务：工作日 09:00 评审昨日 PR
cline schedule create "Daily code review" \
  --cron "0 9 * * MON-FRI" \
  --prompt "Review PRs opened yesterday and summarize issues." \
  --workspace /path/to/repo \
  --timeout 3600 \
  --tags automation,review

cline schedule list
cline schedule get <schedule-id>
cline schedule trigger <schedule-id>
cline schedule history <schedule-id> --limit 20
cline schedule export <schedule-id> > daily-review.yaml
cline schedule import ./daily-review.yaml

# 聊天平台连接器
cline connect telegram -k $BOT_TOKEN
cline connect slack --bot-token $SLACK_BOT_TOKEN --signing-secret $SECRET --base-url $URL
cline connect slack --bot-token $SLACK_BOT_TOKEN --app-token $SLACK_APP_TOKEN
cline connect gchat --base-url https://your-domain.com
cline connect whatsapp --base-url https://your-domain.com
cline connect linear --api-key $LINEAR_API_KEY --base-url https://your-domain.com

# 停止连接器桥接与其会话
cline connect --stop
cline connect --stop telegram

7.6 从源码构建（开发者）

git clone https://github.com/cline/cline.git
cd cline

# apps/vscode      VS Code 扩展源码
# apps/cli         CLI 源码
# apps/examples/desktop-app  桌面应用源码
# sdk              @cline/sdk 源码
# 依赖安装、构建与调试命令以仓库 CONTRIBUTING.md 与各子目录 README 最新说明为准

8 配置项说明

8.1 常用命令行参数

8.2 顶层命令

8.3 MCP 服务器管理

# 交互式 MCP 配置向导
cline mcp
cline config mcp

# stdio 服务器：-- 之后为命令与参数
cline mcp install fs -- npx -y @modelcontextprotocol/server-filesystem /tmp

# 远程 HTTP / SSE 服务器
cline mcp install ctx7 --transport http https://mcp.context7.com/mcp
cline mcp install events --transport sse https://example.com/sse

MCP 向导需要 TTY 环境；远程服务器在保存前还会提示填写认证信息。

8.4 环境变量

8.5 工具审批与证书信任

• 默认自动批准工具；需要逐步确认时使用 --auto-approve false。TTY 模式下提示 Approve tool "<tool_name>" with input <preview>? [y/N]，输入 y / yes 批准，其他输入或回车拒绝；stdin / stdout 非 TTY 时，需要批准的调用会在终端模式下被拒绝。
• CLI 自动信任操作系统证书库：启动时收集系统受信锚点写入 ~/.cline/cli-node-extra-ca-certs.pem，并把运行时 NODE_EXTRA_CA_CERTS 指向该包；自行设置的 NODE_EXTRA_CA_CERTS 会与系统证书合并而非覆盖。

9 常用运维命令

# ---- 会话与状态 ----
cline history                    # 查看会话历史
cline doctor                     # 检查健康状态与残留进程
cline doctor fix                 # 清理残留 RPC 监听器与旧进程
cline doctor log                 # 打开运行日志
cline version                    # 查看版本
cline update                     # 检查更新

# ---- Hub 守护进程与面板 ----
cline hub                        # 查看 Hub 子命令
cline hub dashboard              # 启动浏览器面板（默认 8787）
cline hub dashboard --port 9090 --no-open   # 改端口且不自动打开浏览器

# ---- 定时任务 ----
cline schedule list
cline schedule history <schedule-id> --limit 20
cline schedule export <schedule-id> > backup.yaml
cline schedule import backup.yaml

# ---- 连接器 ----
cline connect --stop             # 停止全部连接器桥接
cline connect --stop telegram    # 停止指定平台

# ---- 数据目录 ----
# 默认 ~/.cline/data；隔离运行：
cline --data-dir /tmp/cline-sandbox "..."

日志默认位于 ~/.cline/data/logs/cline.log；需要保留诊断信息时先备份日志再清理。

10 常见故障排查

10.1 登录或认证失败

• OAuth 提供者必须先执行 cline auth <provider> 完成浏览器登录；非交互环境不要依赖启动时自动弹浏览器。
• API Key 同时受环境变量与 --key 影响，--key 优先级最高；检查 ANTHROPIC_API_KEY、OPENAI_API_KEY、OPENROUTER_API_KEY 等变量是否被旧值覆盖。
• 订阅登录优先级高于环境变量中的 Key：已登录订阅时，环境里的 API Key 不会被使用；需要切换到 Key 模式时先退出对应登录态。

10.2 非 TTY 环境工具被拒绝

在脚本、CI 或后台会话中，需要人工批准的工具调用会被直接拒绝；明确场景使用 --yolo 或 --auto-approve true，并先在受信任目录内完成工具白名单与权限评估。

10.3 MCP 服务器连不上

• 用 cline mcp 重新核对传输方式（stdio / http / sse）、命令参数与 URL；stdio 命令以 -- 之后内容为准。
• 远程服务器检查认证头 / Token 与网络可达性；公司代理环境确认证书包已合并系统根证书。

10.4 端口被占用或面板无法访问

Hub 面板默认 8787，冲突时用 cline hub dashboard --port <其他端口> 启动；局域网或隧道访问时参考 cline hub 配置中的 --host、--public-url、--room-secret 选项，不要在未设置密钥的情况下把面板暴露到公网。

10.5 残留进程或状态异常

执行 cline doctor 检查本地 CLI 健康状态与残留 RPC 监听器；确认无正在运行的重要会话后，用 cline doctor fix 清理残留进程。

10.6 模型不支持工具调用或报错

• 切换到官方文档列出的支持工具调用的模型；本地模型在模型设置中如实填写能力边界。
• 上下文过长时使用 --compaction basic 或调整压缩策略；连续内部错误超过 --retries（默认 3）会中止运行，可在调试时调大重试次数观察日志。

10.7 证书与内网代理

CLI 已自动合并系统证书；若仍报 TLS 错误，确认公司根证书已导入系统证书库，必要时设置 NODE_EXTRA_CA_CERTS 指向自定义 CA 文件，该文件会与系统包合并。

11 风险与合规说明

以下条款整理自官方 README、Apache 2.0 许可证与官方文档口径；如与官方原文不一致，以仓库 LICENSE、README 与 docs.cline.bot 为准。

11.1 开源协议

Cline 开源代码采用 Apache 2.0 许可证，允许自由使用、修改与再分发，修改文件需保留版权声明与许可证副本；第三方模型、MCP 服务器与连接器各自遵循其对应许可与服务条款。

11.2 模型与数据隐私

• 项目不提供模型、API Key 与订阅账号；Anthropic、OpenAI、Google、OpenRouter、Bedrock、Vertex、Groq、Cerebras 等服务归对应厂商所有，受其条款、隐私政策与计费规则约束。
• 代码、文件路径、终端输出与上下文会按所选模型发送到对应服务；敏感仓库优先使用本地模型与离线端点，不要把商业机密代码粘贴到不受信任的第三方会话中。

11.3 自主执行风险

• Agent 可以创建 / 修改文件、执行命令、访问网络并调用外部工具；--yolo、--auto-approve 与后台 Zen 模式会跳过人工审批，误操作可能覆盖代码、删除文件或泄露凭据。
• 建议在 Git 仓库内工作、保留检查点、限制工作目录与工具白名单；定时任务与聊天连接器上线前先做小范围测试，并配置访问控制。

11.4 商业使用与免责

Apache 2.0 不限制商业场景使用，但把 Cline 集成进商业产品时须同时满足各模型提供者与第三方组件的许可要求。项目按现状（AS-IS）提供，不保证模型输出正确、不保证平台兼容性与持续可用性；使用者自行承担代码质量、数据泄露、服务中断与业务损失风险。如认为仓库内特定文件侵犯合法权益，请通过 GitHub Issues 提交说明，不要在公开 Issue 中提交账号凭据、Token 或敏感代码。