最新官方Codex命令速查手册：无废话速查大全版

数码系统

相机 win10

测评 win11

手机智车

华为 Tesla

小米理想

苹果蔚来

游戏软件

LOL 抖音

原神微信

当前位置：首页

AI教程

最新官方Codex命令速查手册：无废话速查大全版

热心网友时间：2026-06-26

转载

前言

前几天写了篇关于 Claude Code 的文章，反馈还不错。既然 Codex 同样值得一用——便宜、量大、管饱——那就趁热打铁，把 Codex 的命令手册也整理出来。速查方便，用的时候随手翻。

一、安装

系统要求

macOS 12+、Ubuntu 20.04+、Windows 11 (WSL2)，Git 2.23+，最低 4GB 内存。

安装方式

# npm 全局安装
npm install -g @openai/codex

# Homebrew 安装（macOS）
brew install --cask codex

# 直接下载二进制（GitHub Release）
# macOS ARM: codex-aarch64-apple-darwin.tar.gz
# macOS x86: codex-x86_64-apple-darwin.tar.gz
# Linux x86: codex-x86_64-unknown-linux-musl.tar.gz
# Linux ARM: codex-aarch64-unknown-linux-musl.tar.gz

# DotSlash（仓库根目录的版本固定可执行文件）

# 从源码编译
git clone https://github.com/openai/codex.git && cd codex/codex-rs && cargo build

# 桌面应用
codex app

二、认证命令

命令	作用	使用场景
`codex login`	浏览器 OAuth 登录 ChatGPT 账号	首次使用，有 Plus/Pro/Team/Business/Edu/Enterprise 订阅
`codex login --device-auth`	设备码流程登录（无浏览器环境）	SSH 远程服务器、容器内
`codex login --with-api-key`	从 stdin 读取 API Key 登录	CI/CD、自动化脚本
`codex login status`	查看当前认证状态	检查是否已登录
`codex logout`	清除已保存的认证凭据	切换账号、退出登录

# 示例
codex login                                        # 浏览器登录
printenv OPENAI_API_KEY | codex login --with-api-key # API Key 登录
codex login status                                  # 检查登录状态

三、核心命令

3.1 交互式 TUI

命令	作用	使用场景
`codex`	启动交互式终端 UI	日常开发，人机协作编码
`codex "你的提示"`	带初始提示启动 TUI	直接指定任务，省去输入步骤
`codex -i image.png "分析这张图"`	附带图片启动	分析截图、UI 设计稿、架构图

3.2 非交互执行（CI/脚本用）

命令	作用	使用场景
`codex exec "任务"`	非交互模式执行任务，输出到 stdout（别名 `codex e`）	CI/CD 流水线、批量自动化
`codex exec --json "任务"`	输出 JSONL 格式事件流（别名 `--experimental-json`）	程序化解析执行结果
`codex exec -o result.txt "任务"`	将最终回复写入文件	下游脚本消费执行结果
`codex exec --output-schema schema.json "任务"`	按 JSON Schema 校验输出	需要结构化输出的场景
`echo "任务" \| codex exec -`	从 stdin 管道读取任务	与其他命令管道组合

`codex exec resume` 子命令

命令	作用	使用场景
`codex exec resume`	交互选择历史执行会话恢复	续跑之前的执行
`codex exec resume --last`	恢复最近一次执行	CI 续跑
`codex exec resume --all`	跨目录恢复执行会话	查找所有历史执行
`codex exec resume --last --all`	跨目录恢复最近执行	在不同目录下恢复
`codex exec resume`	恢复指定 ID 的执行	精确恢复
`codex exec resume --last "继续"`	恢复并附带新指令	在上次基础上追加任务
`codex exec resume -i img.png --last "看这个"`	恢复并附加图片	带新截图继续

3.3 会话管理

命令	作用	使用场景
`codex resume`	恢复历史会话（交互选择）	继续之前中断的对话
`codex resume --last`	恢复最近一次会话	快速回到上次对话
`codex resume --all`	列出所有目录的会话	查找历史会话
`codex resume --last --all`	跨目录恢复最近会话	在不同目录下恢复
`codex resume`	恢复指定 ID 的会话	精确恢复某个会话
`codex fork`	分叉历史会话为新线程	基于之前对话另起一个方向探索
`codex fork --last`	分叉最近一次会话	快速分叉
`codex fork --all`	显示所有目录的会话	查找会话
`codex fork`	分叉指定会话	精确分叉

