Codex初次使用指南

快速参考表

命令	功能概述	典型场景
/model	选择模型及推理强度	需要更强思考或降级模型时
/approvals	设置无需用户确认的操作范围	批量执行命令前设定安全边界
/review	自动扫描当前改动并指出问题	预提交自检或代码走查
/new	在会话中开启新的话题上下文	话题切换或避免旧上下文干扰
/init	生成 AGENTS.md，写入 Codex 行为指南	初次在仓库中使用 Codex 时
/compact	压缩历史对话以释放上下文空间	长对话临近上下文上限
/undo	撤回上一个 Codex 回合	误触命令或输出不符合预期
/diff	展示 git diff（含未跟踪文件）	快速确认当前改动
/mention	在对话中引用文件	提示 Codex 关注某个文件
/status	显示当前会话配置与 Token 使用	调试 Codex 状态或排查限额
/mcp	列出已配置的 MCP 工具	确认是否可调用外部工具
/logout	退出登录	切换账号或清理会话
/quit /exit	关闭 Codex CLI 会话	会话结束
/feedback	将日志发送给维护者	汇报 Bug 或建议

命令详解与技巧

/model

• 作用：切换底层模型（如 GPT‑4o、o4‑mini）以及推理档位，平衡速度、成本与质量。
• 技巧：
  • 需要深入推理或代码分析时，切到高推理档位（例如 --reasoning effort=medium）。
  • 性能测试或批量生成文件可用较快模型，避免浪费配额。

/approvals

• 作用：定义 Codex 可在无需确认的情况下执行的操作，例如读文件、运行测试或修改目录。
• 技巧：
  • 迭代调试时先放宽对常用目录的写权限，可减少反复确认。
  • 大范围操作（如 npm install、git push）仍建议保持手动确认，防止误操作。

/review

• 作用：让 Codex 对当前变更进行审查，列出潜在 bug、风控点和缺失测试。
• 技巧：
  • 结合 git add -p 精选变更后再执行 /review，反馈更聚焦。
  • 发现问题可直接跟进“修复建议”，形成围绕同一 diff 的闭环。

/new

• 作用：在同一 CLI 会话内创建新的对话线程，保持之前的记录又避免上下文干扰。
• 技巧：在多任务并行时常用，避免因为上下文过长导致回答混乱。

/init

• 作用：生成 AGENTS.md，写入仓库级别指令（编码风格、禁用命令、测试策略等），让后续会话自动遵循。
• 技巧：
  • 初次接入 Codex 时就写好团队规范，后续所有成员可复用。
  • 可手动编辑 AGENTS.md，无需每次重新 /init。

/compact

• 作用：压缩当前对话历史，保留关键信息以节省 token。
• 技巧：在长对话后、准备切换主题前执行，可防止 Codex 因上下文超限而拒答。

/undo

• 作用：撤回上一轮 Codex 回复，常用于误触命令或希望重新回答。
• 技巧：撤回后立即给出新的提示，避免 Codex 根据旧上下文再次生成同样内容。

/diff

• 作用：展示 git diff，默认包含未跟踪文件，帮助 Codex 快速了解当前修改。
• 技巧：配合 /mention 指向具体文件时效果更佳，Codex 会结合 diff 和文件原始内容给出更准确的建议。

/mention

• 作用：在对话中明确告诉 Codex 关注某个文件（或多文件）；可多次引用。
• 技巧：处理大型仓库时通过 /mention path/to/file 让 Codex 聚焦关键文件；也可在发问前一次列出多个文件路径。

/status

• 作用：查看会话相关元信息，包括所用模型、审批策略、token 使用情况、沙箱配置等。
• 技巧：遇到 Codex 提示“操作需审批”或回答异常时先查 /status，确认当前策略是否如预期。

/mcp

• 作用：列出可用的 MCP（Model Context Protocol）工具，如数据库、外部 API 等。
• 技巧：调用前先 /mcp 确认工具是否加载成功，必要时可据此调整提示或安装依赖。

/logout

• 作用：注销当前账号，清除本地 session。
• 技巧：团队共用一台机器时，结束前执行 /logout 以免下一个人误用你的凭证。

/quit / /exit

• 作用：结束当前 Codex CLI 会话。
• 技巧：二者等价，可在完成工作流后使用；若想保留上下文供下次继续，先记得导出或记录关键结论。

/feedback

• 作用：将最近的日志发送给维护者，方便排查 CLI/模型问题。
• 技巧：反馈前可附上简短描述（例如“/feedback 模型切换失败”），提高处理效率。

常用使用小技巧

1. 命令组合：先 /diff 看改动，再 /review 出报告，最后根据结果 /undo 某些回合或直接继续对话，可形成一套闭环调试流程。
2. 预设工作流：在仓库根目录放置 AGENTS.md 配置团队规范，配合 /status 快速验证是否加载成功。
3. 上下文管理：长会话中定期 /compact，切换话题则用 /new，能显著降低“跑题”概率。
4. 权限安全感知：通过 /approvals 和 /status 随时确认 Codex 能做什么，搭配最少必要权限原则，既保留高效也保障安全。
5. 问题定位：当 Codex 对某文件理解偏差时，用 /mention file + 简要提示，引导其重新读取最新内容，尤其适合大型单体项目。