命令

Codex CLI 的命令分为两类：CLI 子命令（终端直接运行）和交互式斜杠命令（会话内使用）。

CLI 子命令

在终端中直接运行的命令。

启动与会话管理

bash

# 启动交互式会话
codex

# 指定初始提示启动
codex "解释这个代码库"

# 指定模型启动
codex --model gpt-5.5

# 指定工作目录启动
codex --cd /path/to/project

# 继续上次会话
codex resume --last

# 打开会话选择器
codex resume

# 恢复指定会话
codex resume <session-id>

# Fork 一个已有会话
codex fork

# 归档当前会话并退出
codex archive

# 取消归档会话
codex unarchive <session-id>

非交互执行

bash

# 非交互执行单次任务
codex exec "修复 CI 失败"

# 非交互代码审查
codex review

# 恢复会话并继续执行
codex exec resume --last "继续实现计划"

MCP 服务器管理

bash

# 列出所有 MCP 服务器
codex mcp list

# 查看指定服务器详情
codex mcp get <name>

# 添加 MCP 服务器（STDIO）
codex mcp add <name> -- <command> [args...]

# 示例：添加 context7
codex mcp add context7 -- npx -y @upstash/context7-mcp

# 移除 MCP 服务器
codex mcp remove <name>

# OAuth 登录 MCP 服务器
codex mcp login <name>

# OAuth 登出 MCP 服务器
codex mcp logout <name>

云端任务

bash

# 打开云端任务浏览器
codex cloud

# 提交云端任务（非交互）
codex cloud exec --env <ENV_ID> "总结未解决的 Bug"

# 查看云端任务状态
codex cloud status <task-id>

# 列出云端任务
codex cloud list

# 应用云端任务的 diff
codex cloud apply <task-id>

# 查看云端任务的 diff
codex cloud diff <task-id>

其他工具

bash

# 应用最新 diff 到工作区
codex apply

# 在沙箱中执行命令
codex sandbox <command>

# 诊断安装与配置
codex doctor

# 管理插件
codex plugin [subcommand]

# 生成 Shell 补全脚本
codex completion bash
codex completion zsh
codex completion fish

# 更新 Codex CLI
codex update

# 查看功能开关
codex features list

# 启用 / 禁用功能
codex features enable <feature>
codex features disable <feature>

# 登录
codex login

# 登出
codex logout

# 查看版本
codex --version

# 查看帮助
codex --help

Shell 补全

Codex CLI 内置了 Shell 补全生成功能（基于 clap_complete），可以为子命令、参数等提供 Tab 自动补全。

支持的 Shell

Shell	说明
`bash`	Bash（Linux / macOS / Git Bash）
`zsh`	Zsh（macOS 默认 / Linux 常用）
`fish`	Fish Shell

配置方法

确保已安装 bash-completion：

bash

# macOS
brew install bash-completion

# Ubuntu / Debian
sudo apt install bash-completion

bash

# 方式一：写入补全目录（推荐）
codex completion bash > ~/.local/share/bash-completion/completions/codex
# 或
codex completion bash | sudo tee /usr/local/etc/bash_completion.d/codex

# 方式二：追加到 .bashrc（简单粗暴）
echo 'source <(codex completion bash)' >> ~/.bashrc

重新加载配置：

bash

source ~/.bashrc

验证是否生效

打开新终端，输入 codex 后按 Tab，如果能看到子命令补全提示（如 exec、resume、mcp 等），说明配置成功。

常用全局参数

参数	说明
`--model <MODEL>` / `-m`	指定模型
`-a` / `--ask-for-approval <MODE>`	审批模式
`--sandbox <POLICY>` / `-s`	沙箱策略（`read-only` / `workspace-write` / `danger-full-access`）
`--profile <NAME>` / `-p`	使用指定配置档案
`--cd <DIR>` / `-C`	指定工作目录
`--add-dir <DIR>`	添加额外可写目录
`--search`	启用实时网络搜索
`-i <FILE>` / `--image <FILE>`	附加图片到初始提示
`-c <KEY>=<VALUE>`	临时覆盖配置项
`--yolo`	危险：跳过所有确认与沙箱（等价于 `--dangerously-bypass-approvals-and-sandbox`）

交互式斜杠命令

在 Codex CLI 会话中输入 / 打开命令菜单，以下为常用命令：

