按当前 Codex CLI(约 0.147 / main 源码)整理。不同版本和实验开关开放的指令可能不同,在会话中输入 / 可以查看当前版本实际支持的列表。
官方文档
CLI 启动与权限
codex在当前目录启动交互会话。
codex "<任务>"带初始任务启动交互会话。
codex -m <model>指定模型启动。
codex --sandbox workspace-write --ask-for-approval on-request允许写入工作区,并在需要时请求人工批准。
codex --sandbox danger-full-access --ask-for-approval on-request关闭文件系统沙盒,但在需要时仍请求人工批准。
codex --approve-for-me走自动 review + on-request + workspace-write;别名 --not-so-yolo。
codex --dangerously-bypass-approvals-and-sandbox同时跳过审批和沙盒,所有命令直接在宿主环境执行;别名 --yolo。
codex --add-dir <路径>额外开放可写目录。
codex exec "<任务>"非交互执行;短别名 codex e。
CAUTION
--yolo/--dangerously-bypass-approvals-and-sandbox只应在一次性容器、虚拟机等外部隔离环境中使用。日常优先保留审批,或用--add-dir只开放确实需要写入的目录。
需要长期调整沙盒或审批时,可以在 ~/.codex/config.toml 中设置:
sandbox_mode = "danger-full-access"approval_policy = "on-request"sandbox_mode 常见取值:read-only、workspace-write、danger-full-access。
approval_policy 常见取值:untrusted、on-request、never。将审批设为 "never" 会同时关闭人工确认,不建议在宿主机上使用。
基础与会话
/打开当前版本支持的指令列表。
/model切换模型和 reasoning effort。
/permissions配置 Codex 可以做什么,以及何时需要确认。
/status查看当前会话配置、模型、权限、token 使用情况。
/init创建 AGENTS.md,写入 Codex 项目级指引。
/compact压缩对话上下文,避免接近上下文上限。
/plan切换到 Plan 模式。
/review审查当前改动并找出问题。
/new在当前对话中开启新聊天。
/clear清空终端并开始新会话。
/rename重命名当前会话。
/resume恢复已保存的聊天。
/forkFork 当前聊天。
/archive归档当前会话并退出。
/delete永久删除当前会话并退出。
长任务与多 Agent
/goal设置或查看长任务目标。
/agent切换当前活动的 agent 线程;/subagents 是别名。
/side在临时 fork 里开侧聊,不影响主线;/btw 是别名。
/btw/side 的别名。
扩展与集成
/mcp列出已配置的 MCP 工具。
/mcp verbose显示更详细的 MCP 工具信息。
/skills查看并使用 skills。
/plugins浏览插件。
/apps管理 apps / connectors。
/app把当前会话续到 Desktop app(macOS / Windows)。
/hooks查看和管理 lifecycle hooks。
/memories配置记忆的使用与生成。
/experimental开关实验功能。
/import从 Claude Code 导入设置、项目和近期聊天。
IDE 与运行环境
/ide纳入 IDE 中的当前选区、打开文件等上下文。
/keymap重映射 TUI 快捷键。
/vim切换 composer 的 Vim 输入模式。
/setup-default-sandbox设置 elevated agent sandbox。
/sandbox-add-read-dir <absolute_path>允许沙箱读取额外目录(Windows)。
/approve批准最近一次 auto-review denial 的一次重试。
/cd <目录>切换当前工作目录。
/pwd显示当前工作目录;/cwd 是别名。
输出与代码
/copy复制上一条回复为 Markdown。
/export导出对话为 Markdown。
/raw切换 copy-friendly raw scrollback。
/diff查看 Git diff,包括 untracked 文件。
/mention在输入中提及一个文件。
账号、界面与诊断
/usage查看账号用量,或使用用量限额重置。
/debug-config查看配置层和 requirements 来源。
/statusline配置状态栏显示项。
/title配置终端标题显示项。
/theme选择语法高亮主题。
/pets选择或隐藏终端 pet;/pet 是别名。
/personality选择 Codex 的沟通风格。
/ps列出后台终端。
/stop停止全部后台终端;/clean 是别名。
/logout退出登录。
/feedback发送日志或反馈给维护者。
/quit退出 Codex;/exit 是别名。
安装速查
# macOS / Linuxcurl -fsSL https://chatgpt.com/codex/install.sh | sh官方安装脚本。
# Windowspowershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"官方安装脚本。
npm install -g @openai/codexnpm 安装。
brew install --cask codexHomebrew 安装。
常用配置与项目文件:
| 路径 | 用途 |
|---|---|
~/.codex/config.toml | 用户配置 |
AGENTS.md | 项目级指引;/init 可生成 |
AGENTS.override.md | 本地覆盖 |
skills 目录中的 SKILL.md | Skills |
NOTE
/rollout、/test-approval等只在 debug 构建中出现;/debug-m-drop、/debug-m-update为内部调试指令,不要日常使用。