wbmeet

如何安裝並使用 Cursor CLI Agent：終端安裝、登入與倉庫第一個任務

官方 install 腳本、agent login、倉庫裡第一個可審查 diff。需 Cursor 帳號。

想在终端里用 Cursor Agent 改倉庫，卡住的多半是装错命令、~/.local/bin 不在 PATH，或还没 agent login。按官方腳本装好 agent，登入后在自有倉庫做一件能 git diff 審查的事。

檢索詞是 如何安裝并使用 Cursor CLI Agent。下文对照 Cursor 文档 cursor.com/docs/cli/installation、cursor.com/docs/cli/overview 与 cursor.com/docs/cli/reference/authentication。这是 Cursor 的终端代理，不是本站会议产品。要约短会对齐 diff，用 wbmeet 建房，见 如何创建与加入房间。

安裝 agent登入倉庫里第一件事

Cursor CLI 在终端里做什么

Cursor CLI 让你在终端里与 AI Agent 对话：读文件、提议改动、执行命令（可在沙箱里控制）。交互式跑 agent，腳本/CI 可用 agent -p "…" 等非交互模式。默认是 Agent 模式；/plan 或 Shift+Tab 可切到 Plan，/ask 为只读探索。用量与模型权限跟随你的 Cursor 账号 订阅条款，以官方定价页为准。

agent
CLI 命令名
login
瀏覽器认证
API Key
CI 自动化

安裝 Cursor CLI

  1. 1

    运行官方安裝腳本

    macOS、Linux、WSL：curl https://cursor.com/install -fsS | bash。Windows（原生 PowerShell）：irm 'https://cursor.com/install?win32=true' | iex。装完后把 ~/.local/bin 加入 PATH（bash/zsh 按官方 installation 页写入 profile 并 source）。

  2. 2

    驗證安裝

    新开终端，跑 agent --version。若 command not found，检查 PATH 是否包含 $HOME/.local/bin，不要与 Cursor IDE 内置终端混淆——这是独立的 agent 二进制。

  3. 3

    可选：手动更新

    CLI 默认尝试自动更新。需要时运行 agent update 拉到最新版。团队 CI 可 pin 版本并单独测升级窗口。

登入：瀏覽器或 API Key

  1. 1

    瀏覽器登入（推荐）

    运行 agent login，默认打开瀏覽器用 Cursor 账号完成认证。无头环境设 NO_OPEN_BROWSER=1，复制终端打印的 URL 手动打开。成功后 agent status 应显示已登入。

  2. 2

    API Key（腳本/CI）

    在 Cursor Dashboard → API Keys 生成用户 API Key。导出 export CURSOR_API_KEY=…，或单次命令加 --api-key。不要把真实 Key 写进倉庫、截图或 issue。

  3. 3

    切换或退出

    agent logout 清除本地凭据。换账号时先 logout 再 login。计费与模型可用性以账号订阅为准，见 cursor.com 官方说明。

在倉庫里完成第一个任务

  1. 1

    进入项目根目录

    cd 到你拥有的 Git 倉庫。先 git status 看清未提交改动，方便之后 review。

  2. 2

    启动 Agent 会话

    运行 agent 进入交互模式，或 agent "用一句话说明入口模块" 带初始提示。大倉庫第一小时先用 /ask 或只读问题缩小范围。

  3. 3

    做一个可審查的改动

    第二条指令要具体：「给一个未测试的 helper 补单测，或给对外函数加输入校验；先展示 diff 再应用。」用 git diff 逐行審查。需要时可 agent resume 延续上下文。

# First hour · Cursor CLI · 2026-09
# macOS / Linux / WSL
curl https://cursor.com/install -fsS | bash
agent --version
cd /path/to/your/project
agent login
agent
# or: agent \"explain the entry point; then add one unit test; show diff first\"

模式与常见坑

场景命令/模式第一次注意
日常改代码默认 Agent 模式批准命令前读输出
先设计再写/plan、Shift+Tab大重构先 Plan
只读摸底/ask、--mode=ask不改文件
CI 審查agent -p "…"用 CURSOR_API_KEY
沙箱/sandbox按团队策略开网络
01

agent: command not found

PATH 缺 ~/.local/bin。新开终端并 source shell 配置。

02

Not authenticated

跑 agent login 或检查 CURSOR_API_KEY。无头机用 NO_OPEN_BROWSER=1。

03

第一任务改动过大

拆小任务；先用 Ask 理解结构；要求 diff-first。

官方路径：curl 安裝 → agent --version → agent login → 在倉庫跑 agent → 審查 diff。细节以 cursor.com/docs/cli 为准。

和 Claude Code / Copilot CLI 的区别
各家终端代理安裝与认证不同。本站有 Claude Code 与 Copilot CLI 笔记可对照。
必须装 Cursor IDE 吗
CLI 可独立使用；IDE 与 CLI 共享账号体系，但是不同入口。
教程页不是会议说明书
只讲 Cursor CLI 第一次。短会见 wbmeet。

還想核對的问题

没有 Cursor 账号能用 CLI 吗？

agent login 需要 Cursor 账号；API Key 也在 Dashboard 生成。订阅与用量限制以 Cursor 官方条款为准。

瀏覽器打不开怎么办？

设置 NO_OPEN_BROWSER=1 后 agent login，手动打开终端里的 URL。

CI 里怎么跑 agent？

用 CURSOR_API_KEY 环境变量，配合 agent -p 非交互提示；不要把 Key 提交到 Git。

第一个任务必须改生产代码吗？

不必。先用 Ask 或只读问题，再做可 revert 的单测或小校验。

免費開始開會