3.4 Cloud 任务

命令	作用	使用场景
`codex cloud`	浏览/执行 Cloud 任务（别名 `codex cloud-tasks`）	管理 Codex Cloud 远程任务
`codex cloud exec --env "任务"`	提交 Cloud 任务	在云端环境执行任务
`codex cloud exec --env --attempts 3 "任务"`	提交任务并指定重试次数（1-4）	提高云任务成功率
`codex cloud list`	列出最近 Cloud 任务	查看任务状态
`codex cloud list --json`	JSON 格式列出任务	脚本化查询
`codex cloud list --env`	按环境筛选任务	查看特定环境任务
`codex cloud list --limit 20`	限制返回数量（1-20）	控制输出条数
`codex cloud list --cursor`	分页游标	翻页查询
`codex apply`	将 Cloud 任务 diff 应用到本地（别名 `codex a`）	拉取云端生成的代码改动

3.5 桌面应用

命令	作用	使用场景
`codex app`	启动 Codex 桌面应用	偏好 GUI 体验
`codex app /path/to/project`	打开指定工作区的桌面应用	直接打开项目目录
`codex app --download-url`	覆盖安装包下载地址	内网/镜像安装

四、全局 Flags

4.1 模型与配置

Flag	类型	作用	使用场景
`-m, --model`	string	指定模型	`codex -m gpt-5.5`，切换模型
`-p, --profile`	string	加载配置 profile	多环境/多项目配置切换
`-c, --config key=value`	key=value	覆盖配置项（可重复）	临时覆盖 `~/.codex/config.toml`
`--oss`	bool	使用本地 Ollama 模型（等同 `-c model_provider="oss"`）	无网络、私有部署、成本控制
`--enable`	string	启用 feature flag（等同 `-c features.=true`）	开启实验性功能
`--disable`	string	禁用 feature flag（等同 `-c features.=false`）	关闭某功能
`--no-alt-screen`	bool	禁用 TUI 备用屏幕	终端兼容性问题

# 示例
codex -m gpt-5.5 "重构这个模块"     # 指定模型
codex -p work "修复bug"             # 使用 work profile
codex -c model_provider="oss" "写个脚本"  # 临时用 Ollama

4.2 审批与沙箱

Flag	类型	作用	使用场景
`-a, --ask-for-approval`	untrusted / on-request / never	控制命令审批策略	见下表
`-s, --sandbox`	read-only / workspace-write / danger-full-access	沙箱安全策略	见下表
`--yolo`	bool	跳过所有审批和沙箱（等同 `--dangerously-bypass-approvals-and-sandbox`）	仅在隔离环境中使用
`--add-dir`	path	额外授权目录写权限（可重复）	需要操作工作区外的目录

审批模式：

模式	行为	场景
`untrusted`	每条命令都要审批	不可信输入、敏感项目
`on-request`	仅在需要时请求审批（默认推荐）	日常开发
`never`	全自动，不暂停	CI/CD、已信任的环境

沙箱策略：

策略	行为	场景
`read-only`	只读，不能修改文件	代码审查、分析
`workspace-write`	可写工作区，不能写外部	日常开发（推荐）
`danger-full-access`	无限制	需要 sudo、写系统目录

# 推荐组合：日常开发
codex -s workspace-write -a on-request "重构登录模块"

# CI 自动化
codex exec -s workspace-write -a never "运行测试并修复失败用例"

# 只读分析
codex -s read-only "分析这个项目的架构"

4.3 输入与搜索

Flag	类型	作用	使用场景
`-i, --image`	path（逗号分隔或重复指定）	附加图片	分析截图、设计稿
`--search`	bool	启用实时网络搜索（live 模式）	需要查最新文档/API
`PROMPT`	string	直接传提示文本	`codex "写个爬虫"`
`-C, --cd`	path	指定工作目录	不想 cd 到目标目录

4.4 远程连接

Flag	类型	作用	使用场景
`--remote ws://host:port`	URL	连接远程 app-server	本地 TUI 操作远程服务
`--remote wss://host:port`	URL	TLS 加密远程连接	安全要求高的远程连接
`--remote-auth-token-env`	ENV_VAR	远程认证 Token 环境变量	带鉴权的远程连接

