• 人工智能
• 大模型
• AI Agent
• 代码智能体
• AI 应用
• 开发工具

Cline CLI是一款运行在终端（Terminal）里的 AI 编程代理（AI Coding Agent）。它能在你的授权下创建/编辑文件、运行命令、使用浏览器，把"读懂代码 → 修改代码 → 跑测试 → 提交结果"整条链路自动化。更强大的地方在于：它天生适合无头（Headless）运行，可以轻松嵌入 CI/CD 流水线，实现自动化代码审查、定时任务巡检和 GitHub 自动回复。本文将带你从零上手，快速掌握终端运行 AI 编程代理的完整流程。

一、为什么选择 Cline CLI？

相比只停留在 IDE 插件里的 AI 助手，Cline CLI 有三个独特优势 🎯：

Cline 还内置了"人在回路（Human-in-the-Loop）"机制：默认在每次运行命令、编辑文件前征求你的批准；在 CI 场景中则可开启--auto-approve完全自主执行。

二、快速安装：3步上手终端AI编程助手

前置条件：已安装 Node.js（GitHub Actions 上建议 20+ 版本）。

第 1 步：全局安装 CLI

npm i -g cline

第 2 步：配置模型供应商与 API Key

cline auth

交互式向导会引导你选择供应商（如 Anthropic、OpenRouter）并填入 API Key。也可以直接命令行完成：

cline auth --provider openrouter --apikey 你的APIKEY

第 3 步：运行第一个任务

cline "列出项目中的 TODO 注释并总结"

如果安装或配置遇到问题，运行诊断命令即可一键排查：

cline doctor

💡 也可以把本仓库克隆到本地研究：git clone https://link.gitcode.com/i/5e4fa0c6b7484e4888cb0ef24f0b926d，CLI 源码位于 cli/ 目录。

三、核心命令速查表：最常用的功能一览

以下是日常使用频率最高的命令（完整参考见 cli-reference.mdx）：

几个高频全局参数值得记住：

• -p, --plan：先进入 Plan 模式，让代理先出方案再动手
• --json：输出 JSON 格式消息，方便脚本解析
• -m, --model：临时切换本次运行的模型
• --auto-approve true：全自动执行，无人值守
• -t, --timeout 600：限制任务最长运行时间

四、两种运行模式：交互会话与无头自动化

交互式 TUI 模式

直接运行cline或加-i参数，即可进入带界面、支持文件 @ 提及（@mention）的终端交互会话，适合日常开发调试。

无头（Headless）模式：CI/CD 自动化的关键

使用--json、管道输入或输出重定向时，Cline 会自动进入无头模式。这意味着它可以被无缝嵌入 Shell 脚本和 CI 流水线 🚀：

# 把 git diff 结果"喂"给 Cline 审查 git diff | cline "review these changes" # JSON 输出供脚本解析 cline --json "summarize this changelog" | jq -r '.text' # 全自主执行：跑测试并自动修复失败用例 cline --auto-approve true "run tests and fix failures"

⚠️ 安全提示：自主执行会直接修改文件并运行命令，建议在干净的分支上运行并复查结果。

五、实战：在 CI/CD 中实现自动化代码审查

这是 Cline CLI 最惊艳的用法——每个 Pull Request 都由 AI 自动完成深度审查，包括安全性检查、上下文分析和内联代码建议。官方完整工作流参考 github-pr-review.mdx。

第 1 步：创建 GitHub Actions 工作流

在仓库的.github/workflows/下创建cline-pr-review.yml，核心流程只需 5 步：

1. 检出代码（actions/checkout）
2. 安装Node.js 与 Cline CLI（npm install -g @cline/cli）
3. 配置认证（从仓库 Secrets 读取 API Key）
4. 运行 Cline，用系统提示词指导它分析 diff、上下文与相关 Issue
5. 发布详细的审查评论（含内联代码建议）

第 2 步：在 GitHub 仓库中配置 API Key

出于安全考虑，不要把密钥硬编码进工作流。进入仓库Settings → Environments，创建一个名为cline-actions的环境，再在其中添加 Secret：

工作流中通过secrets.OPENROUTER_API_KEY（或ANTHROPIC_API_KEY等）引用即可。

第 3 步：用 CLINE_COMMAND_PERMISSIONS 收紧安全边界

CI 环境里"只读优先"是最佳实践。通过CLINE_COMMAND_PERMISSIONS环境变量，可以白名单式地限制代理能执行的命令，例如只允许gh pr diff、git log等只读命令，deny规则永远优先于allow：

CLINE_COMMAND_PERMISSIONS='{"allow": ["gh pr diff *", "git log *"], "deny": ["rm -rf *", "sudo *"]}'

这样即使代理"越界"想执行危险操作，也会被直接拦截，让无人值守的代码审查真正安全可控。

第 4 步：自动审查效果

PR 一旦被标记为 ready for review，工作流自动触发。Cline 会拉取 PR diff、CI 检查状态和相关 Issue，然后以评论形式把审查意见（含行内代码修改建议）直接发布到 PR 下 📝：

同样的思路还可以让@cline成为你的 Issue 机器人：在任意 Issue 评论区 @ 它，它会自动读代码、分析根因并回复结论，完整样例见 cline-responder.yml 与 github-integration.mdx。

六、进阶玩法：cron 定时任务让审查"到点就查"

除了事件触发，Cline CLI 还支持cron 定时代理（详见 scheduling.mdx），任务持久化保存在本地 hub，重启进程后依然生效：

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

几个实用场景：

• 每周一 9 点自动汇总上周合入的 PR 与待审 Issue
• 每 15 分钟巡检依赖安全漏洞并输出报告
• 每天下班前生成团队代码变更日报

常用 cron 表达式：*/5 * * * *（每 5 分钟）、0 9 * * 1-5（工作日 9 点）、0 0 1 * *（每月 1 日）。运行cline schedule还能查看执行历史、成功率和 Token 消耗统计。

七、常见问题（FAQ）

Q1：Cline CLI 和 VS Code 里的 Cline 插件是什么关系？核心能力同源，CLI 面向终端与自动化场景（定时任务、Agent 团队等能力为 CLI/SDK 专属），插件面向 IDE 内开发体验。

Q2：无头模式下如何保证不会乱改文件？三重保险：--auto-approve false关闭自动批准、CLINE_COMMAND_PERMISSIONS限制命令白名单、在 CI 中使用干净的临时分支运行并人工复查产出。

Q3：本地模型也能跑吗？可以。通过 Ollama 或 LM Studio 暴露 OpenAI 兼容接口后，用cline auth配置即可离线使用。

Q4：配置和会话数据存在哪里？统一在~/.cline/目录（API 密钥、全局规则、SQLite 会话库）；项目级配置（规则、Skills、Hooks、插件）则放在仓库根目录的.cline/下，随仓库版本化。

八、总结

Cline CLI 把"AI 编程代理"搬进了终端，让你只需三条命令（npm i -g cline→cline auth→cline "任务"）就能开始自动化开发；借助无头模式、CLINE_COMMAND_PERMISSIONS安全策略和 cron 定时任务，它更是一个开箱即用的CI/CD 自动化代码审查引擎。推荐路线：

1. 先按本文第二节完成安装与认证；
2. 在本地用git diff | cline "review these changes"体验管道审查；
3. 参考 cli/README.md 与 cli-overview.mdx 把工作流接入 CI，再按需叠加定时任务。

把重复的审查工作交给 Cline CLI，把时间留给真正重要的架构决策吧 💪

• 人工智能
• 大模型
• AI Agent
• 代码智能体
• AI 应用
• 开发工具