Codex IDE 扩展命令
开发者命令
ChatGPT 桌面应用、Codex CLI 和 Codex IDE 扩展的命令与斜杠命令参考。
ChatGPT 网页版命令
ChatGPT 网页版有自己的输入框命令菜单。输入 / 可查看当前聊天中
可用的操作。它不提供 ChatGPT 桌面应用或 CLI
命令集；本参考中的 Codex 斜杠命令、CLI 子命令和标志
不适用于 ChatGPT 网页版。
ChatGPT 桌面应用命令
通用的命令页面涵盖应用导航、 聊天快捷键、键盘自定义，以及聊天、设置、 技能、计划任务、插件和宠物的深层链接。
斜杠命令页面介绍输入框中
可用的命令，包括 /feedback、/goal、/init、
/mcp、/plan、/review 和 /status。
Codex CLI 命令参考
如何阅读本参考
本页面列出了所有已记录的 Codex CLI 命令和标志。使用交互式表格可按键名或说明搜索。每个部分都会指出选项是稳定功能还是实验性功能，并特别说明有风险的组合。
全局标志
| 键 | 类型/值 | 详情 |
|---|---|---|
--add-dir |
path |
除主工作区外，再授予其他目录写入权限。可重复使用以指定多个路径。 |
--ask-for-approval, -a |
untrusted | on-request | never |
控制 Codex 在运行命令前何时暂停并请求人工批准。 |
--cd, -C |
path |
设置智能体开始处理请求前的工作目录。 |
--config, -c |
key=value |
覆盖配置值。可以解析为 TOML 时按 TOML 解析，否则使用原始字符串。 |
--dangerously-bypass-approvals-and-sandbox, --yolo |
boolean |
运行所有命令时跳过批准和沙箱。仅可在经过外部强化的环境中使用。 |
--dangerously-bypass-hook-trust |
boolean |
在本次调用中运行已启用的钩子，无需持久保存钩子信任。仅适用于已审查钩子来源的自动化流程。 |
--disable |
feature |
强制禁用功能标志（转换为 -c features.<name>=false）。可重复使用。 |
--enable |
feature |
强制启用功能标志（转换为 -c features.<name>=true）。可重复使用。 |
--image, -i |
path[,path...] |
将一个或多个图片文件附加到初始提示词。多个路径可用逗号分隔，也可重复使用该标志。 |
--local-provider |
lmstudio | ollama |
选择与 --oss 搭配使用的本地提供商，并在本次运行中覆盖 oss_provider。 |
--model, -m |
string |
覆盖配置中设置的模型（例如 gpt-5.6-terra）。 |
--no-alt-screen |
boolean |
禁用 TUI 的备用屏幕模式（在本次运行中覆盖 tui.alternate_screen）。 |
--oss |
boolean |
使用本地开源模型提供商。Codex 会使用 --local-provider、你配置的 oss_provider，或提示你在 LM Studio 和 Ollama 之间选择。 |
--profile, -p |
string |
在基础用户配置之上叠加 $CODEX_HOME/profile-name.config.toml。 |
--remote |
ws://host:port | wss://host:port | unix:// | unix://PATH |
通过 WebSocket 或 Unix 套接字连接远程 app-server 端点。codex、codex resume、codex fork、codex archive、codex delete 和 codex unarchive 支持此功能；其他子命令会拒绝远程模式。 |
--remote-auth-token-env |
ENV_VAR |
从此环境变量读取持有者令牌，并在通过 --remote 连接时发送。需要 --remote；令牌仅通过 wss:// URL 或仅限本地的 ws:// URL 发送。 |
--sandbox, -s |
read-only | workspace-write | danger-full-access |
选择模型生成的 shell 命令所采用的沙箱策略。 |
--search |
boolean |
启用实时网页搜索（设置 web_search = "live"，而非默认的 "cached"）。 |
--strict-config |
boolean |
当 config.toml 包含此 Codex 版本无法识别的字段时报错。codex、exec、review、resume、fork、app-server、mcp-server 和 exec-server 等运行时命令支持此功能。 |
PROMPT |
string |
用于启动会话的可选文本指令。省略时将启动 TUI，且不预填消息。 |
这些选项适用于基础 codex 命令。大多数选项会传播到其他命令；
例外情况请参阅上面的说明或相关命令的帮助。对于传播的
标志，请遵循相关命令的帮助。例如，codex exec --oss ...
会将 --oss 应用于 exec。
命令概览
| 键 | 成熟度 | 详情 |
|---|---|---|
codex |
稳定 | 启动终端界面。接受上述全局标志，以及可选的提示词或图片附件。 |
codex app |
稳定 | 在 macOS 或 Windows 上启动 ChatGPT 桌面应用。在 macOS 上，Codex 可以打开工作区路径；在 Windows 上，Codex 会输出要打开的路径。 |
codex app-server |
实验性 | 启动 Codex app server，以便通过 stdio、WebSocket 或 Unix 套接字进行本地开发或调试。 |
codex apply |
稳定 | 将 Codex 云端聊天生成的最新差异应用到本地工作树。别名：codex a。 |
codex archive |
稳定 | 按会话 ID 或会话名称归档已保存的交互式会话。 |
codex cloud |
实验性 | 无需打开 TUI，即可从终端浏览或执行 Codex 云端聊天。别名：codex cloud-tasks。 |
codex completion |
稳定 | 为 Bash、Zsh、Fish 或 PowerShell 生成 shell 补全脚本。 |
codex debug app-server send-message-v2 |
实验性 | 通过内置测试客户端发送一条 V2 消息来调试 app-server。 |
codex debug models |
实验性 | 输出 Codex 所看到的原始模型目录，并可选择仅检查内置目录。 |
codex debug prompt-input |
实验性 | 将模型可见的提示词输入列表呈现为 JSON，可选择附带提示词和图片。 |
codex delete |
稳定 | 按会话 ID 或会话名称永久删除已保存的交互式会话。 |
codex doctor |
稳定 | 针对本地安装、配置、身份验证、运行时、Git、终端、app-server 和线程清单问题生成诊断报告。 |
codex exec |
稳定 | 以非交互方式运行 Codex。别名：codex e。将结果流式传输到 stdout 或 JSONL，并可选择恢复之前的会话。 |
codex execpolicy |
实验性 | 评估 execpolicy 规则文件，查看命令会被允许、要求确认还是阻止。 |
codex features |
稳定 | 列出功能标志，并在 config.toml 中持久启用或禁用它们。 |
codex fork |
稳定 | 将之前的交互式会话分叉为新聊天，同时保留原始对话记录。 |
codex login |
稳定 | 使用 ChatGPT OAuth、设备身份验证、API key 或通过 stdin 传入的访问令牌对 Codex 进行身份验证。 |
codex logout |
稳定 | 删除已存储的身份验证凭据。 |
codex mcp |
稳定 | 管理 Model Context Protocol 服务器（列出、添加、删除、身份验证）。 |
codex mcp-server |
已弃用 | 通过 stdio 将 Codex 作为 MCP server 运行的已弃用接口。请改用 Codex app server。若要在 Claude Code 中调用 Codex，请使用 Codex plugin for Claude Code。 |
codex plugin |
稳定 | 从已配置的市场源安装、列出和删除插件。 |
codex plugin marketplace |
稳定 | 从 Git 或本地源添加、列出、升级或删除插件市场。 |
codex remote-control |
实验性 | 运行或管理本地 app-server 的远程控制，或创建短期有效的配对码。 |
codex resume |
稳定 | 按 ID 继续之前的交互式会话，或恢复最近的聊天。 |
codex review |
稳定 | 以非交互方式审查未提交的更改、相对于基础分支的差异、某次提交或自定义审查指令。 |
codex sandbox |
稳定 | 在 Codex 提供的 macOS、Linux 或 Windows 沙箱内运行任意命令。 |
codex unarchive |
稳定 | 按会话 ID 或会话名称恢复已归档的交互式会话。 |
codex update |
稳定 | 当已安装版本支持自更新时，检查并应用 Codex CLI 更新。 |
命令详情
codex（交互式）
不带子命令运行 codex 会启动交互式终端界面（TUI）。智能体接受上述全局标志和图片附件。网页搜索默认为缓存模式；使用 --search 可切换到实时浏览。若要顺畅地处理本地工作，请使用 --sandbox workspace-write --ask-for-approval on-request。
使用 --remote ws://host:port 或 --remote wss://host:port 将 TUI 连接到通过 codex app-server --listen ws://IP:PORT 启动的 app server。对于本地 Unix 套接字，使用 --remote unix:// 连接默认套接字，或使用 --remote unix://PATH 指定明确路径。当服务器要求通过持有者令牌进行 WebSocket 身份验证时，请添加 --remote-auth-token-env <ENV_VAR>。
codex app-server
在本地启动 Codex app server。此功能主要用于开发和调试，可能会随时更改，恕不另行通知。
| 键 | 类型/值 | 详情 |
|---|---|---|
--analytics-default-enabled |
boolean |
对第一方 app-server 客户端默认启用分析，除非用户在配置中选择退出。 |
--listen |
stdio:// | ws://IP:PORT | unix:// | unix://PATH | off |
传输监听器 URL。使用 stdio:// 处理 JSONL，使用 ws://IP:PORT 指定 TCP WebSocket 端点，使用 unix:// 指定默认 Unix 套接字，使用 unix://PATH 指定自定义 Unix 套接字，或使用 off 禁用本地传输。 |
--stdio |
boolean |
使用 stdio 传输。等同于 --listen stdio://，并与 --listen 互斥。 |
--ws-audience |
string |
签名持有者令牌预期的 aud 声明。需要 --ws-auth signed-bearer-token。 |
--ws-auth |
capability-token | signed-bearer-token |
app-server WebSocket 客户端的身份验证模式。省略时会禁用 WebSocket 身份验证；非本地监听器将在启动期间发出警告。 |
--ws-issuer |
string |
签名持有者令牌预期的 iss 声明。需要 --ws-auth signed-bearer-token。 |
--ws-max-clock-skew-seconds |
number |
验证签名持有者令牌的 exp 和 nbf 声明时允许的时钟偏差。需要 --ws-auth signed-bearer-token。 |
--ws-shared-secret-file |
absolute path |
包含用于验证签名 JWT 持有者令牌的 HMAC 共享密钥的文件。与 --ws-auth signed-bearer-token 搭配使用时必需。 |
--ws-token-file |
absolute path |
包含共享能力令牌的文件。与 --ws-auth capability-token 搭配使用，除非改为提供 --ws-token-sha256。 |
--ws-token-sha256 |
hexadecimal SHA-256 digest |
能力令牌身份验证预期的 SHA-256 摘要。当客户端令牌来自其他来源时，用它代替 --ws-token-file。 |
codex app-server --listen stdio:// 保留默认的基于 stdio 的 JSONL 行为，codex app-server --stdio 是该传输方式的别名。--listen ws://IP:PORT 为 app-server 客户端启用 WebSocket 传输。服务器接受 ws:// 监听 URL；当客户端通过 wss:// 连接时，请使用 TLS 终止或安全代理。使用 --listen unix:// 可在 Codex 的默认 Unix 套接字上接受 WebSocket 握手，使用 --listen unix:///absolute/path.sock 可选择套接字路径。如果要为客户端绑定生成 schema，请添加 --experimental 以包含受限字段和方法。
添加 --code-mode-host wss://code-mode.example.com/host 可将 app-server 连接到
远程 Code Mode 主机，而不是启动本地主机。此出站
连接独立于 --listen，并由 app-server 进程中的每个线程
共享。ws:// 仅可用于 localhost 或通过 SSH 转发的主机。
codex remote-control
运行 codex remote-control 可在前台启动远程控制。使用
codex remote-control start 可启动已启用远程
控制的本地 app-server 守护进程，使用 codex remote-control stop 可将其停止。托管的
远程控制客户端和 SSH 远程工作流会使用这些命令；当你要构建本地
协议客户端时，它们不能替代 codex app-server --listen。
守护进程运行后，使用 codex remote-control pair 创建并
输出短期有效的手动配对码。将 --json 添加到任何远程控制
命令可获得机器可读输出。对于 pair，JSON 响应包含
pairingCode、manualPairingCode、environmentId 和 expiresAt。
codex app
从终端在 macOS 或 Windows 上启动 ChatGPT 桌面应用。在 macOS 上， Codex 可以打开指定的工作区路径；在 Windows 上，Codex 会输出要 打开的路径。
| 键 | 类型/值 | 详情 |
|---|---|---|
--download-url |
url |
安装期间使用的 ChatGPT 桌面应用安装程序 URL 的高级覆盖项。 |
PATH |
path |
ChatGPT 桌面应用的工作区路径。在 macOS 上，Codex 会打开此路径；在 Windows 上，Codex 会输出此路径。 |
codex app 会打开已安装的 ChatGPT 桌面应用；如果应用不存在，
则启动安装程序。在 macOS 上，Codex 会打开提供的工作区路径；在
Windows 上，它会在安装后输出要打开的路径。
codex debug app-server send-message-v2
使用内置 app-server 测试客户端，通过 app-server 的 V2 线程/轮次流程发送一条消息。
| 键 | 类型/值 | 详情 |
|---|---|---|
USER_MESSAGE |
string |
通过内置 V2 测试客户端流程发送到 app-server 的消息文本。 |
此调试流程使用 experimentalApi: true 进行初始化、启动线程、发送一个轮次并流式传输服务器通知。使用它可在本地复现和检查 app-server 协议行为。
codex debug models
以 JSON 格式输出 Codex 所看到的原始模型目录。
| 键 | 类型/值 | 详情 |
|---|---|---|
--bundled |
boolean |
跳过刷新，仅输出当前 Codex 二进制文件内置的模型目录。 |
如果只想检查当前二进制文件内置的目录，而不从远程模型端点刷新，请使用 --bundled。
codex debug prompt-input
将模型实际可见的提示词输入列表呈现为 JSON。可在 调试指令发现、会话上下文或提示词构造时使用此命令。
| 键 | 类型/值 | 详情 |
|---|---|---|
--image, -i |
path[,path...] |
将一张或多张图片附加到用户提示词。多个路径可用逗号分隔，也可重复使用该标志。 |
PROMPT |
string |
追加到会话上下文之后的可选用户提示词。 |
codex apply
将 Codex 云端聊天中的最新差异应用到本地仓库。你必须完成身份验证并拥有该聊天的访问权限。
| 键 | 类型/值 | 详情 |
|---|---|---|
TASK_ID |
string |
要应用其差异的 Codex 云端聊天标识符。 |
Codex 会输出已修补的文件；如果 git apply 失败（例如发生冲突），则以非零状态退出。
codex review
以非交互方式运行代码审查。请恰好选择一个审查目标，或将 自定义审查指令作为提示词传入。
| 键 | 类型/值 | 详情 |
|---|---|---|
--base |
branch |
审查相对于指定基础分支的更改。 |
--commit |
SHA |
审查指定提交引入的更改。 |
--strict-config |
boolean |
当 config.toml 包含此 Codex 版本无法识别的字段时报错。 |
--title |
string |
设置审查摘要中显示的提交标题。需要 --commit。 |
--uncommitted |
boolean |
审查已暂存、未暂存和未跟踪的更改。 |
PROMPT |
string | - (read stdin) |
自定义审查指令。使用 - 可从 stdin 读取指令。 |
--uncommitted、--base、--commit 和自定义 PROMPT 彼此
冲突。--title 只能与 --commit 搭配使用。
codex archive 和 codex unarchive
按会话 ID 或会话名称归档或恢复已保存的交互式会话。 如果你想整理会话选择器但不删除 对话记录，请使用这些命令。会话 ID 的优先级高于会话名称。
codex archive <SESSION>
codex unarchive <SESSION>| 键 | 类型/值 | 详情 |
|---|---|---|
--remote |
ws://host:port | wss://host:port | unix:// | unix://PATH |
更改归档状态前连接到远程 app-server 端点。 |
--remote-auth-token-env |
ENV_VAR |
当 --remote 要求身份验证时，从此环境变量读取持有者令牌。 |
SESSION |
session ID | session name |
要归档或恢复的已保存会话。会话 ID 的优先级高于会话名称。 |
codex delete
按会话 ID 或会话名称永久删除已保存的交互式会话。 仅当你想删除对话记录，而不是将其从 活动会话列表中隐藏时，才使用此命令。
codex delete <SESSION>
codex delete <SESSION_UUID> --force| 键 | 类型/值 | 详情 |
|---|---|---|
--force |
boolean |
不提示直接删除。会话参数必须是 UUID；使用名称时仍需交互式确认。 |
--remote |
ws://host:port | wss://host:port | unix:// | unix://PATH |
删除会话前连接到远程 app-server 端点。 |
--remote-auth-token-env |
ENV_VAR |
当 --remote 要求身份验证时，从此环境变量读取持有者令牌。 |
SESSION |
session ID | session name |
要删除的已保存会话。会话 ID 的优先级高于会话名称。 |
--force 只能与会话 UUID 搭配使用。使用名称的会话仍需
确认，以免 Codex 未经提示就删除重名或含义不明确的名称。
codex cloud
从终端与 Codex 云端聊天交互。默认命令会打开交互式选择器；codex cloud exec 会直接提交任务，codex cloud list 会返回最近的聊天，供脚本处理或快速检查。
| 键 | 类型/值 | 详情 |
|---|---|---|
--attempts |
1-4 |
Codex 云端应运行的助手尝试次数（best-of-N）。 |
--env |
ENV_ID |
目标 Codex 云端环境标识符（必需）。使用 codex cloud 可列出选项。 |
QUERY |
string |
任务提示词。如果省略，Codex 会以交互方式提示你提供详细信息。 |
身份验证使用与主 CLI 相同的凭据。如果任务提交失败，Codex 将以非零状态退出。
codex cloud list
列出最近的云端聊天，可选择进行筛选和分页。
| 键 | 类型/值 | 详情 |
|---|---|---|
--cursor |
string |
上一次请求返回的分页游标。 |
--env |
ENV_ID |
按环境标识符筛选任务。 |
--json |
boolean |
输出机器可读的 JSON，而非纯文本。 |
--limit |
1-20 |
返回的最大任务数。 |
纯文本输出会先显示任务 URL，随后显示状态详情。自动化场景请使用 --json。JSON 载荷包含一个 tasks 数组，以及可选的 cursor 值。每个任务都包含 id、url、title、status、updated_at、environment_id、environment_label、summary、is_review 和 attempt_total。
codex completion
生成 shell 补全脚本并将输出重定向到适当位置，例如 codex completion zsh > "${fpath[1]}/_codex"。
| 键 | 类型/值 | 详情 |
|---|---|---|
SHELL |
bash | zsh | fish | power-shell | elvish |
要为其生成补全的 shell。输出将写入 stdout。 |
codex doctor
在提交支持问题之前或 调查损坏的 Codex 安装时，生成本地诊断报告。该报告会检查安装、 配置、身份验证、运行时、Git、终端、app-server 和线程 清单的健康状况。
| 键 | 类型/值 | 详情 |
|---|---|---|
--all |
boolean |
在详细的可读报告中展开长列表。 |
--ascii |
boolean |
在可读输出中使用 ASCII 状态标签和分隔符。 |
--json |
boolean |
输出经过脱敏的机器可读支持报告。 |
--no-color |
boolean |
在可读输出中禁用 ANSI 颜色。 |
--summary |
boolean |
仅显示分组的检查行和最终计数摘要。 |
codex features
管理存储在 $CODEX_HOME/config.toml 中的功能标志。enable 和
disable 命令会持久保存更改，使其应用于未来会话。
features 子命令不接受 --profile。
| 键 | 类型/值 | 详情 |
|---|---|---|
Disable subcommand |
codex features disable <feature> |
在 $CODEX_HOME/config.toml 中持久禁用功能标志。 |
Enable subcommand |
codex features enable <feature> |
在 $CODEX_HOME/config.toml 中持久启用功能标志。 |
List subcommand |
codex features list |
显示已知功能标志、其成熟度阶段和有效状态。 |
codex exec
对于无需人工交互即可完成的脚本化或 CI 式运行，请使用 codex exec（或简写形式 codex e）。
| 键 | 类型/值 | 详情 |
|---|---|---|
--cd, -C |
path |
执行任务前设置工作区根目录。 |
--color |
always | never | auto |
控制 stdout 中的 ANSI 颜色。 |
--dangerously-bypass-approvals-and-sandbox, --yolo |
boolean |
绕过批准提示和沙箱。此操作很危险——仅可在隔离的运行器中使用。 |
--dangerously-bypass-hook-trust |
boolean |
在本次调用中运行已启用的钩子，无需持久保存钩子信任。仅适用于已审查钩子来源的自动化流程。 |
--ephemeral |
boolean |
运行时不将会话 rollout 文件持久保存到磁盘。 |
--full-auto |
boolean |
已弃用的兼容性标志。请优先使用 --sandbox workspace-write；使用此标志时 Codex 会输出警告。 |
--ignore-rules |
boolean |
本次运行不加载用户或项目 execpolicy .rules 文件。 |
--ignore-user-config |
boolean |
不加载 $CODEX_HOME/config.toml。身份验证仍使用 CODEX_HOME。 |
--image, -i |
path[,path...] |
将图片附加到第一条消息。可重复使用；支持逗号分隔的列表。 |
--json, --experimental-json |
boolean |
输出以换行符分隔的 JSON 事件，而非格式化文本。 |
--local-provider |
lmstudio | ollama |
选择与 --oss 搭配使用的本地提供商，并在本次运行中覆盖 oss_provider。 |
--model, -m |
string |
在本次运行中覆盖已配置的模型。 |
--oss |
boolean |
使用本地开源提供商。Codex 会使用 --local-provider 或你配置的 oss_provider；如果两者均未设置，则报错退出。 |
--output-last-message, -o |
path |
将助手的最终消息写入文件。适用于下游脚本处理。 |
--output-schema |
path |
描述预期最终响应结构的 JSON Schema 文件。Codex 会依据它验证工具输出。 |
--profile, -p |
string |
在基础用户配置之上叠加 $CODEX_HOME/profile-name.config.toml。 |
--sandbox, -s |
read-only | workspace-write | danger-full-access |
模型生成的命令所采用的沙箱策略。默认使用配置值。 |
--skip-git-repo-check |
boolean |
允许在 Git 仓库之外运行（适用于一次性目录）。 |
-c, --config |
key=value |
非交互式运行的内联配置覆盖项（可重复使用）。 |
PROMPT |
string | - (read stdin) |
任务的初始指令。使用 - 可从 stdin 传入提示词。 |
Resume subcommand |
codex exec resume [SESSION_ID] |
按 ID 恢复 exec 会话，或添加 --last 以继续当前工作目录中最近的会话。添加 --all 可考虑任何目录中的会话。接受可选的后续提示词。 |
Codex 默认写入格式化输出。添加 --json 可接收以换行符分隔的 JSON 事件（每次状态变化对应一个事件）。可选的 resume 子命令可让你继续非交互式任务。使用 --last 可选择当前工作目录中最近的会话，也可添加 --all 跨所有会话搜索：
| 键 | 类型/值 | 详情 |
|---|---|---|
--all |
boolean |
选择最近的会话时，包含当前工作目录之外的会话。 |
--image, -i |
path[,path...] |
将一张或多张图片附加到后续提示词。多个路径可用逗号分隔，也可重复使用该标志。 |
--last |
boolean |
恢复当前工作目录中最近的聊天。 |
PROMPT |
string | - (read stdin) |
恢复后立即发送的可选后续指令。 |
SESSION_ID |
uuid | session name |
恢复指定会话。省略该参数并使用 --last 可继续最近的会话。 |
codex execpolicy
保存 execpolicy 规则文件前对其进行检查。codex execpolicy check 接受一个或多个 --rules 标志（例如 ~/.codex/rules 下的文件），并输出 JSON，其中会显示最严格的决策及所有匹配的规则。添加 --pretty 可格式化输出。execpolicy 命令目前处于预览阶段。
| 键 | 类型/值 | 详情 |
|---|---|---|
--pretty |
boolean |
美化输出 JSON 结果。 |
--rules, -r |
path (repeatable) |
要评估的 execpolicy 规则文件路径。提供多个标志可合并多个文件中的规则。 |
COMMAND... |
var-args |
要依据指定策略进行检查的命令。 |
codex login
使用 ChatGPT 账户、API key 或访问令牌对 CLI 进行身份验证。不带标志时，Codex 会打开浏览器并启动 ChatGPT OAuth 流程。
| 键 | 类型/值 | 详情 |
|---|---|---|
--device-auth |
boolean |
使用 OAuth 设备代码流程，而不是启动浏览器窗口。 |
--with-access-token |
boolean |
从 stdin 读取访问令牌（例如 printenv CODEX_ACCESS_TOKEN | codex login --with-access-token）。 |
--with-api-key |
boolean |
从 stdin 读取 API key（例如 printenv OPENAI_API_KEY | codex login --with-api-key）。 |
status subcommand |
codex login status |
输出当前身份验证模式；已登录时以 0 状态退出。 |
存在凭据时，codex login status 会以 0 状态退出，这对自动化脚本很有帮助。
codex logout
删除 API key 和 ChatGPT 身份验证的已保存凭据。此命令没有标志。
codex mcp
管理存储在 ~/.codex/config.toml 中的 Model Context Protocol 服务器条目。
| 键 | 类型/值 | 详情 |
|---|---|---|
add <name> |
-- <command...> | --url <value> |
使用 stdio 启动器命令或可流式传输的 HTTP URL 注册服务器。stdio 传输支持 --env KEY=VALUE。 |
get <name> |
--json |
显示指定服务器的配置。--json 会输出原始配置条目。 |
list |
--json |
列出已配置的 MCP 服务器。添加 --json 可获得机器可读输出。 |
login <name> |
--scopes scope1,scope2 |
为可流式传输的 HTTP 服务器启动 OAuth 登录（仅限支持 OAuth 的服务器）。 |
logout <name> |
删除可流式传输的 HTTP 服务器已存储的 OAuth 凭据。 | |
remove <name> |
删除已存储的 MCP 服务器定义。 |
add 子命令同时支持 stdio 和可流式传输的 HTTP 传输：
| 键 | 类型/值 | 详情 |
|---|---|---|
--bearer-token-env-var |
ENV_VAR |
连接可流式传输的 HTTP 服务器时，其值将作为持有者令牌发送的环境变量。 |
--env KEY=VALUE |
repeatable |
启动 stdio 服务器时应用的环境变量赋值。 |
--oauth-client-id |
CLIENT_ID |
可流式传输的 HTTP MCP 服务器的 OAuth 客户端标识符。需要 --url。 |
--oauth-resource |
RESOURCE |
登录可流式传输的 HTTP MCP 服务器时要包含的 OAuth resource 参数。需要 --url。 |
--url |
https://… |
注册可流式传输的 HTTP 服务器，而不是 stdio 服务器。与 COMMAND... 互斥。 |
COMMAND... |
stdio transport |
用于启动 MCP 服务器的可执行文件及参数。请在 -- 之后提供。 |
OAuth 操作（login、logout）仅适用于可流式传输的 HTTP 服务器（且仅限服务器支持 OAuth 时）。
codex plugin
从已配置的市场安装、列出和删除插件。
| 键 | 类型/值 | 详情 |
|---|---|---|
add <plugin[@marketplace]> |
[--marketplace, -m NAME] [--json] |
从已配置的市场安装插件。当插件参数省略 @marketplace 时，使用 --marketplace 或 -m。 |
list |
[--marketplace, -m NAME] [--available --json] [--json] |
列出已安装的插件。使用 --json 时，输出包含 installed 和 available 数组；--available 会包含市场中未安装的插件，并且需要 --json。 |
marketplace |
管理已配置的市场源。请参阅下方的 codex plugin marketplace。 |
|
remove <plugin[@marketplace]> |
[--marketplace, -m NAME] [--json] |
从本地配置和缓存中删除已安装的插件。使用 --json 可获得便于自动化处理的输出。 |
codex plugin add --json 会输出 pluginId、name、marketplaceName、
version、installedPath 和 authPolicy。codex plugin list --json 会输出
installed 和 available 数组。条目包含 pluginId、name、
marketplaceName、version、installed、enabled、source、installPolicy、
authPolicy，以及在可用时包含已配置市场源类型和值的 marketplaceSource。
codex plugin remove --json 会输出
pluginId、name 和 marketplaceName。
codex plugin marketplace
管理 Codex 可以浏览并从中安装插件的插件市场源。
| 键 | 类型/值 | 详情 |
|---|---|---|
add <source> |
[--ref REF] [--sparse PATH] [--json] |
从 GitHub 简写、Git URL、SSH URL 或本地市场根目录安装插件市场。--sparse 仅支持 Git 源，并可重复使用。 |
list |
[--json] |
显示 Codex 当前考虑的插件市场及每个市场的根路径。 |
remove <marketplace-name> |
[--json] |
删除已配置的插件市场。 |
upgrade [marketplace-name] |
[--json] |
刷新指定的已配置 Git 市场；未提供名称时，刷新所有已配置的 Git 市场。 |
codex plugin marketplace add 接受 owner/repo 或
owner/repo@ref 等 GitHub 简写、HTTP 或 HTTPS Git URL、SSH Git URL，以及本地市场
根目录。使用 --ref 可固定 Git ref，重复使用 --sparse PATH 可
对 Git 支持的市场仓库使用稀疏检出。
codex plugin marketplace list 会输出范围内的市场名称和根目录，
包括隐式发现的默认市场和已配置的市场
快照。
将 --json 添加到市场添加、列出、升级或删除命令，可获得
便于自动化处理的输出。市场添加 JSON 包含 marketplaceName、
installedRoot 和 alreadyAdded；列表 JSON 包含一个 marketplaces 数组，
其中有 name、root 和可选的 marketplaceSource；升级 JSON 包含
selectedMarketplaces、upgradedRoots 和 errors；删除 JSON 包含
marketplaceName 和 installedRoot。
codex mcp-server
对于现有集成，该命令会通过 stdio 将 Codex 作为 MCP server 运行，以便其他工具连接。它会继承全局配置覆盖项，并在下游客户端关闭连接时退出。
codex resume
按 ID 继续交互式会话，或恢复最近的聊天。除非传入 --all，否则 codex resume 会将 --last 的范围限定为当前工作目录。它接受与 codex 相同的全局标志，包括模型和沙箱覆盖项。
如果当前工作目录与会话保存的目录不同，
Codex 会询问要使用哪个目录。将
tui.resume_cwd 设置为 "current" 或
"session"，可在不提示的情况下复用该选择。显式的 --cd（-C）
覆盖项优先于 tui.resume_cwd。
| 键 | 类型/值 | 详情 |
|---|---|---|
--all |
boolean |
选择最近的会话时，包含当前工作目录之外的会话。 |
--include-non-interactive |
boolean |
在选择器和 --last 选择中包含非交互式会话。 |
--last |
boolean |
跳过选择器，恢复当前工作目录中最近的聊天。 |
SESSION_ID |
uuid | session name |
恢复指定会话。省略该参数并使用 --last 可继续最近的会话。 |
codex fork
将之前的交互式会话分叉为新聊天。默认情况下，codex fork 会打开会话选择器；添加 --last 可改为分叉最近的会话。
当当前目录与已保存的会话目录不同时，codex fork 会使用与 codex resume 相同的
工作目录提示和 tui.resume_cwd 设置。
| 键 | 类型/值 | 详情 |
|---|---|---|
--all |
boolean |
在选择器中显示当前工作目录之外的会话。 |
--last |
boolean |
跳过选择器，自动分叉最近的聊天。 |
SESSION_ID |
uuid |
分叉指定会话。省略该参数并使用 --last 可分叉最近的会话。 |
codex sandbox
使用沙箱辅助工具，在与 Codex 内部所用策略相同的策略下运行命令。
macOS seatbelt
| 键 | 类型/值 | 详情 |
|---|---|---|
--allow-unix-socket |
path |
允许沙箱中的命令绑定或连接以此路径为根的 Unix 套接字。可重复使用以允许多个路径。 |
--cd, -C |
DIR |
用于配置文件解析和命令执行的工作目录。需要 --permission-profile。 |
--config, -c |
key=value |
将配置覆盖项传入沙箱运行（可重复使用）。 |
--include-managed-config |
boolean |
解析显式权限配置文件时包含托管要求。需要 --permission-profile。 |
--log-denials |
boolean |
命令运行时使用 log stream 捕获 macOS 沙箱拒绝事件，并在退出后输出。 |
--permission-profile, -P |
NAME |
应用当前配置栈中的指定权限配置文件。 |
--profile, -p |
NAME |
在基础用户配置之上叠加 $CODEX_HOME/NAME.config.toml。 |
COMMAND... |
var-args |
要在 macOS Seatbelt 下执行的 shell 命令。-- 之后的所有内容都会被转发。 |
Linux Landlock
| 键 | 类型/值 | 详情 |
|---|---|---|
--cd, -C |
DIR |
用于配置文件解析和命令执行的工作目录。需要 --permission-profile。 |
--config, -c |
key=value |
启动沙箱前应用的配置覆盖项（可重复使用）。 |
--include-managed-config |
boolean |
解析显式权限配置文件时包含托管要求。需要 --permission-profile。 |
--permission-profile, -P |
NAME |
应用当前配置栈中的指定权限配置文件。 |
--profile, -p |
NAME |
在基础用户配置之上叠加 $CODEX_HOME/NAME.config.toml。 |
COMMAND... |
var-args |
要在 Landlock + seccomp 下执行的命令。请在 -- 之后提供可执行文件。 |
Windows
| 键 | 类型/值 | 详情 |
|---|---|---|
--cd, -C |
DIR |
用于配置文件解析和命令执行的工作目录。需要 --permission-profile。 |
--config, -c |
key=value |
启动沙箱前应用的配置覆盖项（可重复使用）。 |
--include-managed-config |
boolean |
解析显式权限配置文件时包含托管要求。需要 --permission-profile。 |
--permission-profile, -P |
NAME |
应用当前配置栈中的指定权限配置文件。 |
--profile, -p |
NAME |
在基础用户配置之上叠加 $CODEX_HOME/NAME.config.toml。 |
COMMAND... |
var-args |
要在原生 Windows 沙箱下执行的命令。请在 -- 之后提供可执行文件。 |
codex update
当已安装版本支持自更新时，检查并应用 Codex CLI 更新。调试版本会输出消息，提示你改为安装发布版本。
标志组合与安全提示
- 对于可限制在工作区内的无人值守本地工作，请使用
--sandbox workspace-write；除非位于专用沙箱虚拟机内，否则应避免使用--dangerously-bypass-approvals-and-sandbox。 - 需要向 Codex 授予更多目录的写入权限时，请优先使用
--add-dir，不要强制使用--sandbox danger-full-access。 - 在 CI 中将
--json与--output-last-message搭配使用，可捕获机器可读的进度和最终的自然语言摘要。
交互式快捷键
- 输入
@可在工作区中搜索文件，并将其路径添加到提示词。 - 按 Up 或 Down 可恢复草稿历史记录。
- 按 Ctrl+R 搜索提示词历史记录，然后按 Enter 使用匹配项，或按 Esc 取消。
- 按 Ctrl+O 或运行
/copy可复制 Codex 最近一次完成的输出。 - 在行首添加
!，可在当前批准和沙箱设置下运行本地 shell 命令。 - Codex 工作时按 Tab，可将后续提示词、斜杠命令或 shell 命令排入下一轮。
- Codex 工作时按 Enter，可向当前轮次注入新指令。
- 输入框为空时连续按两次 Esc，可编辑上一条用户消息，并从该处分叉聊天。
- 按 Ctrl+C 或运行
/exit可关闭会话。
相关资源
- Codex CLI 概览：安装、升级和快速提示。
- 配置基础：持久保存模型和提供商等默认值。
- 高级配置：配置文件、提供商、沙箱调优和集成。
- AGENTS.md：Codex 智能体功能和最佳实践的概念性概览。
斜杠命令让你能够以键盘优先的方式快速控制 Codex。在
输入框中输入 / 可打开斜杠命令弹窗，选择命令后，Codex 将执行
切换模型、调整权限或总结长对话等操作，
无需离开终端。
本指南将介绍如何：
- 为任务找到合适的内置斜杠命令
- 使用
/model、/fast、/personality、/permissions、/approve、/raw、/agent和/status等命令引导活动会话
Codex CLI 斜杠命令
内置斜杠命令
Codex 随附以下命令。打开斜杠命令弹窗并开始输入 命令名称，即可筛选列表。
聊天已在运行时，你可以输入斜杠命令并按 Tab，将其
排入下一轮。Codex 会在运行排队的斜杠命令时解析它们，因此
命令菜单和错误会在当前轮次结束后显示。将命令加入队列前，斜杠命令
补全仍然有效。
| 命令 | 用途 | 使用时机 |
|---|---|---|
/permissions |
设置 Codex 无需事先询问即可执行的操作。 | 在会话期间放宽或收紧审批要求，例如在 Auto 和 Read Only 之间切换。 |
/ide |
包含打开的文件、当前选择及其他 IDE 上下文。 | 将编辑器上下文带入下一个提示，无需再次说明 IDE 中打开了哪些内容。 |
/keymap |
重新映射 TUI 键盘快捷键。 | 检查自定义快捷键绑定并将其持久化到 config.toml。 |
/vim |
切换输入框的 Vim 模式。 | 在 Vim 的普通/插入行为与默认输入框编辑模式之间切换。 |
/setup-default-sandbox |
设置提升权限的智能体沙箱（仅限 Windows）。 | 在 Codex 提供提升权限的设置后，替换功能受限的 Windows 沙箱。 |
/sandbox-add-read-dir |
授予沙箱对额外目录的读取权限（仅限 Windows）。 | 当命令需要读取当前可读根目录之外的绝对目录路径时解除阻塞。 |
/agent, /subagents |
切换活动智能体线程。 | 检查派生的子智能体线程或在其中继续工作。 |
/apps |
浏览应用（连接器）并将其插入提示中。 | 在要求 Codex 使用应用之前，将其以 $app-slug 形式附加。 |
/plugins |
浏览已安装和可发现的插件。 | 检查插件工具、安装建议的插件或管理插件可用性。 |
/hooks |
查看和管理生命周期钩子。 | 检查已配置的钩子、信任新增或已更改的钩子，或在非托管钩子运行前将其禁用。 |
/clear |
清空终端并开始新聊天。 | 想要重新开始时，同时重置可见 UI 和聊天上下文。 |
/rename |
重命名当前聊天。 | 无需离开 TUI，即可为保存的会话设置一个易于识别的名称。 |
/archive |
归档当前会话并退出 Codex。 | 从活动会话列表中移除当前会话，但不删除其记录。 |
/delete |
永久删除当前会话并退出 Codex。 | 当归档仍不够时，移除记录及其派生会话。 |
/compact |
总结可见聊天以释放 token。 | 在长时间运行后使用，让 Codex 保留要点而不超出上下文窗口。 |
/copy |
复制 Codex 最新完成的输出。 | 无需手动选择，即可获取最新完成的回复或计划文本。也可以按 Ctrl+O。 |
/diff |
显示 Git diff，包括 Git 尚未跟踪的文件。 | 在提交或运行测试之前检查 Codex 的编辑。 |
/exit |
退出 CLI（与 /quit 相同）。 |
另一种命令写法；两者都会退出会话。 |
/experimental |
切换实验性功能。 | 启用 Network proxy 或 Prevent sleep while running 等选项。 |
/approve |
批准重试一次最近被自动审查拒绝的操作。 | 重试被自动审查器拒绝的命令或操作。 |
/memories |
配置记忆的使用和生成。 | 无需离开 TUI 即可开启或关闭记忆注入或记忆生成。 |
/skills |
浏览和使用技能。 | 通过选择相关的本地技能，改善针对特定任务的行为。 |
/import |
导入 Claude Code 或 Cursor 的设置、项目和聊天。 | 将支持的外部智能体构件迁移到 Codex 配置和本地文件中。 |
/feedback |
向 Codex 维护者发送日志。 | 报告问题或与支持人员共享诊断信息。 |
/init |
在当前目录中生成 AGENTS.md 脚手架。 |
记录适用于当前仓库或子目录的持久指令。 |
/logout |
退出 Codex 登录。 | 使用共享计算机时清除本地凭据。 |
/mcp |
列出已配置的 Model Context Protocol (MCP) 工具。 | 检查 Codex 在会话期间可以调用哪些外部工具；添加 verbose 可查看服务器详情。 |
/mention |
将文件附加到聊天。 | 指定希望 Codex 接下来检查的特定文件或文件夹。 |
/model |
选择活动模型（以及可用时的推理强度）。 | 在运行任务前，在 gpt-5.6-luna 和 gpt-5.6-terra 等模型之间切换。 |
/fast |
在模型目录提供 Fast 服务层级时切换该层级。 | 开启或关闭当前模型的 Fast 层级，并持久化该选择。 |
/plan |
切换到计划模式，并可选择发送提示。 | 在开始实施工作之前，让 Codex 提出执行计划。 |
/goal |
设置、编辑、暂停、恢复、查看或清除任务目标。 | 为 Codex 设置一个持久目标，以便在较大任务运行期间持续跟踪。 |
/personality |
选择回复的沟通风格。 | 无需更改指令，即可让 Codex 更简洁、更具解释性或更注重协作。 |
/ps |
显示后台终端及其最近的输出。 | 无需离开主记录即可检查长时间运行的命令。 |
/stop |
停止所有后台终端。 | 取消当前会话启动的后台终端工作。 |
/fork |
将当前聊天分叉为新聊天。 | 从活动会话创建分支以探索新方法，同时保留当前记录。 |
/app |
在 ChatGPT 桌面应用中继续当前会话。 | 在 macOS 或 Windows 上从 TUI 转到桌面应用。 |
/side, /btw |
开始临时侧边聊天。 | 进行聚焦的后续提问，而不打乱主聊天的记录。 |
/raw |
切换原始回滚缓冲区模式。 | 查看长输出时，让终端中的选择和复制减少格式化。 |
/resume |
从会话列表恢复已保存的聊天。 | 从之前的 CLI 会话继续工作，无需重新开始。 |
/new |
在同一 CLI 会话中开始新聊天。 | 想要在同一仓库中使用全新提示时，无需离开 CLI 即可重置聊天上下文。 |
/quit |
退出 CLI。 | 立即离开会话。 |
/review |
让 Codex 审查你的工作树。 | 在 Codex 完成工作后运行，或在希望再次检查本地更改时运行。 |
/status |
显示会话配置和 token 使用情况。 | 确认活动模型、审批策略、可写根目录和剩余上下文容量。 |
/usage |
查看账户 token 使用情况或使用速率限制重置。 | 在 TUI 中检查每日、每周或累计的 ChatGPT token 活动。 |
/debug-config |
输出配置层和要求诊断信息。 | 调试优先级和策略要求，包括实验性网络约束。 |
/statusline |
以交互方式配置 TUI 状态行字段。 | 选择并重新排列页脚项目（模型/上下文/限制/git/token/会话），并将其持久化到 config.toml。 |
/title |
以交互方式配置终端窗口或标签页标题字段。 | 选择并重新排列项目、状态、线程、分支、模型和任务进度等标题项目。 |
/theme |
选择语法高亮主题。 | 预览并持久化终端语法高亮主题。 |
/pets, /pet |
选择或隐藏终端宠物。 | 使用内置或自定义环境宠物个性化 TUI。 |
/quit 和 /exit 都会退出 CLI。请仅在保存或
提交所有重要工作后使用它们。
使用 /permissions 调整 Codex 无需事先询问即可执行的操作。仅当你需要重试
最近被自动审查拒绝的操作时，才使用 /approve。
使用斜杠命令控制会话
以下工作流可帮助会话保持正轨，无需重启 Codex。
使用 /model 设置活动模型
- 启动 Codex 并打开输入框。
- 输入
/model，然后按 Enter。 - 从弹出窗口中选择
gpt-5.6-luna或gpt-5.6-terra等模型。
预期结果：Codex 在记录中确认新模型。运行 /status 以验证更改。
使用 /fast 切换 Fast 模式
- 输入
/fast，开启当前模型的 Fast 服务层级。 - 再次输入
/fast将其关闭。
预期结果：Codex 切换该层级并保存选择。在 TUI 页脚中，
你还可以使用 /statusline 显示 Fast 模式状态行项目。
Fast 层级命令由目录驱动。如果当前模型未声明支持
Fast 层级，Codex 将不会显示 /fast。
使用 /personality 设置沟通风格
使用 /personality 更改 Codex 的沟通方式，无需重写提示。
- 在活动聊天中输入
/personality，然后按 Enter。 - 从弹出窗口中选择一种风格。
预期结果：Codex 在记录中确认新风格，并将其用于聊天中的后续 回复。
Codex 支持 friendly、pragmatic 和 none 个性。使用 none
可禁用个性指令。
如果活动模型不支持个性专用指令，Codex 会隐藏此命令。
使用 /plan 切换到计划模式
- 输入
/plan并按 Enter，将活动聊天切换到计划 模式。 - 可选：提供内联提示文本（例如
/plan Propose a migration plan for this service）。 - 使用内联
/plan参数时，可以粘贴内容或附加图片。
预期结果：Codex 进入计划模式，并将可选的内联提示用作第一个规划请求。
Codex 已在工作时，/plan 会暂时不可用。
使用 /goal 设置或查看任务目标
- 输入
/goal <objective>设置目标，例如/goal Finish the migration and keep tests green。 - 输入
/goal查看当前目标。 - 使用
/goal edit修改目标。使用/goal pause、/goal resume或/goal clear暂停、恢复或移除目标。
预期结果：工作继续进行时，Codex 会让该目标始终关联到活动聊天。
目标内容不得为空，且最多为 4,000 个字符。对于更长的 指令，请将详细信息放入文件，并让目标指向该文件。
使用 /experimental 切换实验性功能
- 输入
/experimental，然后按 Enter。 - 切换所需功能（例如 Network proxy 或 Prevent sleep while running），如果提示要求，请重启 Codex。
预期结果：Codex 将功能选择保存到配置中，并在重启后应用。
使用 /approve 批准被自动审查拒绝的操作
当自动审查器拒绝了最近的操作，而你希望 Codex 重试一次时，请使用
/approve。
- 输入
/approve。 - Codex 显示相关的被拒操作时，确认重试。
预期结果：Codex 按当前会话策略重试该被拒操作一次。
使用 /memories 配置记忆
- 输入
/memories。 - 选择让 Codex 使用现有记忆、生成新记忆，或 保持禁用记忆行为。
预期结果：Codex 更新相关记忆设置，供未来会话使用。
使用 /skills 使用技能
- 输入
/skills。 - 选择希望 Codex 应用的技能。
预期结果：Codex 插入所选技能的上下文，使下一个请求遵循 该技能的指令。
使用 /import 导入 Claude Code 或 Cursor 设置
- 输入
/import。 - 选择 Claude Code 或 Cursor。
- 选择要迁移的设置、项目文件或最近聊天。
预期结果：Codex 打开外部智能体导入选择器，并将选定的 受支持构件导入 Codex 配置和本地文件。会话发现功能 最多包含过去 30 天内的 50 个聊天。
请从本地 TUI 会话运行 /import。任务运行期间、
远程会话中以及连接到本地 app-server 守护进程时，此功能不可用。
有关桌面应用工作流和支持的构件类型，请参阅从 其他智能体导入。
使用 /clear 清空终端并开始新聊天
- 输入
/clear，然后按 Enter。
预期结果：Codex 清空终端、重置可见记录，并在 同一 CLI 会话中开始新聊天。
要在创建新聊天时为其命名，请运行 /clear release prep。
与 Ctrl+L 不同，/clear 会开始新聊天。
Ctrl+L 只会清空终端视图，并保留当前 聊天。任务进行期间，Codex 会禁用这两个操作。
使用 /archive 归档当前会话
- 输入
/archive，然后按 Enter。 - 确认要归档当前会话并退出 Codex。
预期结果：Codex 归档当前会话并关闭交互式 TUI。
Codex 会将会话记录保存在本地；稍后可使用
codex unarchive <SESSION> 将其恢复。
任务运行期间，/archive 不可用。
使用 /delete 删除当前会话
- 输入
/delete，然后按 Enter。 - 确认要删除当前会话并退出 Codex。
预期结果：Codex 删除当前会话记录并关闭 交互式 TUI。删除操作不可撤销，还会移除派生的后代 会话。
聊天运行期间或处于侧边聊天中时，/delete 不可用。
使用 /permissions 更新权限
- 输入
/permissions，然后按 Enter。 - 选择符合你接受程度的审批预设，例如选择
Auto进行免干预运行，或选择Read Only审查编辑。启用命名 权限配置文件后，选择器还会显示已配置的自定义 配置文件及其说明。
预期结果：Codex 通知策略已更新。后续操作将遵循 更新后的审批模式，直至你再次更改。
使用 /ide 包含 IDE 上下文
- 输入
/ide。 - 如果想说明 Codex 应如何处理当前 IDE 选择或打开的文件， 可添加内联文本。
预期结果：Codex 在下一个提示中包含可用的 IDE 上下文。
使用 /vim 切换 Vim 模式
- 输入
/vim。 - 继续在输入框中编辑。
预期结果：Codex 为当前会话切换输入框的 Vim 模式。要让 Vim
模式成为新会话的默认设置，请在
config.toml 中设置 tui.vim_mode_default = true。
使用 /setup-default-sandbox 设置提升权限的 Windows 沙箱
仅当 Codex 在 Windows 上使用功能受限的 受限 token 沙箱时，此命令才会出现。
- 输入
/setup-default-sandbox。 - 按照管理员设置流程操作。
预期结果：Codex 配置提升权限的 Windows 沙箱，并选择 对应的自动审批预设。
使用 /copy 复制最新回复
- 输入
/copy，然后按 Enter。
预期结果：Codex 将最新完成的 Codex 输出复制到剪贴板。
如果某个轮次仍在运行，/copy 会使用最新完成的输出，而非
正在生成的回复。在第一个 Codex 输出完成之前以及回滚后立即执行时，
该命令不可用。
也可以在主 TUI 中按 Ctrl+O，无需打开斜杠命令菜单即可复制 最新完成的回复。
使用 /raw 切换原始回滚缓冲区
- 输入
/raw、/raw on或/raw off。
预期结果：Codex 切换原始回滚缓冲区模式，让终端中的选择和
复制更直接。也可以使用默认的 Alt+R
绑定，或使用 tui.raw_output_mode = true 持久化默认设置。
使用 /sandbox-add-read-dir 授予沙箱读取权限
此命令仅在 Windows 上原生运行 CLI 时可用。
- 输入
/sandbox-add-read-dir C:\absolute\directory\path，然后按 Enter。 - 确认该路径是现有的绝对目录。
预期结果：Codex 刷新 Windows 沙箱策略，并为 该目录授予读取权限，供之后在沙箱中运行的命令使用。
使用 /status 检查会话
- 在任意聊天中输入
/status。 - 查看活动模型、审批策略、可写根目录和 当前 token 使用情况。TUI 远程连接时，输出还会 显示远程地址和服务器版本。
预期结果：Codex 输出摘要，确认它正在你预期的位置 运行。
使用 /usage 查看账户用量
- 输入
/usage打开用量菜单。 - 选择显示 token 活动或兑换可用的已赚取重置。
- 要直接打开 token 活动，请输入
/usage daily、/usage weekly或/usage cumulative。
预期结果：Codex 打开用量操作或显示所选视图的账户 token 活动。 如果会话没有 Codex 服务账户身份验证，Codex 会显示登录要求。
使用 /debug-config 检查配置层
- 输入
/debug-config。 - 查看配置层顺序（优先级从低到高）、开关 状态和策略来源。
预期结果：Codex 输出配置层诊断信息，以及配置后出现的
allowed_approval_policies、allowed_sandbox_modes、mcp_servers、rules
和 experimental_network 等策略详情。
使用此输出调试有效设置为何与 config.toml 不同。
使用 /statusline 配置页脚项目
- 输入
/statusline。 - 使用选择器切换和重新排列项目，然后确认。
预期结果：页脚状态行立即更新，并持久化到
config.toml 中的 tui.status_line。
可用的状态行项目包括模型、模型+推理、上下文统计信息、速率 限制、git 分支、token 计数器、会话 id、当前目录/项目根目录 和 Codex 版本。
使用 /title 配置终端标题项目
- 输入
/title。 - 使用选择器切换和重新排列项目，然后确认。
预期结果：终端窗口或标签页标题立即更新，并持久化到
config.toml 中的 tui.terminal_title。
可用的标题项目包括应用名称、项目、旋转指示器、状态、线程、git 分支、模型和任务进度。
使用 /theme 选择语法主题
- 输入
/theme。 - 从选择器中预览主题，然后确认。
预期结果：Codex 更新语法高亮，并将选择持久化到
config.toml 中的 tui.theme。
使用 /pets 选择终端宠物
- 输入
/pets（或/pet）打开宠物选择器。 - 选择内置或自定义宠物，或关闭宠物。
预期结果：Codex 在支持的终端中显示所选环境宠物，并
持久化该选择。也可以输入 /pets off 将其隐藏。
使用 /keymap 重新映射 TUI 快捷键
使用 /keymap 检查、更新并持久化 TUI 的键盘快捷键绑定。
- 输入
/keymap。 - 选择要更改的快捷键上下文和操作。
- 输入新绑定或移除现有绑定。
预期结果：Codex 更新活动键位映射，并将自定义绑定写入 config.toml 中的 tui.keymap。
键绑定使用 ctrl-a、shift-enter 和 page-down 等名称。特定于上下文的绑定会覆盖 tui.keymap.global；空绑定列表会解除该操作的绑定。
使用 /ps 检查后台终端
- 输入
/ps。 - 查看后台终端列表及其状态。
预期结果：Codex 显示每个后台终端的命令及最多三行 最近的非空输出，让你可以快速判断进度。
使用 unified_exec 时会出现后台终端；否则列表可能为空。
使用 /stop 停止后台终端
- 输入
/stop。 - 如果 Codex 在停止列出的终端前要求确认，请予以确认。
预期结果：Codex 停止当前会话的所有后台终端。/clean
仍可用作 /stop 的别名。
使用 /compact 精简聊天记录
- 长时间交流后，输入
/compact。 - Codex 提议总结到目前为止的聊天时，予以确认。
预期结果：Codex 用简洁摘要替换先前的轮次，释放上下文 并保留关键细节。
使用 /diff 审查更改
- 输入
/diff检查 Git diff。 - 在 CLI 中滚动查看输出，以审查编辑和新增文件。
预期结果：Codex 显示已暂存的更改、尚未暂存的更改， 以及 Git 尚未开始跟踪的文件，方便你决定保留哪些内容。
使用 /mention 突出显示文件
- 输入
/mention，后跟路径，例如/mention src/lib/api.ts。 - 从弹出窗口中选择匹配结果。
预期结果：Codex 将文件添加到聊天，确保后续轮次直接引用该文件。
使用 /new 开始新聊天
- 输入
/new，然后按 Enter。
预期结果：Codex 在同一 CLI 会话中开始全新聊天，让你 无需离开终端即可切换聊天。
要在创建新聊天时为其命名，请运行 /new bug bash。
与 /clear 不同，/new 不会先清空当前终端视图。
使用 /rename 重命名当前聊天
- 输入
/rename <name>，或输入/rename打开命名提示。 - 输入一个简短名称，方便日后找到该聊天。
预期结果：Codex 更新保存的聊天名称，而不更改其记录。
使用 /resume 恢复已保存的聊天
- 输入
/resume，然后按 Enter。 - 从已保存会话选择器中选择所需会话。
预期结果：Codex 重新加载所选聊天的记录，让你可以从上次 中断处继续，同时完整保留原始历史记录。
使用 /fork 分叉当前聊天
- 输入
/fork，然后按 Enter。
预期结果：Codex 将当前聊天克隆为具有全新 ID 的新聊天，并保留原始记录不变，让你可以并行探索另一种 方法。
如果需要分叉已保存的会话而非当前会话，请在
终端中运行 codex fork 以打开会话选择器。
使用 /app 在桌面应用中继续
在 macOS 和 Windows 上，输入 /app 可在 ChatGPT
桌面应用中打开当前会话。如果应用未安装或未运行，Codex 会显示错误，要求
你安装或启动它。
预期结果：桌面应用打开同一已保存聊天，让你可以在那里继续。
使用 /side 开始侧边聊天
使用 /side 从当前聊天创建临时分叉，而无需离开主聊天。
- 输入
/side打开侧边聊天。 - 可选择添加内联文本，例如
/side Check whether this plan has an obvious risk。 - 完成聚焦的临时讨论后，返回父聊天。
预期结果：Codex 打开记录与父聊天分离的侧边聊天。 处于侧边模式时，TUI 会继续显示父聊天的 状态，让你可以查看主聊天是否仍在运行。
在另一个侧边聊天中以及审查模式期间，/side 不可用。
使用 /init 生成 AGENTS.md
- 在希望 Codex 查找持久指令的目录中运行
/init。 - 检查生成的
AGENTS.md，然后根据仓库约定进行编辑。
预期结果：Codex 创建一个 AGENTS.md 脚手架，你可以完善并提交它，供
未来会话使用。
使用 /review 请求工作树审查
- 输入
/review。 - 如果想检查具体的文件更改，请接着使用
/diff。
预期结果：Codex 总结在工作树中发现的问题，重点关注
行为更改和缺失的测试。除非你在 config.toml 中设置
review_model，否则它会使用当前会话模型。
使用 /mcp 列出 MCP 工具
- 输入
/mcp。 - 查看列表，确认有哪些 MCP 服务器和工具可用。
预期结果：你会看到 Codex 在此会话中可以调用的已配置 Model Context Protocol (MCP) 工具。
使用 /mcp verbose 可包含详细的服务器诊断信息。如果传入 verbose 以外的任何内容，Codex 会显示命令用法。
使用 /apps 浏览应用
- 输入
/apps。 - 从列表中选择一个应用。
预期结果：Codex 将应用提及以 $app-slug 形式插入输入框，
你可以立即要求 Codex 使用它。
使用 /plugins 浏览插件
- 输入
/plugins。 - 选择一个市场标签页，然后选择插件以检查其功能或可用操作。
预期结果：Codex 打开插件浏览器，让你可以查看已安装的插件、 配置允许发现的插件以及已安装插件的状态。 在已安装插件上按 Space 可切换其启用状态。
使用 /hooks 查看和管理生命周期钩子
- 输入
/hooks。 - 选择一个钩子事件以检查匹配的处理程序。
- 根据需要信任、禁用或重新启用非托管钩子。
预期结果：Codex 打开钩子浏览器，让你可以查看已配置的生命周期 钩子。托管钩子会显示为托管状态，无法从用户钩子 浏览器中禁用。
使用 /agent 切换智能体线程
- 输入
/agent或/subagents，然后按 Enter。 - 从选择器中选择所需线程。
预期结果：Codex 切换活动线程，让你可以检查该 智能体的工作或继续处理。
使用 /feedback 发送反馈
- 输入
/feedback，然后按 Enter。 - 按提示选择是否包含日志或诊断信息。
预期结果：Codex 收集请求的诊断信息并提交给 维护者。
使用 /logout 退出登录
- 输入
/logout，然后按 Enter。
预期结果：Codex 清除当前用户会话的本地凭据。
使用 /quit 或 /exit 退出 CLI
- 输入
/quit（或/exit），然后按 Enter。
预期结果：Codex 立即退出。请先保存或提交所有重要工作。
IDE 扩展命令
使用这些命令可从 VS Code Command Palette 控制 Codex。你也可以为它们绑定键盘快捷键。
分配键绑定
要为 Codex 命令分配或更改键绑定：
- 打开 Command Palette（macOS 上按 Cmd+Shift+P，Windows/Linux 上按 Ctrl+Shift+P）。
- 运行 Preferences: Open Keyboard Shortcuts。
- 搜索
Codex或命令 ID（例如chatgpt.newChat）。 - 选择铅笔图标，然后输入所需快捷键。
扩展命令
| 命令 | 默认键绑定 | 说明 |
|---|---|---|
chatgpt.addToThread |
- | 将所选文本范围添加为当前聊天的上下文 |
chatgpt.addFileToThread |
- | 将整个文件添加为当前聊天的上下文 |
chatgpt.newChat |
macOS: Cmd+N Windows/Linux: Ctrl+N |
创建新聊天 |
chatgpt.newCodexPanel |
- | 创建新的 Codex 面板 |
chatgpt.openCommandMenu |
- | 打开 Codex 命令菜单 |
chatgpt.openSidebar |
- | 打开 Codex 侧边栏面板 |
IDE 扩展斜杠命令
使用斜杠命令，无需离开输入框即可控制 Codex。可用它们检查状态、在本地与云端模式之间切换或发送反馈。
使用斜杠命令
- 在 Codex 输入框中输入
/。 - 从列表中选择命令，或继续输入以筛选（例如
/status）。 - 按 Enter。
可用的斜杠命令
| 斜杠命令 | 说明 |
|---|---|
/approve |
启用自动审查时，批准重试一次最近被自动审查拒绝的操作。 |
/cloud |
云端执行可用时，在云端运行聊天。 |
/cloud-environment |
选择聊天使用的云端环境。 |
/compact |
压缩当前聊天的上下文。 |
/fast |
可用时，开启或关闭目录提供的 Fast 服务层级。 |
/feedback |
打开反馈对话框以提交反馈，并可选择包含日志。 |
/fork |
将本地聊天复制为新的本地聊天。 |
/goal |
设置一个供 Codex 持续处理的持久目标。 |
/ide-context |
开启或关闭自动 IDE 上下文。 |
/init |
为当前项目生成 AGENTS.md 脚手架。 |
/local |
在本地工作区中运行聊天。 |
/mcp |
打开 MCP 状态以查看已连接的服务器。 |
/memories |
Memories 可用时，配置聊天是否可以使用或生成记忆。 |
/model |
选择当前聊天使用的模型。 |
/personality |
当前模型支持个性时，选择 Codex 的回复方式。 |
/plan |
切换用于多步骤规划的计划模式。 |
/project |
为新聊天选择项目。 |
/reasoning |
选择当前聊天的推理强度。 |
/review |
启动代码审查模式，以审查未提交的更改或与基础分支比较。 |
/side |
启动临时侧边聊天，而不中断主聊天。 |
/status |
显示聊天 ID、上下文用量和速率限制。 |
/worktree |
在新的 Git worktree 中运行聊天。 |