# 本地启动 server
codex app-server --listen ws://0.0.0.0:8080

# 另一台机器连接
codex --remote ws://192.168.1.100:8080

五、辅助命令

5.1 功能管理

命令	作用	使用场景
`codex features list`	列出所有 feature flags 及成熟度、生效状态	查看可用实验功能
`codex features enable`	持久启用 feature flag	开启某功能
`codex features disable`	持久禁用 feature flag	关闭某功能

5.2 MCP 服务器管理

命令	作用	使用场景
`codex mcp list`	列出已配置的 MCP 服务器	查看当前 MCP 配置
`codex mcp list --json`	JSON 格式列出	脚本化查询
`codex mcp add --`	添加 stdio MCP 服务器	集成本地工具
`codex mcp add --env KEY=VALUE --`	带环境变量添加 stdio MCP	需要传入密钥等环境变量
`codex mcp add --url`	添加 Streamable HTTP MCP 服务器	集成远程 API
`codex mcp add --url --bearer-token-env-var`	带 Token 认证的 HTTP MCP	需要鉴权的远程 MCP
`codex mcp get`	查看指定 MCP 服务器配置	排查 MCP 问题
`codex mcp get --json`	JSON 格式查看配置	脚本化排查
`codex mcp remove`	删除 MCP 服务器	清理不再需要的 MCP
`codex mcp login`	OAuth 登录 MCP 服务器	需要认证的 MCP
`codex mcp login --scopes scope1,scope2`	指定 OAuth scopes 登录	控制授权范围
`codex mcp logout`	退出 MCP 服务器认证	切换 MCP 认证
`codex mcp-server`	将 Codex 自身作为 MCP 服务器运行（stdio）	让其他 Agent 调用 Codex

# 示例：添加本地 MCP
codex mcp add my-tool -- npx @my/mcp-server

# 示例：带环境变量
codex mcp add db-tool --env DB_URL=postgres://... -- npx @my/db-mcp

# 示例：添加远程 MCP
codex mcp add remote-api --url https://mcp.example.com/sse

# 示例：带认证的远程 MCP
codex mcp add secure-api --url https://mcp.example.com/sse --bearer-token-env-var API_TOKEN

5.3 插件市场

命令	作用	使用场景
`codex plugin marketplace add`	添加插件市场源（GitHub 简写/Git URL/SSH URL/本地目录）	安装社区插件
`codex plugin marketplace add --ref main`	指定分支/标签	安装特定版本
`codex plugin marketplace add --sparse path/to/dir`	稀疏检出指定路径	只安装部分插件
`codex plugin marketplace upgrade [name]`	更新指定或所有插件市场	获取最新插件
`codex plugin marketplace remove`	移除插件市场	清理

5.4 Shell 补全

命令	作用	使用场景
`codex completion bash`	生成 Bash 补全脚本	Bash 用户
`codex completion zsh`	生成 Zsh 补全脚本	Zsh 用户
`codex completion fish`	生成 Fish 补全脚本	Fish 用户
`codex completion power-shell`	生成 PowerShell 补全脚本	Windows 用户
`codex completion elvish`	生成 Elvish 补全脚本	Elvish 用户

# Zsh 补全安装
codex completion zsh > "${fpath[1]}/_codex"

5.5 其他

命令	作用	使用场景
`codex update`	检查并更新 Codex CLI	版本升级
`codex sandbox --`	在沙箱中执行命令	调试沙箱策略
`codex debug models`	打印可用模型列表	查看支持的模型
`codex debug models --bundled`	只显示内置模型目录（跳过刷新）	离线查看
`codex debug app-server send-message-v2`	向 V2 测试客户端发送消息	调试 app-server
`codex execpolicy check --rules --`	检查命令是否会被策略允许/阻止	调试执行策略
`codex execpolicy check --rules --pretty --`	美化输出 JSON 结果	可读性更好的调试

`codex sandbox` 平台特定 flags

Flag	平台	作用
`--permissions-profile`	全平台	使用命名权限配置
`--include-managed-config`	全平台	包含托管配置要求
`--cd`	全平台	设置工作目录（需配合 `--permissions-profile`）
`--allow-unix-socket`	macOS	允许 Unix Socket 访问（可重复）
`--log-denials`	macOS	通过 `log stream` 捕获沙箱拒绝日志

六、App Server 命令

