Cline:开源自主编码代理支持 SDK、IDE 与 CLI

发布时间 2026-09-18 12 天前
来源 GitHub TypeScript
字数 2,842 字
查看原文

AI智能总结

Cline 是开源自主编码代理,提供 SDK、IDE 扩展与 CLI 三种形态,可在终端、IDE 和桌面端运行,支持交互式对话与 CI/CD 无头模式,兼容 macOS 与 Windows。

Cline 是一款开源的编码代理,可在你的 IDE、终端与桌面端使用。


索引

产品 说明 位置 更新日志
SDK Node.js 编程式代理 API 与扩展导出。 sdk/ CHANGELOG.md
CLI 终端界面、无头模式、shell 命令以及 CLI 专属流程。 apps/cli/ CHANGELOG.md
VS Code 扩展 VS Code 市场上的扩展以及扩展宿主集成。 /(迁移中) CHANGELOG.md
桌面应用 原生 macOS 与 Windows 应用(Tauri 外壳、Bun sidecar、Next.js 界面)。 apps/examples/desktop-app/ CHANGELOG.md
JetBrains 插件 由 JetBrains 托管的客户端,与共享代理核心通信。 目前我们暂不开源 JetBrains 插件 -
文档站点 公开文档页面。 docs/ -

跨项目编辑代码

Cline 会读取你的项目结构,理解文件之间的关系,并跨整个代码库进行协同修改。它会在工作过程中监听 lint 与编译错误,在你察觉之前修复缺失的导入、类型不匹配以及语法错误等问题。在 VS Code 与 JetBrains 中,每一次编辑都会以 diff 的形式呈现,你可以审阅、修改或回滚。所有变更都通过检查点(checkpoint)记录,方便你轻松撤销代理的工作。

执行 Bash 命令

Cline 可直接在终端中执行命令,并实时观察输出。可用于安装包、运行构建脚本、执行测试、部署应用、管理数据库等场景。对于像开发服务器这类长时间运行的进程,Cline 会在后台持续运行,并对新产生的输出作出反应,及时捕获编译错误、测试失败以及服务器崩溃等情况。

计划与执行模式

在 Plan 模式(计划模式)与 Act 模式(执行模式)之间切换。在 Plan 模式下,Cline 会探索你的代码库、提出澄清性问题,并制定策略。当你确认无误后,切换到 Act 模式,Cline 便会执行该计划。每一个文件编辑与终端命令都需要你的批准,因此你对实际发生的变化始终拥有掌控权。当然,你也可以开启自动批准,让 Cline 自主运行。

规则与技能

通过 .clinerules 文件定义项目专属规则,以引导 Cline 在你的代码库中的工作方式,包括编码规范、架构约定、部署流程、测试要求等。这些规则会被 CLI、VS Code 扩展以及 JetBrains 插件自动识别。同时,你也可以使用技能(skills),让模型在需要时加载特定的规则。

兼容所有模型

Cline 并不锁定任何单一的 AI 提供方,你可以根据工作流选择最适合的模型:

提供方 模型
Anthropic Claude Opus、Sonnet、Haiku
OpenAI GPT 系列模型
Google Gemini 系列模型
OpenRouter 来自任意提供方的 200+ 模型
Vercel AI Gateway 通过统一网关路由到多家提供方
AWS Bedrock Claude、Llama 等
Azure / GCP Vertex 所有托管模型
Cerebras / Groq 高速推理模型
Ollama / LM Studio 在本机运行本地模型
任意兼容 OpenAI 的 API 自托管或第三方端点

通过插件或 MCP 服务器扩展

通过插件扩展 Cline 的能力。利用 SDK,可以通过编程方式注册工具与生命周期钩子(hook),用于日志记录、审计、策略执行或添加领域专属能力。简单的插件示例如下:

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) => {
    // 你的部署逻辑
  },
})

const agent = new Agent({ tools: [deployTool], /* ... */ })

或者使用 MCP(Model Context Protocol,模型上下文协议)服务器连接数据库、查询 API、管理云基础设施,并与外部系统交互。你可以使用社区构建的服务器,也可以让 Cline 即时创建自定义工具。在 CLI 中,可通过 cline mcp 命令管理服务器。

多代理团队

协调多个代理共同完成复杂任务。协调代理(coordinator)会将工作拆分为子任务,并委派给各具专属工具与上下文的专家代理。团队状态会在会话之间持久化,便于你随时从上次中断的地方继续。

cline --team-name auth-sprint "Plan and implement user authentication with tests"

定时代理

按 cron 计划运行代理,以执行周期性自动化任务,例如每日 PR 摘要、每周依赖检查、代码库健康报告等。计划在重启后仍然保留,并独立于任何终端会话运行。

cline schedule create "PR summary" \
  --cron "0 9 * * MON-FRI" \
  --prompt "List all open PRs and their review status" \
  --workspace /path/to/repo

连接 Slack、Telegram、Discord 等平台

通过任意消息平台与你的代理聊天:Telegram、Slack、Discord、Google Chat、WhatsApp 以及 Linear。每条会话线程都对应一个具备完整上下文的代理会话。你可以设置访问控制,限制谁能与你的代理交互。

# 连接 Telegram
cline connect telegram -k $BOT_TOKEN
# 通过 Webhook 连接 Slack
cline connect slack --bot-token $SLACK_TOKEN --signing-secret $SECRET --base-url $URL
# 通过 Socket 模式连接 Slack
cline connect slack --bot-token $SLACK_TOKEN --app-token $SLACK_APP_TOKEN

用于 CI/CD 的无头 CLI

以零交互方式运行 Cline,用于脚本编写与自动化。可通过管道传入输入、获取 JSON 输出、串联命令,并集成到 CI/CD 流水线中。

cline "Run tests and fix any failures"
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'

贡献

请从贡献指南开始。加入我们的 Discord,前往 #contributors 频道与其他贡献者交流。访问我们的招聘页面查看全职岗位。

许可证

Apache 2.0 © 2026 Cline Bot Inc.