1138 字
6 分钟
Codex 指令速查表

按当前 Codex CLI(约 0.147 / main 源码)整理。不同版本和实验开关开放的指令可能不同,在会话中输入 / 可以查看当前版本实际支持的列表。

官方文档#

CLI 启动与权限#

Terminal window
codex

在当前目录启动交互会话。

Terminal window
codex "<任务>"

带初始任务启动交互会话。

Terminal window
codex -m <model>

指定模型启动。

Terminal window
codex --sandbox workspace-write --ask-for-approval on-request

允许写入工作区,并在需要时请求人工批准。

Terminal window
codex --sandbox danger-full-access --ask-for-approval on-request

关闭文件系统沙盒,但在需要时仍请求人工批准。

Terminal window
codex --approve-for-me

走自动 review + on-request + workspace-write;别名 --not-so-yolo

Terminal window
codex --dangerously-bypass-approvals-and-sandbox

同时跳过审批和沙盒,所有命令直接在宿主环境执行;别名 --yolo

Terminal window
codex --add-dir <路径>

额外开放可写目录。

Terminal window
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-onlyworkspace-writedanger-full-access
approval_policy 常见取值:untrustedon-requestnever。将审批设为 "never" 会同时关闭人工确认,不建议在宿主机上使用。

基础与会话#

/

打开当前版本支持的指令列表。

/model

切换模型和 reasoning effort。

/permissions

配置 Codex 可以做什么,以及何时需要确认。

/status

查看当前会话配置、模型、权限、token 使用情况。

/init

创建 AGENTS.md,写入 Codex 项目级指引。

/compact

压缩对话上下文,避免接近上下文上限。

/plan

切换到 Plan 模式。

/review

审查当前改动并找出问题。

/new

在当前对话中开启新聊天。

/clear

清空终端并开始新会话。

/rename

重命名当前会话。

/resume

恢复已保存的聊天。

/fork

Fork 当前聊天。

/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 是别名。

安装速查#

Terminal window
# macOS / Linux
curl -fsSL https://chatgpt.com/codex/install.sh | sh

官方安装脚本。

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

官方安装脚本。

Terminal window
npm install -g @openai/codex

npm 安装。

Terminal window
brew install --cask codex

Homebrew 安装。

常用配置与项目文件:

路径用途
~/.codex/config.toml用户配置
AGENTS.md项目级指引;/init 可生成
AGENTS.override.md本地覆盖
skills 目录中的 SKILL.mdSkills
NOTE

/rollout/test-approval 等只在 debug 构建中出现;/debug-m-drop/debug-m-update 为内部调试指令,不要日常使用。

Codex 指令速查表
https://fuwari.vercel.app/posts/codex-command-guide/
作者
Hachi
发布于
2026-07-12
许可协议
CC BY-NC-SA 4.0
A2A、ACP 与 MCP 不在同一层
Claude Code 指令速查表