Cursor／Codex 第一次开 Agent：Cmd+I 与 codex 命令＋权限怎么设

Cursor：打开文件夹后按 Cmd／Ctrl+I 开 Agent；官方建议先让它解释代码库再做小改动。Codex CLI：安装后在项目目录运行 codex，用 ChatGPT 登录，并用 /permissions 设边界。产品 UI 易变，步骤以当前官方文档与界面为准。

要点

• Cursor Agent：侧栏 Agent；macOS Cmd+I，Windows／Linux Ctrl+I（Your first project、Agent overview）。
• 第一次任务（官方示例）：先问 “Explain this codebase…” 找入口与模块，再做小范围改动；用 diff 审阅，不要的改动可拒绝（Quickstart）。
• Cursor 运行模式：Settings → Agents → Approvals & Execution；多数人可用 Auto-review（允许列表立即跑、可沙箱的 shell 进沙箱、其余交分类器）。另有 Allowlist、Run Everything（Run Modes）。证据强度：官方文档；菜单文案以当前客户端为准。
• Codex CLI 安装（macOS／Linux 官方）：curl -fsSL https://chatgpt.com/codex/install.sh | sh，进入仓库后运行 codex，首次选 Sign in with ChatGPT（Codex CLI、openai/codex）。
• Codex 边界：会话内 /permissions 选择何时可改文件／跑命令；另有 /init 生成 AGENTS.md（同上 Learn 文档）。
• 共同安全习惯：改前用 Git 建检查点；第一轮任务写清“只改哪些路径／不要碰什么”；Cloud Agents／网页代理与本地权限模型不同（Cursor 文档写明 Cloud Agents 不走本地 Run Modes）。
• 证据强度总评：③ 优先送事实核查——快捷键与设置路径已对照 2026-10-27 抓取的官方文档，但仍可能随版本漂移。

正文

场景

仓库刚 clone 下来，你想让 Agent“顺手改一下”，结果它扫全仓、改测试、装依赖，diff 长到不想看。第一次开 Agent，目标应是：建立可控回路——它读得懂结构，你审得动改动，权限不会默认“一切自行”。

下文分 Cursor 桌面端与 OpenAI Codex CLI 两条入门线。二者都是“能改文件、能跑命令的编码代理”，但安装、登录与审批 UI 不同。菜单名、默认模式以你本机当前版本为准。

路线 A：Cursor 第一次开 Agent

证据强度：高（官方 Help／Docs，核验日 2026-10-27）；UI 仍可能变。

1. 安装并登录 Cursor，然后 File → Open Folder 打开目标项目（Your first project）。
2. 打开 Agent 面板：Cmd+I（Mac）或 Ctrl+I（Windows／Linux）。
3. 第一轮只读理解（官方 Quickstart 示例意译／可英文原文照发）：

Explain this codebase. Point me to the main entry points, key modules,
and anything I should read before making changes.

1. 第二轮小改动：把范围写死，例如 “只在 src/settings/ 增加暗色模式开关，不改 API，不改依赖版本”。官方示例句式是直接下任务（如 Add a dark mode toggle…），但入门更稳的是附加路径约束。
2. 审 diff：Agent 边做边应用编辑；在 diff 视图检查，拒绝不需要的改动。复杂探索可用对话时间线上的 Checkpoints 回滚文件状态（Agent overview）；长期版本仍以 Git 为准。
3. 补上下文：输入 @文件 或 @目录 指向关键路径。
4. 设审批（强烈建议第一天就看）

Settings → Agents → Approvals & Execution：

– Auto-review：已知安全调用少打断；shell 尽量进沙箱；其余经分类器。官方称对多数人是“最有用且相对稳妥”的设置。

– Allowlist：只自动跑你列出的动作。

– Run Everything：全部自动——官方定位是接受风险、零提示。

另有 Browser／删文件／工作区外写文件等独立保护项。详见 Run Modes。

1. 可选：浏览器 cursor.com/agents 跑 Cloud Agents——文档写明其不使用本地 Run Modes。

路线 B：Codex CLI 第一次开 Agent

证据强度：高（OpenAI Learn／GitHub README，核验日 2026-10-27）。

1. 安装（macOS／Linux 官方独立安装器）：

curl -fsSL https://chatgpt.com/codex/install.sh | sh

Windows 请用官方 PowerShell 安装脚本（见 GitHub openai/codex README）。亦可用 npm i -g @openai/codex 或 Homebrew cask，以文档当前推荐为准。

1. 进入项目目录，运行 codex。首次选择 Sign in with ChatGPT（或其他界面提供的登录方式）。Help Center 说明 Codex 可随 ChatGPT 套餐使用，额度因档位而异（Using Codex with your ChatGPT plan）。
2. 第一任务：Tell me about this project（Learn 文档示例），或：

codex "explain this codebase"

1. 再给一个可回滚的小任务。官方 prompting 示例会先 git init 再让它生成单文件；真实仓库里更稳妥的是：你自己先 git status／建分支，再让它改。
2. 权限：在会话中用 /permissions 查看沙箱与可写根、选择何时免询问。用 /init 生成 AGENTS.md 写项目惯例。用 /model 切换模型与推理力度（Codex CLI）。
3. 需要网页现状时，文档提到可用搜索相关开关／flag（如 --search）；以你安装版本的 --help 为准。

真实用户诀窍／反例

• 诀窍：第一小时禁止“顺便重构”。 官方与社区实践都偏向：先解释 → 再窄改 → 再扩大。
• 诀窍：完成定义写进提示。 例如“改完运行 npm test；失败则修复到绿；不要升级 major 依赖”。
• 反例：一上来 Run Everything／过度宽松 permissions。 省掉的点击，可能换成一次难回滚的全仓格式化或危险 shell。
• 反例：无 Git 就让 Agent 大改。 Cursor Checkpoints 不等于远程备份；Codex 文档也建议任务前后做 Git 检查点。

适用边界

• 本稿是第一次打开的对照入门，不是 IDE 全功能手册，也不评测谁更强。
• 企业策略、团队强制 Run Mode、SSO、数据留存未展开。
• 快捷键、设置路径、默认模式：以产品当前界面与官方文档为准；若与本文不一致，以你客户端内文档链接为准。

【来源与编译】

• Your first project｜Cursor Help｜https://cursor.com/help/getting-started/first-project｜核验 2026-10-27
• Quickstart｜Cursor Docs｜https://cursor.com/docs/get-started/quickstart｜核验 2026-10-27
• Cursor Agent｜https://cursor.com/docs/agent/overview｜核验 2026-10-27
• Run Modes｜https://cursor.com/docs/agent/security/run-modes｜核验 2026-10-27（含 Auto-review／沙箱／Cloud Agents 不适用说明）
• Codex CLI｜ChatGPT Learn｜https://learn.chatgpt.com/docs/codex/cli｜核验 2026-10-27
• openai/codex README｜https://github.com/openai/codex｜核验 2026-10-27
• Using Codex with your ChatGPT plan｜OpenAI Help｜https://help.openai.com/en/articles/11369540-getting-started-with-codex
• Codex prompting_guide（仓库内示例）｜https://github.com/openai/codex/blob/main/codex-cli/examples/prompting_guide.md
• 本文说明：并列表述两条产品的“第一次”路径；强调审批与窄任务；凡 UI 文案均标“以当前界面为准”。未把某一版本的截图按钮坐标写成永久事实。未证实的第三方“隐藏快捷键”已删。