Codex CLI 使用与斜杠指令实战教程

Codex CLI 使用与斜杠指令实战教程

文章目录

• [Codex CLI 使用与斜杠指令实战教程](#Codex CLI 使用与斜杠指令实战教程)
• • [先建立正确认知：Codex CLI 到底怎么工作](#先建立正确认知：Codex CLI 到底怎么工作)
  • 安装、登录与第一次可靠任务
  • • [1. 选择安装方式](#1. 选择安装方式)
    • [2. 安装后验证与首次登录](#2. 安装后验证与首次登录)
    • [3. 升级与卸载边界](#3. 升级与卸载边界)
    • [4. 进入项目并启动](#4. 进入项目并启动)
    • [5. 推荐的第一次提示](#5. 推荐的第一次提示)
  • 启动命令、参数与终端子命令
  • • 常用启动参数
    • 权限与沙箱：最重要的安全开关
    • [面向自动化的 `codex exec`](#面向自动化的 codex exec)
    • 其他高频终端子命令
  • [会话内的斜杠 `/` 指令：中文意思、场景与示例](#会话内的斜杠 / 指令：中文意思、场景与示例)
  • • [A. 控制任务、模型与工作状态](#A. 控制任务、模型与工作状态)
    • [B. 权限、环境和上下文](#B. 权限、环境和上下文)
    • [C. 审查、上下文管理和会话整理](#C. 审查、上下文管理和会话整理)
    • [D. 外观、输入和诊断类指令](#D. 外观、输入和诊断类指令)
  • [4 个输入技巧：比背命令更常用](#4 个输入技巧：比背命令更常用)
  • 可复制的高质量提示模板
  • • [场景 1：修复 Bug](#场景 1：修复 Bug)
    • [场景 2：新增功能](#场景 2：新增功能)
    • [场景 3：只读代码审查](#场景 3：只读代码审查)
    • [场景 4：把长任务拆成可靠闭环](#场景 4：把长任务拆成可靠闭环)
  • 常见误区、失败路径与排错顺序
  • • [误区 1：把 `/` 指令当成终端命令](#误区 1：把 / 指令当成终端命令)
    • [误区 2：以为更高权限等于更高质量](#误区 2：以为更高权限等于更高质量)
    • [误区 3：长任务不断累积上下文](#误区 3：长任务不断累积上下文)
    • [误区 4：只看"已修改"，不看验证](#误区 4：只看“已修改”，不看验证)
    • 排错清单
  • 一套适合日常开发的标准工作流
  • 验证结果、资料来源与结论
  • • 已验证
    • 未验证
    • 官方资料

**主结论：**高效使用 Codex CLI 的关键不是背命令，而是先区分三层控制面：启动时的 codex ... 命令决定工作边界，会话中的 /... 指令调整当前协作状态，自然语言提示决定实际任务。把权限、上下文和验证要求说清楚，比不断换模型更能稳定地得到可用结果。
**适用版本与证据边界：**本文按 2026-08-27 核对的 OpenAI 官方 CLI 参考及本机 codex-cli 0.150.1 编写。不同版本、账号方案、操作系统和组织策略会导致模型、实验功能、部分 / 指令显示不同；以你终端中输入 codex --help 和会话内输入 / 后的菜单为准。

先建立正确认知：Codex CLI 到底怎么工作

Codex CLI 是运行在终端中的编码代理。它会读取当前目录及其规则文件（例如 AGENTS.md），理解你的任务，按当前权限执行搜索、编辑、构建、测试等工具操作，并把结果与验证边界反馈给你。

它不是"把一句中文自动变成正确代码"的生成器。一次可控的协作至少包含四个要素：

要素	你需要提供什么	为什么重要	示例
目标	要解决的业务问题或缺陷	防止只改表象	"修复订单导出空白页"
范围	目录、模块、不可改内容	防止无关重构	"仅改 order-export 模块，不改表结构"
约束	兼容性、安全、风格、数据边界	让方案可落地	"保留现有 API；禁止访问生产库"
验收	要执行的测试或可观察结果	防止"看起来改了"	"运行指定 JUnit 测试，并说明未覆盖项"

最小闭环如下：

进入仓库 → 启动 Codex → 说明目标和约束 → 查看其计划/命令/差异
→ 运行验证 → 审查 diff → 决定提交或继续迭代

这里的关键取舍是：给出清晰约束会稍微增加首次提示的长度，但能大幅降低返工、越权执行和"修复了 A 又破坏 B"的风险。对于一次性问答，简短提示足够；对于改代码、数据库、部署等会改变状态的工作，必须写出验收条件。

安装、登录与第一次可靠任务

1. 选择安装方式

截至本文核对日期，OpenAI 官方提供四种安装入口。选择一种即可，不要把 standalone、npm 和 Homebrew 混装；否则 PATH 中优先命中的旧版本可能让你误以为升级失败。

平台/前置条件	官方安装命令	适合谁	更新方式
macOS / Linux	`curl -fsSL https://chatgpt.com/codex/install.sh	sh`	希望使用官方独立安装器的用户
Windows PowerShell	`powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1	iex"`	Windows 原生终端用户
已安装 Node.js 与 npm	npm install -g @openai/codex	需要由 Node 工具链统一管理版本	重复执行同一命令
已安装 Homebrew	brew install --cask codex	使用 Homebrew 管理 macOS 软件的用户	brew upgrade --cask codex

macOS / Linux：

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

Windows PowerShell：

powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"

npm：

npm install -g @openai/codex

Homebrew：

brew install --cask codex

官方 standalone 命令和 PowerShell 命令都是"下载后立即执行远程脚本"。便利的代价是执行前无法在本地审阅脚本内容：只应从官方域名复制，使用可信网络；受公司软件源/审计要求约束时，可优先选由管理员批准的 npm 或 Homebrew 渠道。不要从不明博客复制安装脚本，更不要以 sudo 运行。

2. 安装后验证与首次登录

关闭并重新打开终端，然后执行：

command -v codex  # Windows PowerShell 可替换为：Get-Command codex
codex --version
codex login status
codex doctor --summary

第一条确认实际执行的是哪个 codex；第二条确认版本；第三条查看登录状态；第四条检查安装、配置、认证和运行环境。首次执行 codex 时，根据界面选择"使用 ChatGPT 登录"或当前可用的其他认证方式。

如果提示 codex: command not found，先重开终端；仍无效时检查安装器写入的 PATH 是否被你的 shell 配置覆盖。不要急着重复安装多个版本。发现同名多版本时，保留一种安装渠道并用 command -v codex（Windows 用 Get-Command codex）确认生效路径。

3. 升级与卸载边界

安装渠道	升级	卸载/清理建议
官方 standalone	重复执行对应平台的官方安装命令，或尝试 codex update（仅安装版本支持自更新时）	优先使用安装器/官方说明；删除前确认实际安装路径与会话数据位置
npm	npm install -g @openai/codex	npm uninstall -g @openai/codex
Homebrew	brew upgrade --cask codex	brew uninstall --cask codex

卸载 CLI 不等于删除本机的会话、配置或认证数据。若要在共享设备上退出，先执行 codex logout；删除配置或历史记录前先备份并确认范围，避免误删其他 Codex 安装方式仍在使用的数据。

4. 进入项目并启动

cd /path/to/your/repository
codex

没有子命令的 codex 会启动交互式终端界面（TUI）。它以当前目录为工作根目录，因此应该在仓库根目录启动；否则它可能找不到项目规则、测试命令和 Git 上下文。

也可以在任意位置指定目录：

codex -C /path/to/your/repository

5. 推荐的第一次提示

不要只说"帮我看看"。可以直接复制以下模板：

请先阅读当前仓库的 AGENTS.md 和相关模块，不要立即修改。
目标：定位订单导出偶发空白页的根因。
范围：只检查 order-export 模块及其测试。
约束：不访问生产环境、不修改数据库结构、不提交代码。
输出：区分已证实事实、推断和待验证项；给出最小修复方案及对应测试命令。

若确认方案后再让它修改，继续输入：

按你刚才的最小方案执行修改。保留已有接口行为，补充或更新相关测试；完成后运行测试并展示关键 diff 与未覆盖风险。

这比一开始要求"直接修好"更可靠，因为先把根因与变更面限定下来；但紧急小修复可以合并为一轮，只要同样写清验收标准。

启动命令、参数与终端子命令

这一节讲的是在 shell 里执行 的命令，例如 codex exec；它们不是会话输入框里的 / 指令。

常用启动参数

命令/参数	中文意思	典型用途	示例
codex	启动交互会话	日常开发、排错、迭代	codex
codex "提示"	带首条任务启动	一句话发起明确任务	codex "审查当前未提交改动"
-C <目录>	指定工作目录	不切换 shell 当前目录	codex -C ~/work/demo
-m <模型>	指定本次模型	临时切换模型	codex -m gpt-5.6-terra
-i <图片>	附带初始图片	将报错截图/设计稿带入任务	codex -i ./error.png "分析截图错误"
--search	启用实时网络搜索	查官方最新 API、版本资料	codex --search "查 Spring Boot 当前官方迁移说明"
--no-alt-screen	不使用终端备用屏幕	保留终端滚动历史	codex --no-alt-screen
-p <配置档>	叠加配置 profile	在个人/公司/CI 配置间切换	codex -p work
-c key=value	临时覆盖 TOML 配置	不修改文件地调整单项配置	codex -c 'model="gpt-5.6-luna"'

权限与沙箱：最重要的安全开关

Codex 会运行命令和编辑文件，因此启动时的权限设置决定了它能做到什么。常见组合如下：

参数	含义	适合场景	风险
-s read-only	只读沙箱	代码阅读、架构分析、审查	无法编辑或跑会写入产物的命令
-s workspace-write	可在工作区写入	默认推荐的本地开发边界	构建可能产生工作区文件
-a on-request	有需要时请求确认	日常人工协作	个别动作需要你确认
-a never	不请求确认	已隔离的自动化环境	必须先保证环境和任务可信
--add-dir <目录>	额外授予某目录写权限	项目需要写相邻目录	比扩大到全磁盘更小、更安全
--dangerously-bypass-approvals-and-sandbox	跳过审批并关闭沙箱	仅限外部已隔离、完全可信的项目环境	可在无确认、无沙箱保护下执行命令
--yolo	上述危险模式的简写	临时手动执行时的短写法	与长参数具有同等级别风险

推荐起点：

codex -s workspace-write -a on-request

--dangerously-bypass-approvals-and-sandbox 的中文意思是"跳过确认和沙箱"；可写作 --yolo：

# 仅限可信项目，且最好运行在独立容器、虚拟机或临时工作区中
codex --dangerously-bypass-approvals-and-sandbox
codex --yolo

它会让代理无保护地执行命令；除非运行在专门隔离的虚拟机且你完全理解影响，否则不要使用。它不是"提高效果"的开关，只是扩大了失误、错误提示词或恶意仓库指令的破坏范围。为避免未来版本的简写兼容性差异，在脚本、CI 和团队文档中建议使用完整参数；本机 codex-cli 0.150.1 已验证 --yolo 可被 CLI 接受。

面向自动化的 codex exec

codex exec 非交互运行 Codex，适合脚本、CI 或可重复任务。示例：

codex exec -C . \
  -s workspace-write \
  -o /tmp/codex-summary.txt \
  "检查当前未提交改动；只报告 P0/P1 问题，不修改文件。"

常用参数：

参数	中文意思	示例价值
--json	输出 JSONL 事件流	供 CI 或脚本解析进度
-o <文件>	写出最终一条助手消息	保存构建/审查摘要
--ephemeral	不把会话持久化到本机	短暂且敏感的自动任务
--output-schema <文件>	用 JSON Schema 约束最终输出	机器读取结构化结果
--skip-git-repo-check	允许非 Git 目录执行	文档目录或临时目录任务

CI 中可同时使用 --json 与 -o：前者捕捉过程事件，后者保留人类可读的收尾结论。自动化应尽量在隔离分支或临时工作区中运行，不能仅因为 -a never 方便就放宽权限。

其他高频终端子命令

命令	中文意思与用途	示例
codex review --uncommitted	审查暂存、未暂存和未跟踪改动	codex review --uncommitted
codex review --base main	与指定基线分支比较并审查	codex review --base main
codex resume --last	继续当前目录最近会话	codex resume --last
codex resume --all	跨目录查找并恢复会话	codex resume --all
codex fork --last	从最近会话分叉新对话	用于比较两种方案
codex mcp list	列出现有 MCP 外部工具	检查数据库、GitHub 等集成
codex plugin list	列出插件	查看可用扩展
codex features list	查看功能开关和有效状态	判断实验能力是否已启用
codex completion zsh	生成 Zsh 补全脚本	提高命令输入效率
codex update	更新 CLI	修复已知问题或获取新功能

codex delete <会话> 会永久删除 本机保存的会话及相关后代会话；通常优先使用 codex archive <会话> 归档，需要恢复时使用 codex unarchive <会话>。

会话内的斜杠 / 指令：中文意思、场景与示例

在交互界面的输入框键入 /，会打开可用指令菜单。下面是官方当前参考列出的内置指令；菜单只显示当前环境、账号和平台真正可用的项。

A. 控制任务、模型与工作状态

指令	中文意思	什么时候用	示例
/model	选择模型与可用的推理强度	任务复杂度变化时	/model 后选择模型
/fast	开/关快速服务层级	当前模型提供 Fast 时，希望降低等待	/fast
/plan [任务]	切换到规划模式，可附带任务	高风险/多文件改动前	/plan 为支付模块拟定迁移方案
/goal <目标>	设置持续追踪的任务目标	长任务需要防止偏题	/goal 完成迁移且保持测试通过
/goal edit、pause、resume、clear	编辑、暂停、恢复、清除目标	目标变更时	/goal pause
/status	查看会话配置与 token 使用量	核对模型、权限、上下文余量	/status
/new	在当前 CLI 内开始新聊天	不换仓库但需要全新上下文	/new
/resume	从会话列表恢复聊天	回到历史工作	/resume
/fork	分叉当前聊天	比较方案但保留原上下文	/fork
/side 或 /btw	开启临时侧边问答，不污染主线	问一个小问题	/side 这个异常的常见原因是什么？
/stop	停止当前会话启动的后台终端	取消长期构建/服务	/stop
/ps	查看后台终端和近期输出	跟踪 Maven、npm 等长命令	/ps

**示例：**先输入 /plan，然后说"为订单导出增加异步任务，先给出影响范围、数据一致性风险和测试计划"。计划确认后，再输入"执行修改"。这样把"设计决策"和"写入代码"分为两步；对于简单拼写修复则没有必要增加流程。

B. 权限、环境和上下文

指令	中文意思	什么时候用	示例
/permissions	调整会话内审批和沙箱权限	从只读分析切换到允许编辑，或反向收紧	/permissions
/approve	允许重试一次被自动审查拒绝的动作	确认该次动作确有必要后	/approve
/ide	将 IDE 的打开文件/选区等加入下一次提示	正在 IDE 中定位某段代码	/ide
/mention	附带指定文件或目录	要求优先审查某文件	/mention src/main/.../OrderService.java
/mcp [verbose]	查看 MCP 工具；verbose 显示详细诊断	外部工具不可用时	/mcp verbose
/apps	浏览并插入应用连接器	需要连接已授权第三方服务时	/apps
/plugins	浏览/管理插件	发现或安装插件能力	/plugins
/skills	浏览并使用技能	写文档、表格、设计等专项任务	/skills
/hooks	查看/信任/停用生命周期钩子	检查脚本在何时自动执行	/hooks
/memories	设置记忆注入与生成	控制跨会话偏好/上下文	/memories
/init	在当前目录生成 AGENTS.md 初始模板	给仓库建立持久协作规则	/init
/import	导入 Claude Code/Cursor 的设置、项目或聊天	迁移已有工作环境	/import

/permissions 是最应该熟悉的一条：它让你在同一个会话中改变安全边界。不要为了少点一次确认就直接给全盘权限；如果只缺一个相邻目录，应优先授予那一个目录而非无限扩大范围。

C. 审查、上下文管理和会话整理

指令	中文意思	什么时候用	示例
/diff	显示 Git 差异，含未跟踪文件	修改后人工复核	/diff
/review	让 Codex 审查当前工作区	写完功能后寻找逻辑漏洞	/review
/compact	压缩可见聊天为摘要以释放上下文	长会话接近上下文上限时	/compact
/copy	复制最近已完成回复	需要转发计划或结论	/copy 或 Ctrl+O
/rename [名称]	重命名当前会话	让历史会话便于检索	/rename 支付迁移排查
/archive	归档当前会话并退出	工作完成但要保留记录	/archive
/delete	永久删除当前会话并退出	确定不再需要且不含价值记录	/delete
/clear	清空界面并开始新聊天	希望同时清除可见界面与对话	/clear
/raw	切换原始滚动输出模式	需要在终端精确选取/复制长输出	/raw
/quit 或 /exit	退出 CLI	完成并已保存工作后	/exit

/compact 的作用是保留已识别的关键事实、决定和待办，同时减少对话占用，不是总结代码或自动提交。压缩后仍应通过 /status 检查余量，并把关键长期约束写进 AGENTS.md 或任务文档，而不是依赖聊天历史永远存在。

D. 外观、输入和诊断类指令

指令	中文意思	场景
/personality	调整沟通风格	想要更简洁或更解释性的回复
/theme	选择终端代码高亮主题	终端可读性不佳
/keymap	查看/修改快捷键映射	适配个人键盘习惯
/vim	开/关输入框 Vim 模式	熟悉 Vim 编辑方式
/statusline	配置底部状态栏项目	显示模型、分支、token 等
/title	配置终端窗口/标签标题项目	多终端并行时便于区分
/experimental	管理实验功能	仅在理解功能影响时启用
/debug-config	输出配置层级与策略诊断	排查"我的配置为什么没生效"
/feedback	发送日志与反馈给 Codex 维护方	报告可复现的产品问题
/usage	查看账户 token 用量或处理额度重置	检查使用情况
/app	将会话继续到桌面应用	需要桌面端工作流
/pets 或 /pet	选择/隐藏终端宠物	纯个性化，不影响任务能力

以下指令具有平台或条件限制：/sandbox-add-read-dir 与 /setup-default-sandbox 主要面向 Windows 沙箱场景；/fast、/personality、/usage 等也可能受模型、账户或组织策略影响。如果菜单中没有，不代表安装故障。

4 个输入技巧：比背命令更常用

输入方式	含义	示例	注意点
@	搜索工作区文件并把路径附加到提示	@OrderService.java 请解释重试逻辑	适合给精确上下文
!	在当前权限/沙箱下运行本地 shell 命令	!git status --short	命令仍受权限策略约束
Tab	当 Codex 正在工作时排队下一条提示/命令	排队"完成后运行测试"	等当前回合结束才执行
Enter	当 Codex 正在工作时注入新指令	"停止修改，只分析日志"	用于及时纠偏
Ctrl+R	搜索历史提示	复用之前成功的提示	回车采用，Esc 取消
Esc 两次	编辑上一条用户消息并从此处分叉	改正刚才错误约束	会创建分叉，不改原历史

实战例子：编译很慢时，不要频繁打断并重复问"好了没"。按 Tab 排队输入"构建结束后，仅当失败时分析第一条真实错误；成功时执行 git diff --check"，然后用 /ps 查看后台输出。这会形成清晰的后续动作，而不是让两个任务互相抢上下文。

可复制的高质量提示模板

场景 1：修复 Bug

先复现并定位，不要立即改代码。
现象：调用 POST /api/orders 时，特定空字段触发 500。
范围：order 模块；不改变 API 响应字段。
要求：给出堆栈对应的真实调用链，区分根因和触发条件。
确认后实施最小修复，新增回归测试并运行相关测试。

场景 2：新增功能

为任务列表增加"创建人"筛选。
先检查已有筛选与权限模型，说明前后端、SQL 和测试影响；不要引入新依赖。
约束：默认行为不能变化；筛选必须与组织隔离条件同时生效。
通过方案后实现，并验证构建、相关测试和页面类型检查。

场景 3：只读代码审查

审查当前未提交改动，不要修改文件。
只报告能由代码证实的问题，按 P0-P2 排序；每项附文件/行号、触发条件和最小修复建议。
忽略纯风格偏好；若没有问题，明确说明审查范围和未覆盖的运行时风险。

场景 4：把长任务拆成可靠闭环

目标：将旧的文件上传接口迁移到对象存储。
先只输出计划：现状、数据迁移策略、回滚方式、权限边界、测试方案和风险。
不得执行迁移、删除文件或调用外部生产服务。等待我确认后再修改代码。

这些模板的共同点是：先要求证据，再要求动作；先限定不可触碰的边界，再让 Codex 选择实现细节。尤其涉及数据库迁移、批量删除、部署、密钥或第三方 API 时，应把"是否允许真实外部写操作"说成显式条件。

常见误区、失败路径与排错顺序

误区 1：把 / 指令当成终端命令

/model、/diff、/permissions 只能在 Codex 的交互输入框里使用；在 zsh/bash 里输入会被 shell 当作文件路径或未知命令。相反，codex review --uncommitted、codex resume --last 是终端命令，不能直接输入到会话对话框。

误区 2：以为更高权限等于更高质量

权限只影响能否执行某类工具操作，并不提升模型推理质量。应从 read-only 或 workspace-write + on-request 开始，确认实际需要后再用 /permissions 调整。绝不把跳过沙箱作为日常配置。

误区 3：长任务不断累积上下文

当会话已经经历多轮搜索、日志和方案变更时，先输入 /status。余量紧张时使用 /compact，再用一段新的提示重申当前目标、已确认结论、不可改范围和下一项验收。若要探索另一种方案，使用 /fork，不要污染已验证的主线。

误区 4：只看"已修改"，不看验证

代码变更不等于行为正确。完成后至少执行：

/diff
请运行与改动直接相关的测试；如失败，先解释失败是否由本次修改引起。
请总结：改了什么、验证实际证明了什么、还没有验证什么。

对于前端要增加构建/类型检查，对后端要运行聚焦测试，对数据库/部署场景要区分本地验证与真实环境验收。一个 mock 单测通过，只能证明它覆盖的模拟场景，不自动证明生产可用。

排错清单

现象	先做什么	不要做什么
codex: command not found	检查安装路径与 PATH，执行 codex --version	反复在不同目录启动
登录或授权异常	执行 codex login status、codex doctor --summary	在聊天记录中粘贴密钥
配置像没生效	/debug-config 或 codex --strict-config	盲目同时改多个配置文件
MCP 工具不可用	/mcp verbose、codex mcp list	假定工具一定已授权
改动超出预期	立刻 /diff，停止继续写入并缩小范围	用 git reset --hard 粗暴清空他人改动
上下文变长、回复跑题	/status → /compact → 重申当前任务	继续堆叠更多无关日志

一套适合日常开发的标准工作流

1. cd 到仓库根目录，启动 codex
2. 用自然语言交代目标、范围、约束、验收
3. 复杂/高风险任务先 /plan；小任务直接实施
4. 修改期间：Enter 及时纠偏，Tab 排队后续动作，/ps 查看长命令
5. 完成后：/diff → 运行聚焦测试 → /review（可选）
6. 要继续再 /compact 或 /resume；要探索分支方案则 /fork
7. 只在人工审查通过后自行提交或部署

最小命令速查：

# 交互开发（推荐）
codex -s workspace-write -a on-request

# 从当前目录最近的历史会话继续
codex resume --last

# 审查本地所有未提交改动
codex review --uncommitted

# 检查安装与认证问题
codex doctor --summary

# 查看当前支持的完整参数，而不是猜命令
codex --help
codex exec --help

验证结果、资料来源与结论

已验证

• 本机运行 codex --version 得到 codex-cli 0.150.1；已读取 codex --help、codex exec --help、codex review --help、codex mcp --help 等本机帮助，文中终端命令和参数按此版本核对。
• 本机已验证 codex --yolo --help 可正常解析；官方帮助页明确标注完整参数 --dangerously-bypass-approvals-and-sandbox 为"极度危险"。
• 已读取 OpenAI 官方 CLI 安装页；本文列出的 standalone、PowerShell、npm 与 Homebrew 安装、更新命令来自该页，未在本轮重复安装或卸载任何软件。
• 已读取 OpenAI 官方 CLI 概览与 Developer commands 参考页；斜杠指令、输入快捷方式和交互语义据此整理。
• 已确认官方说明：实际菜单会因平台、模型、账号和实验功能而变化，因此文中未把所有指令宣称为每个环境必定可见。

未验证

• 未在你的账号中逐一切换模型、提交云任务、安装插件、连接 MCP 或运行外部写操作。
• 未对每种操作系统的终端配置作实机验证；Windows 专用沙箱项只按官方适用范围说明。

官方资料

• Codex CLI 概览
• Developer commands：终端命令、快捷方式与斜杠指令
• Codex 非交互模式
• Codex 权限与安全

**结论：**先用 codex -s workspace-write -a on-request 在仓库根目录启动；复杂任务先 /plan，修改后用 /diff 和测试验证，长会话用 /compact，需要换方向用 /fork。斜杠指令的价值是控制本次会话，不替代清晰的任务描述和人工审查。