wbmeet

如何安装并使用 Cline CLI：npm 安装、cline auth 与仓库首个终端任务

npm 全局安装 Cline CLI，cline auth 登录，在仓库完成第一条可 diff 审查的 Agent 任务。

第一次在终端跑 Cline CLI，卡住的多半是 Node 版本、cline 不在 PATH，或还没跑 cline auth 完成 app.cline.bot 登录。按官方文档装好 CLI，在自有仓库目录认证，再完成一条能 git diff 审查的首个任务。

检索词是 如何安装并使用 Cline CLI 终端 Agent。下文对照 docs.cline.bot 的 CLI 安装与快速入门（npm install -g cline、cline auth、cline "任务"）。也可在 VS Code 装扩展，但本页只写终端路径。要约短会对齐 diff，用 wbmeet 建房，见 如何创建与加入房间。

npm 装 clinecline auth仓库首条任务

Cline CLI 适合谁

Cline 是能在编辑器侧边栏或终端里运行的自主编程 Agent：读仓库结构、搜索文件、改 diff、执行命令（需你逐步批准）。CLI 路径面向脚本化与纯终端工作流；官方 Quick Start 要求 Node.js 20+（推荐 22）。账号可在 app.cline.bot 官方注册，也可在设置里接入 Anthropic、OpenAI、Gemini 等自有 API Key——只用官方渠道，勿买共享账号。

20+
Node.js 最低版本
auth
终端登录子命令
BYOK
或 Cline 账号模型

用 npm 安装 Cline CLI

  1. 1

    准备 Node.js

    确认 node -v 为 20 或更高（官方推荐 22）。macOS 可用 nvm 或官网安装包；Linux 用发行版或 nvm。Windows 用官方 Node 安装器或 WSL。

  2. 2

    全局安装

    运行 npm install -g cline。装完新开终端，执行 cline --help 或 cline --version（以当前 CLI 输出为准）。若 command not found，把 npm 全局 bin 目录加入 PATH。

  3. 3

    与 VS Code 扩展区分

    扩展市场搜 Cline 是 IDE 内 UI；本页 CLI 命令同样叫 cline，但无需打开 VS Code 即可在仓库根目录工作。

cline auth 与模型来源

  1. 1

    运行 cline auth

    在终端执行 cline auth，按提示在浏览器打开 app.cline.bot 注册或登录官方 Cline 账号。完成后返回终端，应能启动交互会话。

  2. 2

    自带 API Key（可选）

    若不用 Cline 托管额度，可在 Cline 设置（CLI 或扩展）里填入 Anthropic、OpenAI、Google Gemini 等你在厂商官网申请的 Key。密钥只放环境变量或本地配置，勿提交 Git。

  3. 3

    确认连接

    跑一条短消息或 cline "reply OK if connected" 验证模型可达。免费/付费模型以账号仪表盘与选择器标注为准。

仓库里第一条可审查任务

  1. 1

    进入项目根目录

    cd 到你拥有的 Git 仓库，先 git status。Cline 会从当前工作目录扫描文件；大仓库第一小时只点名单文件或子目录。

  2. 2

    启动交互或一次性任务

    交互：cline。带初始提示：cline "阅读 src 入口并列出对外导出"。在提示里点名路径（如 src/main.ts）等效于缩小 @ 文件范围。

  3. 3

    做一个 diff 友好的改动

    第二条指令要具体：「给未测试的 helper 补单测，或修正 README 一处拼写；改前展示 diff，等我批准。」逐步批准工具调用；用 git diff 审查后再提交。

# First hour · Cline CLI · 2026-10-09
node -v   # 20+
npm install -g cline
cline auth
cd /path/to/your/repo
cline "Summarize src/index.ts exports; then add one unit test; show diff first"

CLI 与扩展、常见坑

路径适合第一次注意
npm 全局 cline终端 / CI 试跑PATH 含 npm global bin
cline authCline 官方账号仅 app.cline.bot 注册
自带 API Key已有厂商订阅密钥勿进仓库
VS Code 扩展可视化 diff与 CLI 可并存
01

cline 找不到

检查 npm 全局路径、新开终端。用 npm prefix -g 定位 bin。

02

auth 浏览器没弹出

复制终端 OAuth URL；检查代理与默认浏览器。

03

第一任务改动过大

拆成小步；先只读摸底；要求 diff-first。

官方路径：Node 20+ → npm install -g cline → cline auth → 在仓库跑 cline 或带引号任务 → 审查 diff。细节以 docs.cline.bot 为准。

和 Gemini CLI / Claude Code 的区别
安装与认证命令不同；可同时安装按任务选择。本站有 Gemini CLI 与 Claude Code 笔记。
必须用 Cline 账号吗
可用官方 OAuth；也可 BYOK 接各厂商 API，费用走对应账单。
教程页不是会议说明书
只讲 Cline CLI 第一次。短会白板见 wbmeet。

还想核对的问题

Windows 能用 Cline CLI 吗？

官方 CLI 文档以 Node.js 为主；Windows 可装 Node 20+ 后 npm 全局安装。团队若在预览阶段限制平台，以 docs.cline.bot 当前说明为准。

cline auth 和扩展里 Sign Up 一样吗？

都指向 app.cline.bot 官方账号体系；CLI 用 cline auth，扩展用侧边栏 Sign Up，凭据用途相同。

如何在提示里限定文件？

在任务字符串里写清相对路径（如 src/foo.ts）；Cline 会用搜索与读文件工具拉上下文，第一小时优先 1–2 个关键文件。

会自动执行 shell 吗？

Cline 提议命令与 diff 时通常需你批准；第一小时只批准只读或小范围写入。

免费开始开会