垦荒学园
  • 中文

      • 与 CLI Agent 协作

      Cursor（IDE）和终端里的 Agent 不是对手。本站已经写过 Claude Code 与 Codex。这一章只讲怎么把它们和 Cursor 编进同一条工作流，并让规则保持一致。

      先选入口，再选模型

      工作优先用为什么
      看文件、点 diff、来回改 UICursor 桌面 Agent编辑器就是审查台
      多文件功能，但你还要盯着Cursor + Plan Mode批准边界很清楚
      长时、少打断的终端任务（大迁移、全仓 lint、测到绿）Claude Code 或 Codex CLI为无人值守、权限和钩子设计
      脚本 / CI 里非交互跑一轮agent -p、claude -p、Codex 非交互没有 GUI 可点
      云端挂起过夜Cursor Cloud Agents，或 Codex Cloud（见各课）电脑可以合盖

      建议： 交互编辑循环用 Cursor；长时自治终端任务用 Claude Code / Codex。不要三个窗口同时改同一批文件。

      flowchart LR
  P[任务] --> Q{需要盯着 diff 吗?}
  Q -->|是| C[Cursor Agent / Plan]
  Q -->|否| T{要跑很久?}
  T -->|是| L[Claude Code 或 Codex CLI]
  T -->|否| C
  C --> G[Git 提交]
  L --> G

      同一仓库里的三种 CLI

      安装（命令以各课 / 官方页为准）：

      # Cursor Agent CLI — https://cursor.com/docs/cli/overview
curl https://cursor.com/install -fsS | bash
      irm 'https://cursor.com/install?win32=true' | iex
      # Claude Code — 见本站 /claude-code/installation/
# Codex — 见本站 /codex/installation/

cursor .          # 用 GUI 打开当前目录
agent "summarize the test layout"
      二进制产品典型会话
      cursor桌面编辑器打开文件夹
      agentCursor CLI与 IDE 同一套模式 / MCP
      claudeClaude Code终端 Agent + CLAUDE.md
      codexCodex CLI终端 / App，常配 AGENTS.md

      Cursor CLI 的模式与编辑器相同：Shift+Tab 或 /plan、/ask、--mode=plan。MCP 读同一批 mcp.json。

      规则怎么对齐（不要三套口头规范）

      层CursorClaude CodeCodex
      简单、共享的说明根目录 AGENTS.mdCLAUDE.md（可镜像同一内容）根目录 AGENTS.md
      带 glob 的结构化规则.cursor/rules/*.mdc按 Claude Code 课来Codex rules / hooks
      Skills.cursor/skills/、.agents/skills/.claude/skills/.codex/skills/
      MCP.cursor/mcp.jsonClaude Code MCP 配置Codex MCP 配置

      可共享的不变量（测试命令、包边界、「不要提交 .env」）只写在 根目录 AGENTS.md。Cursor 会读它；Claude Code / Codex 也能认 Markdown 规范文件。

      Cursor 还会从 .claude/skills/ 与 .codex/skills/（以及家目录对应路径）加载 skills，方便同一仓库。不要复制三份互相漂移的「始终用 bun / 始终用 npm」——只留一处真相，其他文件写「见根目录 AGENTS.md」。

      Cursor 专属行为（alwaysApply、按 glob 的 UI 约定）留在 .mdc。钩子、权限提示、沙箱留给 Claude Code / Codex 去细讲。

      推荐的一天

      上午 — 在 Cursor 里定范围

      1. 打开仓库，Ctrl+I，解释模块（见 快速上手）。
      2. 大功能：Shift+Tab，把计划存进工作区。
      3. 小的本地编辑用 Tab / Ctrl+K。

      下午 — 把长任务交给终端

      把计划里「机械、可验证」的部分交给 CLI，工作区先提交或 stash，避免两台 Agent 互踩：

      # 在 Claude Code 或 Codex 中（语义示例，以各课 CLI 为准）
Implement steps 3–5 of docs/plans/health-endpoint.md.
Do not change the public URL. Stop when npm test passes.

      傍晚 — 回到 Cursor 审查

      git diff，用 Agent 做审查提示，而不是再生成一遍功能：

      Review the unstaged diff against docs/plans/health-endpoint.md.
List mismatches only. Do not edit files unless I ask.

      冲突与锁定

      • 同一时间只让一个 Agent 写文件。 另一个用 Ask / 只读审查。
      • 开始长 CLI 任务前 提交或单独开分支。Cursor 检查点回滚不了另一台 Agent 在终端里改的文件。
      • MCP 服务器不要在 IDE 和 CLI 里用两套互相覆盖的全局 JSON，除非你清楚优先级。
      • 凭据：各工具都用环境变量；不要在规则文件里写 token。

      什么时候只用 Cursor

      • 你在调 CSS / 组件，需要浏览器工具和即时 diff
      • 你在教新人：侧栏比终端日志好讲
      • 仓库还没有 CLAUDE.md / Codex 配置，你暂时不想多装栈

      什么时候应离开 IDE：任务要跑 30 分钟以上、要细粒度权限提示，或要进 CI——打开 Claude Code 或 Codex 课，按它们的安装章做。

      下一步

      评论