Cline 项目介绍

Cline 项目介绍

项目定位

Cline 是一个开源 AI 编码代理（AI Coding Agent），能够自主完成软件开发任务，而非简单的代码补全工具。它既是一个 VS Code 扩展，也是一个可独立使用的 SDK。

一句话定义：自主执行软件开发任务的 AI Agent，支持 40+ 模型提供商，在 IDE 内外均可运行。

核心能力

能力	说明
自主 Agent 循环	持续循环执行工具调用，直到任务完成，不需要用户逐步引导
多模型支持	集成 40+ 个模型提供商（Anthropic、OpenAI、Gemini、Ollama 等），Plan/Act 模式可使用不同模型
丰富工具集	文件读写、命令执行、浏览器操作、MCP 工具、网络搜索、子代理调用等 25+ 种内置工具
上下文管理	自动截断、摘要压缩、文件读取去重，智能应对上下文窗口限制
细粒度审批	三级自动审批（Yolo / Auto-approve / 细粒度），每步工具调用可控
SDK 独立运行	@cline/core、@cline/agents、@cline/llms 可脱离 VS Code 独立使用，支持 CLI 和 CI/CD

技术栈

• 语言：TypeScript（全栈）
• 构建：npm + esbuild
• 前端：React（Webview UI）
• 通信：gRPC-like 协议（Proto 文件定义）
• 存储：SQLite（任务锁、持久化）、文件系统（对话历史）
• 测试：Playwright（E2E）、snapshot 测试（系统提示词验证）

架构概览

快速体验

VS Code 扩展方式

# 在 VS Code 扩展市场搜索 "Cline" 安装即可
# 或从源码构建
cd apps/vscode
npm install
npm run build

SDK CLI 方式

cd sdk
npm install
cd apps/cli
npm run build
# 运行 CLI
./bin/cline --help

教程导读

Cline 教程分为两个部分：

AI 应用通用知识（/tutorials/cline/ai/）

从 Cline 的实现中抽象出 Agent 设计、工具系统、上下文管理等通用知识，适用于构建任何 AI Agent。

章节	知识点	覆盖类型
01	Agent 核心循环与循环检测	补充 [[agent-design/01-overview]]
02	XML 工具协议与原生工具调用	补充 [[tool-use/01-overview]]
03	多模型路由与故障转移	引用 [[model-provider/01-overview]]
04	上下文压缩与摘要策略	引用 [[context-management/01-overview]]
05	流式传输与三方协调	引用 [[streaming/01-streaming-architecture]]
06	审批模式与安全控制	补充 [[sandbox/01-overview]]

编程核心技术（/tutorials/cline/dev/）

深入 Cline 的工程实践和架构决策，涵盖 monorepo 结构、gRPC 通信、SDK 分层设计等。

章节	知识点	说明
01	Monorepo 架构与 HostProvider 抽象	apps/ + sdk/ 双核心设计
02	Webview 与 Extension Host 通信	gRPC-like 协议与调试工具
03	SDK 分层架构设计	shared → llms → agents → core 依赖链
04	模块化系统提示词构建	components + variants + tools 三层组装
05	测试与评估策略	Playwright E2E + evals 基准测试