会话控制

命令	说明
`/clear`	清屏并开始新对话
`/new`	当前会话中开始新对话（不清屏）
`/resume`	恢复已保存的会话
`/fork`	Fork 当前对话到新线程
`/side` / `/btw`	开始临时的侧线对话（不影响主线程）
`/archive`	归档当前会话并退出
`/quit` / `/exit`	退出 CLI

模型与推理

命令	说明
`/model`	选择模型与推理强度
`/fast`	切换 Fast 服务层级（如支持）
`/personality`	选择沟通风格（`friendly` / `pragmatic` / `none`）

权限与沙箱

命令	说明
`/permissions`	设置审批策略（Auto / Read Only / Full Access）
`/approve`	批准一次被自动审查拒绝的操作
`/experimental`	切换实验性功能开关

工作流与工具

命令	说明
`/plan`	进入计划模式，要求先生成执行计划
`/goal`	设置 / 查看 / 暂停 / 清除长任务目标
`/review`	代码审查当前工作区
`/diff`	显示 Git diff（包含未跟踪文件）
`/compact`	总结对话历史以释放上下文空间
`/init`	生成 `AGENTS.md` 脚手架
`/mention`	引用文件到对话中
`/copy`	复制最后一条 Codex 输出（等价于 `Ctrl + O`）

MCP 与扩展

命令	说明
`/mcp`	列出已配置的 MCP 工具（加 `verbose` 显示详情）
`/apps`	浏览 Apps / 连接器
`/plugins`	浏览插件市场
`/skills`	浏览并使用本地技能
`/hooks`	查看生命周期钩子配置
`/ide`	包含当前 IDE 的打开文件与选中内容

配置与调试

命令	说明
`/status`	显示会话配置与 Token 使用情况
`/debug-config`	显示配置层级与策略来源（调试用）
`/statusline`	配置状态栏显示项
`/title`	配置终端标题显示项
`/theme`	选择语法高亮主题
`/keymap`	重新映射 TUI 快捷键
`/vim`	切换 Vim 编辑模式
`/raw`	切换原始滚动模式
`/memories`	配置记忆生成与使用

后台任务

命令	说明
`/ps`	列出后台终端及其最近输出
`/stop` / `/clean`	停止所有后台终端

其他

命令	说明
`/agent`	切换到子 Agent 线程
`/feedback`	发送日志给维护者
`/logout`	登出 Codex

命令排队

任务运行中输入斜杠命令后按 Tab 可将其排队到下一回合，而不是立即执行。

自定义提示命令（已弃用）

自定义提示命令（Custom Prompts）功能已弃用，推荐使用 Skills 替代可复用指令。

如需临时使用旧功能，可在 ~/.codex/prompts/ 目录下创建 Markdown 文件，文件名即为命令名：

bash

mkdir -p ~/.codex/prompts

示例： ~/.codex/prompts/draftpr.md

markdown

---
description: 准备分支、提交并打开草稿 PR
argument-hint: [FILES=] [PR_TITLE=""]
---

根据当前分支的改动创建一个 Pull Request：

文件范围：$FILES
PR 标题：$PR_TITLE

使用时：

/prompts:draftpr FILES="src/index.ts" PR_TITLE="添加新功能"

已弃用

此功能仅在老版本中支持，新版 Codex CLI 推荐使用 Skills 替代，详见 Skills 文档。

命令 ​

CLI 子命令 ​

启动与会话管理 ​

非交互执行 ​

MCP 服务器管理 ​

云端任务 ​

其他工具 ​

Shell 补全 ​

支持的 Shell ​

配置方法 ​

常用全局参数 ​

交互式斜杠命令 ​

会话控制 ​

模型与推理 ​

权限与沙箱 ​

工作流与工具 ​

MCP 与扩展 ​

配置与调试 ​

后台任务 ​

其他 ​

自定义提示命令（已弃用） ​

相关链接 ​

命令

CLI 子命令

启动与会话管理

非交互执行

MCP 服务器管理

云端任务

其他工具

Shell 补全

支持的 Shell

配置方法

常用全局参数

交互式斜杠命令

会话控制

模型与推理

权限与沙箱

工作流与工具

MCP 与扩展

配置与调试

后台任务

其他

自定义提示命令（已弃用）

相关链接