命令	作用	使用场景
`codex app-server --listen stdio://`	JSONL-over-stdio 模式启动	程序化调用
`codex app-server --listen ws://IP:PORT`	WebSocket 模式启动	远程连接、多人协作
`codex app-server --ws-auth capability-token --ws-token-file`	共享 Token 认证	简单鉴权
`codex app-server --ws-auth signed-bearer-token --ws-shared-secret-file`	JWT 签名认证	安全鉴权
`codex app-server --ws-audience`	指定期望的 JWT aud 声明	JWT 校验
`codex app-server --ws-issuer`	指定期望的 JWT iss 声明	JWT 校验
`codex app-server --ws-max-clock-skew-seconds`	JWT 时钟偏差容忍秒数	时间不同步的服务器
`codex app-server --experimental`	在生成 schema 中包含门控字段	实验性功能

七、`codex exec` 完整 Flags

Flag	作用
`-C, --cd`	设置工作目录
`-m, --model`	覆盖模型
`-s, --sandbox`	沙箱策略
`-a, --ask-for-approval`	审批模式
`-i, --image`	附加图片（逗号分隔或重复指定）
`-c, --config key=value`	覆盖配置（可重复）
`-p, --profile`	选择 profile
`-o, --output-last-message`	输出最终消息到文件
`--json` / `--experimental-json`	JSONL 格式输出
`--output-schema`	输出 JSON Schema 校验
`--ephemeral`	不持久化会话文件
`--oss`	使用本地 Ollama
`--yolo`	跳过审批和沙箱（危险）
`--full-auto`	⚠️ 已废弃，请用 `-s workspace-write` 替代
`--color always/never/auto`	控制颜色输出
`--skip-git-repo-check`	允许非 Git 目录执行
`--ignore-rules`	不加载 .rules 文件
`--ignore-user-config`	不加载用户配置

八、TUI 内部斜杠命令

8.1 会话管理

命令	作用
`/clear`	清屏并开始新对话
`/compact`	压缩对话释放 token
`/fork`	分叉当前对话为新线程
`/side`	开启临时侧边对话
`/resume`	从历史记录恢复对话
`/new`	同会话开始新对话
`/exit` / `/quit`	退出 CLI

8.2 工作模式

命令	作用
`/permissions`	设置审批模式：Auto / Read Only / Full Access
`/plan [prompt]`	切换到计划模式
`/fast on\|off\|status`	切换 Fast 模式（支持的模型）
`/model`	切换模型和推理强度
`/personality friendly\|pragmatic\|none`	选择沟通风格
`/yolo`	切换完全访问模式（非官方文档命令）

8.3 审查与分析

命令	作用
`/review`	审查工作树（基础分支 / 未提交 / 指定 commit / 自定义指令）
`/diff`	显示 git diff（含未跟踪文件）
`/status`	显示会话配置、模型、token 用量

8.4 文件与上下文

命令	作用
`/mention`	附加文件/文件夹到对话
`/copy`	复制最近完成的输出到剪贴板（等同 Ctrl+O）

8.5 Agent 与多线程

命令	作用
`/agent`	切换活跃 agent/子 agent 线程

8.6 后台进程

命令	作用
`/ps`	显示后台终端和最近输出
`/stop` / `/clean`	停止所有后台终端

8.7 应用、插件与 Skill

命令	作用
`/apps`	浏览并插入应用连接器（`$app-slug`）
`/plugins`	浏览已安装/可发现的插件
`/skills`	浏览并选择可用的 Skill（代码审查、文档生成等预制能力）

8.8 MCP

命令	作用
`/mcp`	列出 MCP 工具，加 `verbose` 显示服务器详情

8.9 目标跟踪（实验性）

命令	作用
`/goal`	设置/查看实验性目标（需 `features.goals`）
`/goal pause`	暂停目标跟踪
`/goal resume`	恢复目标跟踪
`/goal clear`	清除当前目标

8.10 配置与诊断

命令	作用
`/init`	生成 `AGENTS.md` 脚手架
`/debug-config`	打印配置层和策略诊断
`/statusline`	交互式配置 TUI 底部状态栏字段
`/title`	配置终端窗口/标签页标题字段
`/keymap`	重映射 TUI 键盘快捷键
`/theme`	主题选择器（自定义 `.tmTheme` 放在 `$CODEX_HOME/themes/`）
`/experimental`	切换实验性功能
`/logout`	在 TUI 中登出

