codex-cli常用指令归纳

John Doe2026-10-152026-10-15

Codex CLI 常用指令速查手册

更新：2026-10-15 ｜适用：Windows PowerShell、Linux、WSL、VS Code 集成终端。

本文针对 Codex CLI 终端版。Codex 桌面应用与 VS Code 扩展的部分操作在图形界面完成。可用命令以本机 codex --help 和交互界面的 /help 为准。

1. 最常用的 10 条命令

场景	命令	说明
启动	`codex`	在当前目录开始会话
查看版本	`codex --version`	确认安装版本
查看帮助	`codex --help`	查看本机支持的参数
恢复最近对话	`codex resume --last`	恢复最近一次会话
选择历史对话	`codex resume`	从历史列表选择
跨目录查看历史	`codex resume --all`	查看其他目录的会话
恢复跨目录最近会话	`codex resume --last --all`	忽略当前目录限制
登录	`codex login`	登录 Codex
检查登录状态	`codex login status`	检查是否已登录
升级 npm 安装版	`npm install -g @openai/codex@latest`	更新到最新 npm 正式版

2. 安装、升级、启动

# 安装（已安装者不必重复）
npm install -g @openai/codex

# 升级
npm install -g @openai/codex@latest

# 确认版本
codex --version

# 查看所有入口
codex --help

# 当前项目启动
codex

# 直接附带任务启动
codex "分析当前项目结构，先不要修改文件"

# 指定工作目录启动（按实际路径修改）
codex -C /path/to/project

Windows PowerShell 示例：

1 2	cd D:\Hexo-demo1\blog-demo codex

Linux/WSL 示例：

1 2	cd ~/projects/my-project codex

安装失败时先检查 node -v、npm -v，并确认 Codex 可执行文件在 PATH 中。若使用 Homebrew 安装，应采用对应的 Homebrew 更新方式，不要混用包管理器。

3. 恢复历史会话（重点）

codex resume                 # 选择当前目录的历史对话
codex resume --last          # 当前目录最近一次对话
codex resume --all           # 显示所有目录的对话
codex resume --last --all    # 所有目录最近一次对话
codex resume <SESSION_ID>    # 按会话 ID 恢复

使用建议：先进入原项目目录，再执行 codex resume --last，以免在错误目录操作代码。

常见本地会话目录：

Linux/WSL：~/.codex/sessions/
Windows PowerShell：$HOME\.codex\sessions\

若设置过 CODEX_HOME，实际位置可能改变。Windows、WSL 和远程 Linux 各有独立的用户目录，不一定共享历史。

4. 登录、退出与身份验证故障

codex login            # 登录
codex login status     # 查看登录状态
codex logout           # 登出
codex login --help     # 查看当前版本可用登录方式

如果遇到 refresh token was revoked 或访问令牌无法刷新：

先退出当前 Codex 会话。
执行 codex logout。
执行 codex login 重新认证。
执行 codex login status 检查是否成功。

不要将 API Key 或登录令牌放进公开仓库、截图或日志。

5. 交互会话中的斜杠命令

以下命令在 进入 codex 后 输入，不是 PowerShell / Bash 的普通命令。不同版本与运行环境可能有所差异，先输入 / 或 /help 查看可用项。

命令	用途
`/help`	查看交互命令帮助（若当前版本支持）
`/status`	查看会话、模型、工作区等状态
`/model`	切换模型 / 推理设置（依可用版本而定）
`/review`	请求代码审查
`/compact`	压缩过长的对话上下文
`/plan`	切换规划模式（支持时）
`/goal <目标>`	创建持续目标（支持时）
`/goal pause`	暂停持续目标
`/goal resume`	继续持续目标
`/goal clear`	清除持续目标
`/fork`	从当前上下文分叉新会话（支持时）
`/fast`	切换速度模式（支持时）
`/feedback`	提交反馈

例：

/status
/review
/compact
/goal 修复项目中的测试失败，并在全部测试通过后结束

/goal resume 用于暂停的 Goal，不同于终端中的 codex resume（恢复历史聊天）。

6. 模型、权限及配置

codex --help
codex -m <MODEL_ID>                   # 指定模型（具体 ID 取决于当前支持情况）
codex -C /path/to/project            # 指定工作目录
codex --sandbox workspace-write      # 限定工作区写入
codex --sandbox read-only            # 只读沙盒
codex --ask-for-approval on-request  # 需要时请求批准（若版本支持）

常见用户配置路径：

Linux/WSL：~/.codex/config.toml
Windows：$HOME\.codex\config.toml

示例配置（将模型 ID 替换为当前可用型号）：

1
2
3

model = "<MODEL_ID>"
approval_policy = "on-request"
sandbox_mode = "workspace-write"

workspace-write 比全盘开放权限更适合日常开发。不要为了省去确认就随意关闭审批和沙盒；联网、敏感文件和系统命令可能带来风险。

7. 非交互批量任务

# 一次性分析任务，输出到终端
codex exec "阅读这个仓库，解释主要模块和启动流程"

# 让 Codex 自动执行某项检查
codex exec "检查代码中的潜在异常处理问题，给出修改建议"

# 查看批处理参数
codex exec --help

# 输出机器可读的事件流（如当前版本支持）
codex exec --json "总结当前项目结构"

适用于脚本、自动化和不需要持续对话的检查任务。

8. MCP 扩展管理

codex mcp --help         # 查看 MCP 命令
codex mcp list           # 列出已配置的 MCP 服务器
codex mcp add --help     # 查看添加服务器的参数
codex mcp remove --help  # 查看删除服务器的参数

MCP 可将 Codex 连接到额外工具。请只添加可信服务器，检查其文件与网络权限。

9. 快速排障

A. 提示 codex 不是命令

1
2
3

node -v
npm -v
npm list -g @openai/codex --depth=0

确认 npm 全局安装目录已加入 PATH，然后重开终端。

B. 网络或代理不通

Linux/WSL 检查：

1	env \| grep -i proxy

PowerShell 检查：

1	Get-ChildItem Env:PROXY

临时环境变量只在当前终端有效。不要将代理地址写死到公开配置文件；使用内网代理时还要保证对应主机和端口可达。

C. 找不到历史对话

1	codex resume --all

再检查是否切换了 Windows / WSL / SSH 主机、用户账户或 CODEX_HOME。原主机本地保存的会话通常不会自动迁移到新主机。

D. 版本太旧或命令不支持

1
2
3

npm install -g @openai/codex@latest
codex --version
codex --help

10. 推荐工作流程

首次进入项目：

1 2	cd /path/to/project codex

在会话中可以这样提问：

1	先阅读项目结构与 README，给出实施计划，不要立即修改文件。

第二天继续：

1 2	cd /path/to/project codex resume --last

完工前：

/review

要求 Codex 展示实际修改文件、执行的测试、剩余风险，再自行检查 Git 差异。

官方资料

提示： Codex 更新较快；若本文和你本机的帮助输出冲突，以 codex --help、codex <子命令> --help 和实际版本为准。