8.11 其他

命令	作用
`/feedback`	发送日志/诊断信息给维护者
`/sandbox-add-read-dir`	授予沙盒额外读权限（仅 Windows）

九、TUI 键盘快捷键

快捷键	作用
`Tab`	任务运行时队列 follow-up 输入
`Enter`（运行中）	注入指令到当前轮
`Esc` `Esc`（空输入框）	编辑上一条用户消息
`Ctrl+C`	退出交互式会话
`Ctrl+G`	打开外部编辑器（`$VISUAL` 或 `$EDITOR`）
`Ctrl+L`	清屏（保留对话，区别于 `/clear`）
`Ctrl+O`	复制最近完成的输出
`Ctrl+R`	搜索提示历史
`Up` / `Down`	浏览历史草稿
`! <命令>`	在 TUI 中直接执行本地 shell 命令（如 `!ls`、`!git status`）

十、配置文件

路径	作用
`~/.codex/config.toml`	全局配置（模型、沙箱、MCP 等）
`~/.codex/rules/`	执行策略规则文件目录
`~/.codex/sessions/`	会话持久化存储目录
`~/.codex/themes/`	自定义 TUI 主题（`.tmTheme` 文件）
`AGENTS.md`	项目级持久指令（放在项目根目录或任意父目录）

# 配置示例 config.toml
[model]
name = "gpt-5.5"

[sandbox]
policy = "workspace-write"

[approval]
mode = "on-request"

# 其他可用配置项
# web_search = "live"          # 搜索模式：cached / live / disabled
# review_model = "gpt-5.5"     # /review 命令使用的模型
# log_dir = "/tmp/codex"       # 日志目录覆盖

十一、环境变量

变量	作用
`CODEX_HOME`	覆盖 Codex 主目录（默认 `~/.codex`）
`OPENAI_API_KEY`	API 密钥认证（ChatGPT 登录的替代方案）
`RUST_LOG`	日志级别（`error` / `warn` / `info` / `debug` / `trace`），`codex exec` 默认 `error`
`$VISUAL` / `$EDITOR`	Ctrl+G 外部编辑器

十二、可用模型

模型	说明
`gpt-5.5`	最新前沿模型，官方推荐
`gpt-5.4`	通用模型
`gpt-5.3-Codex-Spark`	研究预览，仅 ChatGPT Pro
`gpt-4.1`	上代模型
`gpt-4.1-mini`	轻量版
`gpt-image-2`	内置图片生成

完整列表可通过 codex debug models 查看。

十三、常用组合速查

场景	命令
日常开发（推荐）	`codex -s workspace-write -a on-request`
全自动本地执行	`codex -s workspace-write -a never`
带任务的快速启动	`codex "帮我梳理这个仓库"`
指定项目目录启动	`codex -C ./my-project`
只读代码审查	`codex -s read-only "审查这个PR"`
CI 自动修复测试	`codex exec -s workspace-write -a never --json "修复失败测试"`
执行并保存结果	`codex exec -o result.txt "总结这个仓库"`
带搜索的研究	`codex --search "调研 React Server Components 最佳实践"`
用本地模型	`codex --oss "写个排序算法"`
远程开发	`codex --remote ws://dev-server:8080`
分析截图	`codex -i screenshot.png "这个页面有什么问题"`
恢复上次对话	`codex resume --last`
跨目录恢复	`codex resume --last --all`
分叉探索	`codex fork --last`
查看可用模型	`codex debug models`
更新版本	`codex update`
CI 续跑上次执行	`codex exec resume --last`
提交云任务	`codex cloud exec --env my-env "重构模块"`
拉取云任务结果	`codex apply`
初始化项目指令	在 TUI 中输入 `/init`
释放 token	在 TUI 中输入 `/compact`
切换计划模式	在 TUI 中输入 `/plan`
浏览可用 Skill	在 TUI 中输入 `/skills`
管理子袋里线程	在 TUI 中输入 `/agent`
切换模型	在 TUI 中输入 `/model`
切换快速模式	在 TUI 中输入 `/fast on`

十四、命令成熟度总览

Stable（稳定）

codex、codex exec、codex resume、codex fork、codex login、codex logout、codex apply、codex app、codex features、codex completion、codex update