开发者命令

如需完整文档索引，请参阅 llms.txt。文档页面的 Markdown 版本可通过在页面后追加 .md 来获取 URL。

ChatGPT 网页版有自己的编辑器命令菜单。输入 / 即可查看 当前聊天中可用的操作。它不会暴露 ChatGPT 桌面应用或 CLI 命令集；本 Codex 参考中的斜杠命令、 CLI 子命令和标志 不适用于 ChatGPT 网页版。

ChatGPT 桌面应用命令

通用的 命令 页面涵盖应用导航、 聊天快捷键、键盘自定义，以及用于聊天、设置、 技能、计划任务、插件和宠物的深层链接。

斜杠命令 页面涵盖 应用编辑器中可用的命令 包括 /feedback， /goal， /init， /mcp， /plan， /review，以及 /status。

如何阅读此参考

此页面列出了所有已记录的 Codex CLI 命令和标志。使用交互式表格按键或描述搜索。每个部分都会说明该选项是稳定还是实验性，并指出有风险的组合。

该 CLI 继承了大多数默认值，来源于 ~/.codex/config.toml。任何 -c key=value 你在命令行传入的覆盖项会 在该次调用中优先生效。请参阅 配置 基础 了解更多 信息。

全局标志

这些选项适用于基础 codex 命令。大多数会传播到命令； 例外情况请参见上面的说明或相关命令帮助。对于已传播的 标志，请遵循相关命令帮助。例如， codex exec --oss ... 会将 --oss 应用于 exec。

命令概览

“成熟度”列使用 Experimental、Beta、 和 Stable 等功能成熟度标签。请参阅 功能成熟度 了解如何 解读这些标签。

命令详情

codex （交互式）

运行 codex 且不带子命令会启动交互式终端 UI （TUI）。该 Agent 接受上面的全局标志以及图片附件。网页搜索默认使用缓存模式；使用 --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启动的应用服务器。对于本地 Unix 套接字，使用 --remote unix:// 表示默认套接字，或使用 --remote unix://PATH 指定显式路径。当服务器需要 bearer token 进行 --remote-auth-token-env 身份验证时，添加 WebSocket 。

codex app-server

在本地启动 Codex 应用服务器。这主要用于开发和调试，可能会不经通知而变更。

codex app-server --listen stdio:// 保留默认的 JSONL-over-stdio 行为，并且 codex app-server --stdio 是该传输方式的别名。 --listen ws://IP:PORT 启用 WebSocket 传输，供应用服务器客户端使用。服务器接受 ws:// 监听 URLs；当客户端通过 TLS 连接时，请使用 wss://终止或安全代理。使用 --listen unix:// 在 WebSocket 的默认 Unix 套接字上接受 Codex握手，或使用 --listen unix:///absolute/path.sock 选择套接字路径。如果你为客户端绑定生成架构，请添加 --experimental 以包含受控字段和方法。

添加 --code-mode-host wss://code-mode.example.com/host 可将应用服务器连接到 远程 Code Mode 主机，而不是启动本地主机。此出站 连接独立于 --listen ，并由 应用服务器进程中的每个线程共享。仅对 localhost 或 ws:// 转发的主机使用 SSH。

codex remote-control

运行 codex remote-control 以前台方式启动远程控制。使用 codex remote-control start 启动启用了远程 控制的本地应用服务器守护进程，并使用 codex remote-control stop 停止它。托管的 远程控制客户端和 SSH 远程工作流会使用这些命令；当你构建本地 协议客户端时，它们不能 codex app-server --listen 替代 。

守护进程运行后，使用 codex remote-control pair 创建并 打印一个短期有效的手动配对码。为任何远程控制 --json 命令添加 可获得机器可读输出。对于 pair， JSON 响应包含 pairingCode、 manualPairingCode、 environmentId和 expiresAt。

codex app

从终端在 ChatGPT 或 Windows 上启动 macOS 桌面应用。在 macOS上， Codex 可以打开特定工作区路径；在 Windows 上， Codex 会打印要 打开的路径。

codex app 会打开已安装的 ChatGPT 桌面应用；如果 应用缺失，则启动安装程序。在 macOS上， Codex 会打开提供的工作区路径；在 Windows 上，它会打印安装后要打开的路径。

codex debug app-server send-message-v2

通过应用服务器的 V2 thread/turn 流程，使用内置应用服务器测试客户端发送一条消息。

此调试流程使用 experimentalApi: true初始化，启动一个线程，发送一个回合，并流式传输服务器通知。使用它在本地复现和检查应用服务器协议行为。

codex debug models

打印 Codex 看到的原始模型目录，格式为 JSON。

当你只想检查当前二进制文件捆绑的目录，而不从远程模型端点刷新时，请使用 --bundled 。

codex debug prompt-input

将模型可见的精确提示输入列表渲染为 JSON。在调试 指令发现、会话上下文或提示构造时使用此项。

codex apply

将 Codex cloud 聊天中的最新 diff 应用到你的本地仓库。你必须进行身份验证，并拥有该聊天的访问权限。

Codex 会打印已修补的文件，并在 git apply 失败时以非零状态退出（例如由于冲突）。

codex review

以非交互方式运行代码审查。只选择一个审查目标，或传入 自定义审查说明作为提示。

--uncommitted、 --base、 --commit和自定义 PROMPT 彼此 冲突。仅将 --title 与 --commit一起使用。

codex archive 和 codex unarchive

按会话 ID 或会话名称归档或恢复已保存的交互式会话。 当你想清理会话选择器但不删除 转录记录时，请使用这些命令。会话 IDs 优先于会话名称。

codex archive
codex unarchive

codex delete

按会话 ID 或会话名称永久删除已保存的交互式会话。 仅当你想移除转录记录，而不是将其从 活动会话列表中隐藏时，才使用此项。

codex delete
codex delete   --force

仅将 --force 与会话 UUID一起使用。命名会话仍需要 确认，这样 Codex 就不会在没有提示的情况下删除重复或不明确的名称。

codex cloud

从终端与 Codex cloud 聊天交互。默认命令会打开交互式选择器； codex cloud exec 会直接提交任务，而 codex cloud list 会返回最近的聊天，供脚本或快速检查使用。

身份验证使用与主 CLI相同的凭据。 Codex 如果任务提交失败，会以非零状态退出。

codex cloud list

列出最近的云端聊天，支持可选过滤和分页。

纯文本输出会打印一个任务 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"。

codex doctor

在提交支持问题之前，或 调查损坏的 Codex 安装时，生成本地诊断报告。该报告会检查安装、 配置、身份验证、运行时、Git、终端、应用服务器和线程 清单健康状况。

codex features

管理存储在 $CODEX_HOME/config.toml中的功能标志。 enable 和 disable 命令会持久化更改，使其应用于未来会话。 features 子命令不接受 --profile。

codex exec

对于应在无人交互下完成的脚本化或 codex exec （或简写形式 codex e）风格运行，请使用 CI。

Codex 默认写入格式化输出。添加 --json 可接收换行分隔的 JSON 事件（每次状态变化一个）。可选的 resume 子命令允许你继续非交互式任务。使用 --last 从当前工作目录选择最近的会话，或添加 --all 在所有会话中搜索：

codex execpolicy

保存 execpolicy 规则文件之前先检查它们。 codex execpolicy check 接受一个或多个 --rules 标志（例如 ~/.codex/rules下的文件），并发出 JSON ，显示最严格的决策和任何匹配规则。添加 --pretty 可格式化输出。 execpolicy 命令目前处于预览阶段。

codex login

使用 CLI 账户、 ChatGPT 密钥或访问令牌对 API 进行身份验证。不带标志时， Codex 会打开浏览器以执行 ChatGPT OAuth 流程。

codex login status 当存在凭据时会以 0 退出，这对自动化脚本很有用。

codex logout

移除 API 密钥和 ChatGPT 身份验证的已保存凭据。此命令没有标志。

codex mcp

管理存储在 Model Context Protocol 中的 ~/.codex/config.toml服务器条目。

该 add 子命令同时支持 stdio 和可流式 HTTP 传输：

OAuth 操作（login、 logout）仅适用于可流式 HTTP 服务器（并且仅当服务器支持 OAuth时）。

codex plugin

从已配置的市场安装、列出和移除插件。

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 可以浏览和安装的插件市场来源。

codex plugin marketplace add 接受 GitHub 等简写，例如 owner/repo 或 owner/repo@ref、 HTTP 或 HTTPS Git URLs、 SSH Git URLs，以及本地市场 根目录。使用 --ref 固定 Git ref，并重复 --sparse PATH 以 对 Git 支持的市场仓库使用稀疏检出。

codex plugin marketplace list 会打印作用域内的市场名称和根目录， 包括隐式发现的默认市场和已配置的市场 快照。

向市场 add、list、upgrade 或 remove 命令添加 --json 以获得 便于自动化的输出。市场 add JSON 包含 marketplaceName、 installedRoot和 alreadyAdded；list JSON 包含一个 marketplaces 数组 ，其中含有 name、 root和可选的 marketplaceSource；upgrade JSON 包含 selectedMarketplaces、 upgradedRoots和 errors；remove JSON 包含 marketplaceName 和 installedRoot。

codex mcp-server

将 Codex 作为 MCP 服务器通过 stdio 运行，以便其他工具连接。此命令继承全局配置覆盖项，并在下游客户端关闭连接时退出。

codex resume

按 ID 继续交互式会话，或恢复最近的聊天。 codex resume 会将 --last 限定在当前工作目录，除非你传入 --all。它接受与 codex相同的全局标志，包括模型和沙箱覆盖项。

如果当前工作目录不同于会话保存的目录， Codex 会询问要使用哪个目录。将 tui.resume_cwd 设为 "current" 或 "session" 可在不提示的情况下复用该选择。显式的 --cd （-C） 覆盖项优先于 tui.resume_cwd。

codex fork

将之前的交互式会话分叉为新的聊天。默认情况下， codex fork 会打开会话选择器；添加 --last 可改为分叉你最近的会话。

当当前目录和保存的会话目录不同时， codex fork 会使用与 相同的工作目录提示和 tui.resume_cwd 设置，即 codex resume。

codex sandbox

使用沙箱辅助工具在与 Codex 内部使用的相同策略下运行命令。

macOS seatbelt

Linux Landlock

Windows

codex update

检查并应用 Codex CLI 更新，前提是已安装版本支持自更新。调试构建会打印消息，提示你改为安装发布构建。

标志组合和安全提示

• 对于可以留在工作区内的无人值守本地工作，请使用 --sandbox workspace-write ，并避免使用 --dangerously-bypass-approvals-and-sandbox ，除非你处于专用沙箱 VM内。
• 当你需要授予 Codex 对更多目录的写入权限时，优先使用 --add-dir ，而不是强制使用 --sandbox danger-full-access。
• 将 --json 与 --output-last-message 配合用于 CI ，以捕获机器可读的进度和最终的自然语言摘要。

交互式快捷键

• 输入 @ 可在工作区中搜索文件，并将其路径添加到提示中。
• 按 Up 或 Down 恢复草稿历史。
• 按 Ctrl+R 搜索提示历史，然后按 Enter 使用匹配项，或按 Esc 取消。
• 按 Ctrl+O 或运行 /copy 复制最新完成的 Codex 输出。
• 在一行前加上 ! ，可在当前审批和沙箱设置下运行本地 shell 命令。
• 当 正在工作时，按 Tab Codex 可将后续提示、斜杠命令或 shell 命令排队到下一回合。
• 当 正在工作时，按 Enter Codex 可将新指令注入当前回合。
• 在空编辑器中按 Esc 两次，可编辑上一条用户消息，并从该点分叉聊天。
• 按 Ctrl+C 或运行 /exit 关闭会话。

相关资源

• Codex CLI 概览：安装、升级和快速提示。
• 配置基础：持久化模型和提供方等默认值。
• 高级配置：配置文件、提供方、沙箱调优和集成。
• AGENTS.md： Codex Agent 能力和最佳实践的概念概览。

斜杠命令让你能够以键盘优先的方式快速控制 Codex。在 / 编辑器中输入 可打开斜杠弹窗，选择一个命令，然后 Codex 会执行 切换模型、调整权限或总结长 聊天等操作，而无需离开终端。

本指南将展示如何：

• 为任务找到合适的内置斜杠命令
• 使用如下命令引导活动会话： /model、 /fast、 /personality、 /permissions、 /approve、 /raw、 /agent和 /status

内置斜杠命令

Codex 随附以下命令。打开斜杠弹窗并开始输入 命令名称以筛选列表。

当聊天已经在运行时，你可以输入斜杠命令并按 Tab 以 将其排队到下一回合。 Codex 会在运行时解析排队的斜杠命令，因此 命令菜单和错误会在当前回合结束后出现。斜杠 补全在你排队命令前仍然可用。

命令	用途	何时使用
/permissions	设置 Codex 无需先询问即可执行的操作。	在会话中途放宽或收紧审批要求，例如在 Auto 和 Read Only 之间切换。
/ide	包含打开的文件、当前选择和其他 IDE 上下文。	将编辑器上下文拉入下一条提示，而无需重新说明你的 IDE中打开了什么。
/keymap	重新映射 TUI 键盘快捷键。	检查并持久化 config.toml中的自定义快捷键绑定。
/vim	切换编辑器的 Vim 模式。	在 Vim normal/insert 行为和默认编辑器编辑模式之间切换。
/setup-default-sandbox	设置提升权限的 Agent 沙箱（仅 Windows）。	在 Codex 提供提升权限设置后，替换降级的 Windows 沙箱。
/sandbox-add-read-dir	授予沙箱对额外目录的读取权限（仅 Windows）。	解除需要读取当前可读根目录之外绝对目录路径的命令阻塞。
/agent、 /subagents	切换活动 Agent 线程。	检查或继续生成的子 Agent 线程中的工作。
/apps	浏览应用（连接器）并将其插入你的提示。	在请求 $app-slug 使用应用之前，将应用作为 Codex 附加。
/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 设置、项目和聊天。	将受支持的外部 Agent 构件迁移到 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 桌面应用中继续当前会话。	在 TUI 或 Windows 上，从 macOS 切换到桌面应用。
/side、 /btw	启动临时侧边聊天。	提出聚焦的后续问题，而不扰乱主聊天的转录记录。
/raw	切换原始回滚模式。	在查看长输出时，让终端选择和复制减少格式化。
/resume	从会话列表恢复已保存的聊天。	从之前的 CLI 会话继续工作，而无需重新开始。
/new	在同一个 CLI 会话内开始新聊天。	当你想在同一仓库中使用新提示时，不离开 CLI 即可重置聊天上下文。
/quit	退出 CLI。	立即离开会话。
/review	要求 Codex 审查你的工作树。	在 Codex 完成工作后运行，或在你希望有人再看一遍本地更改时运行。
/status	显示会话配置和 token 使用量。	确认活动模型、审批策略、可写根目录和剩余上下文容量。
/usage	查看账户 token 使用量，或使用速率限制重置。	在 ChatGPT 内检查每日、每周或累计 TUItoken 活动。
/debug-config	打印配置层和要求诊断。	调试优先级和策略要求，包括实验性网络约束。
/statusline	交互式配置 TUI 状态行字段。	选择并重新排序页脚项目（model/context/limits/git/tokens/session），并持久化到 config.toml中。
/title	交互式配置终端窗口或标签标题字段。	选择并重新排序项目、状态、线程、分支、模型和任务进度等标题项。
/theme	选择语法高亮主题。	预览并持久化终端语法高亮主题。
/pets、 /pet	选择或隐藏终端宠物。	用内置或自定义氛围宠物个性化 TUI 。

/quit 和 /exit 都会退出 CLI。仅在保存或 提交任何重要工作后使用它们。

使用 /permissions 调整 Codex 无需先询问即可执行的操作。仅当你需要重试最近被自动审查 /approve 拒绝的操作时，才使用 。

使用斜杠命令控制你的会话

以下工作流可让你的会话保持正轨，而无需重新启动 Codex。

使用 /model

1. 设置活动模型 Codex 启动并打开编辑器。
2. 输入 /model 并按 Enter。
3. 从弹窗中选择 gpt-5.6-luna 或 gpt-5.6-terra 等模型。

预期： Codex 会在转录记录中确认新模型。运行 /status 验证更改。

使用 /fast

1. 切换 Fast 模式 /fast 输入以开启当前模型的 Fast 服务层级。
2. 再次输入 /fast 将其关闭。

预期： Codex 会切换层级并保存选择。在 TUI 页脚中， 你也可以使用 /statusline显示 Fast 模式状态行项。

Fast 层级命令由目录驱动。如果当前模型未声明 Fast 层级， Codex 不会显示 /fast。

使用 /personality

设置沟通风格 /personality 使用 Codex 更改

1. 的沟通方式，而无需重写提示。 /personality 在活动聊天中输入并按 Enter。
2. 从弹窗中选择一种风格。

预期： Codex 会在转录记录中确认新风格，并将其用于之后的 聊天响应。

Codex 支持 friendly、 pragmatic和 none 人格。使用 none 禁用人格指令。

如果活动模型不支持特定人格指令， Codex 会隐藏此命令。

使用 /plan

1. 切换到计划模式 /plan 输入并按 Enter，将活动聊天切换到计划 模式。
2. 可选：提供内联提示文本（例如 /plan Propose a migration plan for this service）。
3. 使用内联 /plan 参数时，你可以粘贴内容或附加图片。

预期： Codex 进入计划模式，并将你的可选内联提示用作第一个规划请求。

当 Codex 已经在工作时， /plan 会暂时不可用。

使用 /goal

1. 设置或查看任务目标 /goal <objective> 输入以设置目标，例如 /goal Finish the migration and keep tests green。
2. 输入 /goal 查看当前目标。
3. 使用 /goal edit 修订目标。使用 /goal pause、 /goal resume或 /goal clear 暂停、恢复或移除它。

预期： Codex 会在工作继续时，将目标附加到活动聊天。

目标内容不能为空，且最多 4,000 个字符。对于更长的 说明，请将细节放入文件，并让目标指向该文件。

使用 /experimental

1. 切换实验性功能 /experimental 输入并按 Enter。
2. 切换你想要的功能（例如 Network proxy 或 Prevent sleep while running），然后在提示要求时重启 Codex 。

预期： Codex 会将你的功能选择保存到配置，并在重启后应用。

使用 /approve

批准自动审查拒绝 /approve 当自动审查器拒绝了最近的操作，而你希望 Codex 重试一次时，请使用。

1. 输入 /approve。
2. 当 Codex 显示相关被拒绝的操作时，确认重试。

预期： Codex 会在当前会话 策略下重试该被拒绝的操作一次。

使用 /memories

1. 配置记忆 /memories输入。
2. 选择 Codex 是否应使用现有记忆、生成新记忆，或 保持记忆行为禁用。

预期： Codex 会更新未来会话的相关记忆设置。

使用 /skills

1. 使用技能 /skills输入。
2. 选择你希望 Codex 应用的技能。

预期： Codex 会插入所选技能上下文，使下一次请求遵循 该技能的指令。

使用 /import

1. 导入 Claude Code 或 Cursor 设置 /import输入。
2. 选择 Claude Code 或 Cursor。
3. 选择你想迁移的设置、项目文件或最近聊天。

预期： Codex 会打开外部 Agent 导入选择器，并将选定的 受支持构件导入到 Codex 配置和本地文件中。会话发现 包含最近 30 天内最多 50 个聊天。

从本地 /import 会话运行 TUI 。任务运行时、 远程会话中，以及连接到本地应用服务器守护进程时不可用。

有关桌面应用工作流和受支持的构件类型，请参阅 从 另一个 Agent 导入。

使用 /clear

1. 清除终端并开始新聊天 /clear 输入并按 Enter。

预期： Codex 会清除终端，重置可见转录记录，并在同一 会话中开始 CLI 新聊天。

若要在创建新聊天时为其命名，请运行 /clear release prep。

不同于 Ctrl+L， /clear 会开始新聊天。

Ctrl+L 只清除终端视图，并保留当前 聊天。 Codex 会在任务进行中禁用这两个操作。

使用 /archive

1. 归档当前会话 /archive 输入并按 Enter。
2. 确认你要归档当前会话并退出 Codex。

预期： Codex 会归档当前会话并关闭交互式 TUI。 Codex 会将会话转录记录保存在本地；之后可用 codex unarchive 恢复它。

/archive 在任务运行时不可用。

使用 /delete

1. 删除当前会话 /delete 输入并按 Enter。
2. 确认你要删除当前会话并退出 Codex。

预期： Codex 会删除当前会话转录记录并关闭 交互式 TUI。删除是永久的，也会移除生成的后代 会话。

/delete 在聊天运行中或侧边聊天中不可用。

使用 /permissions

1. 更新权限 /permissions 输入并按 Enter。
2. 选择符合你舒适程度的审批预设，例如 Auto 用于免干预运行，或 Read Only 用于审查编辑。当命名的 权限配置文件处于活动状态时，选择器还会显示已配置的自定义 配置文件及其描述。

预期： Codex 会宣布已更新的策略。未来操作会遵循 更新后的审批模式，直到你再次更改。

使用 IDE 包含 /ide

1. 上下文 /ide输入。
2. 如果你想说明 Codex 应如何处理 当前 IDE 选择或打开的文件，可添加可选内联文本。

预期： Codex 会在下一条提示中包含可用的 IDE 上下文。

使用 /vim

1. 切换 Vim 模式 /vim输入。
2. 继续在编辑器中编辑。

预期： Codex 会切换当前会话的编辑器 Vim 模式。若要让 Vim 模式成为新会话默认值，请在 tui.vim_mode_default = true 中设置 config.toml。

使用 /setup-default-sandbox

设置提升权限的 Windows 沙箱 Codex 此命令仅在 Windows 上且 正在使用降级的受限令牌沙箱时出现。

1. 输入 /setup-default-sandbox。
2. 按照管理员设置流程操作。

预期： Codex 会配置提升权限的 Windows 沙箱，并选择 对应的自动审批预设。

使用 /copy

1. 复制最新响应 /copy 输入并按 Enter。

预期： Codex 会将最新完成的 Codex 输出复制到剪贴板。

如果某个回合仍在运行， /copy 会使用最新完成的输出，而不是 进行中的响应。在第一个完成的 Codex 输出之前以及回滚后立即不可用。

你也可以在主 中按Ctrl+ O TUI 来复制 最新完成的响应，而无需打开斜杠命令菜单。

使用 /raw

1. 切换原始回滚 /raw、 /raw on或 /raw off。

预期： Codex 会切换原始回滚模式，使终端选择和 复制更直接。你也可以使用默认的 Alt+R 绑定，或使用 tui.raw_output_mode = true持久化默认值。

使用 /sandbox-add-read-dir

授予沙箱读取权限 CLI 此命令仅在 Windows 上原生运行

1. 时可用。 /sandbox-add-read-dir C:\absolute\directory\path 输入并按 Enter。
2. 确认该路径是现有的绝对目录。

预期： Codex 会刷新 Windows 沙箱策略，并授予对 该目录的读取权限，供之后在沙箱中运行的命令使用。

使用 /status

1. 检查会话 /status在任何聊天中输入。
2. 查看输出中的活动模型、审批策略、可写根目录和 当前 token 使用量。当 TUI 远程连接时，输出还会 显示远程地址和服务器版本。

预期： Codex 会打印摘要，确认它正在你 期望的位置运行。

使用 /usage

1. 查看账户使用量 /usage 输入以打开使用量菜单。
2. 选择显示 token 活动或兑换可用的已获得重置。
3. 若要直接打开 token 活动，请输入 /usage daily、 /usage weekly或 /usage cumulative。

预期： Codex 会打开使用量操作，或显示所选视图的账户 token 活动。如果会话没有 服务账户身份验证， Codex 会显示登录要求。 Codex 检查配置层

使用 /debug-config

1. 。 /debug-config查看输出中的配置层顺序（最低优先级在前）、
2. 状态和策略来源。 on/off 预期：

会打印层诊断以及策略详情，例如 Codex 、 allowed_approval_policies、 allowed_sandbox_modes、 mcp_servers、 rules和 enforce_residency（如果已配置）。 experimental_network 使用此输出调试为什么有效设置不同于

。 config.toml配置页脚项

使用 /statusline

1. 。 /statusline使用选择器切换并重新排序项目，然后确认。
2. 预期：页脚状态行会立即更新，并持久化到

中的 tui.status_line 。 config.toml可用的状态行项目包括模型、模型+推理、上下文统计、速率

限制、 、token 计数器、会话 id、当前 git branch根目录、 directory/project 和 版本。 Codex 配置终端标题项

使用 /title

1. 。 /title使用选择器切换并重新排序项目，然后确认。
2. 预期：终端窗口或标签标题会立即更新，并持久化到

中的 tui.terminal_title 。 config.toml可用的标题项包括应用名称、项目、加载指示器、状态、线程、

、模型和任务进度。 git branch选择语法主题

使用 /theme

1. 。 /theme从选择器预览主题，然后确认。
2. 预期：

会更新语法高亮，并将选择持久化到 Codex 中的 tui.theme 。 config.toml选择终端宠物

使用 /pets

1. （或 /pets ）打开宠物选择器。 /pet选择内置或自定义宠物，或关闭宠物。
2. 预期：

会在受支持的终端中显示所选氛围宠物，并 Codex 持久化该选择。你也可以输入 将其隐藏。 /pets off 使用

重新映射 TUI 快捷键 /keymap

使用 /keymap 检查、更新并持久化 TUI的键盘快捷键绑定。

1. 输入 /keymap。
2. 选择你想更改的快捷键上下文和操作。
3. 输入新绑定或移除现有绑定。

预期： Codex 会更新活动键映射，并将自定义绑定写入 tui.keymap 中的 config.toml。

按键绑定使用 ctrl-a、 shift-enter和 page-down等名称。特定上下文绑定会覆盖 tui.keymap.global；空绑定列表会解绑该操作。

检查后台终端 /ps

1. 使用 /ps。
2. 查看后台终端列表及其状态。

预期： Codex 会显示每个后台终端的命令，以及最多三行 最近的非空输出，让你一眼判断进度。

当 unified_exec 正在使用时，会出现后台终端；否则列表可能为空。

停止后台终端 /stop

1. 使用 /stop。
2. 如果 Codex 在停止列出的终端前询问，请确认。

预期： Codex 会停止当前会话的所有后台终端。 /clean 仍可作为 /stop的别名使用。

使用 /compact

1. 保持转录记录精简 /compact长时间交流后，输入。
2. 当 Codex 提出总结到目前为止的聊天时，确认。

预期： Codex 会用简洁摘要替换早期回合，释放上下文 同时保留关键细节。

使用 /diff

1. 审查更改 /diff 输入以检查 Git diff。
2. 在 CLI 内滚动输出以审查编辑和新增文件。

预期： Codex 会显示你已暂存的更改、尚未暂存的更改， 以及 Git 尚未开始跟踪的文件，以便你决定保留哪些内容。

使用 /mention

1. 突出显示文件 /mention 输入后跟路径，例如 /mention src/lib/api.ts。
2. 从弹窗中选择匹配结果。

预期： Codex 会将文件添加到聊天，确保后续回合直接引用它。

使用 /new

1. 开始新聊天 /new 输入并按 Enter。

预期： Codex 会在同一 CLI 会话中开始新聊天，这样你 无需离开终端即可切换聊天。

若要在创建新聊天时为其命名，请运行 /new bug bash。

不同于 /clear， /new 不会先清除当前终端视图。

使用 /rename

1. 重命名当前聊天 /rename <name>输入，或输入 /rename 打开命名提示。
2. 输入一个简短名称，帮助你之后找到该聊天。

预期： Codex 会更新已保存的聊天名称，而不更改其转录记录。

使用 /resume

1. 恢复已保存的聊天 /resume 输入并按 Enter。
2. 从已保存会话选择器中选择所需会话。

预期： Codex 会重新加载所选聊天的转录记录，让你可以从 离开的地方继续，同时保持原始历史不变。

使用 /fork

1. 分叉当前聊天 /fork 输入并按 Enter。

预期： Codex 会将当前聊天克隆为带有新 ID的新聊天，保持原始转录记录不变，以便你并行探索替代 方法。

如果你需要分叉已保存会话而不是当前会话，请在终端中运行 codex fork 以打开会话选择器。

使用 /app

在桌面应用中继续 macOS 在 /app 和 Windows 上，输入 ChatGPT 以在 Codex 桌面应用中打开当前会话。如果应用未安装或未运行， 会显示错误，要求你安装或启动它。

预期：桌面应用会打开同一个已保存聊天，让你可以在那里继续。

使用 /side

启动侧边聊天 /side 使用可从当前聊天启动临时分叉，而不切换离开主聊天。

1. 输入 /side 打开侧边聊天。
2. 可选添加内联文本，例如 /side Check whether this plan has an obvious risk。
3. 聚焦的支线结束后返回父聊天。

预期： Codex 会打开一个侧边聊天，其转录记录独立于 父聊天。当你处于侧边模式时， TUI 会继续显示 父聊天的状态，以便你查看主聊天是否仍在运行。

/side 在另一个侧边聊天内和审查模式期间不可用。

使用 AGENTS.md 生成 /init

1. 运行 /init ，在你希望 Codex 查找持久化指令的目录中执行。
2. 查看生成的 AGENTS.md，然后编辑它以匹配你的仓库约定。

预期： Codex 会创建一个 AGENTS.md 脚手架，你可以完善并提交供 未来会话使用。

使用 /review

1. 请求工作树审查 /review输入。
2. 如果你想检查确切的文件更改，请继续使用 /diff 。

预期： Codex 会总结它在你的工作树中发现的问题，重点关注 行为变更和缺失测试。除非你在 中设置 review_model ，否则它会使用当前会话模型。 config.toml。

使用 MCP 列出 /mcp

1. 工具 /mcp输入。
2. 查看列表，确认哪些 MCP 服务器和工具可用。

预期：你会看到已配置的 Model Context Protocol （MCP）工具， Codex 可在此会话中调用。

使用 /mcp verbose 包含详细服务器诊断。如果你传入 verbose以外的任何内容， Codex 会显示命令用法。

使用 /apps

1. 浏览应用 /apps输入。
2. 从列表中选择一个应用。

预期： Codex 会将应用提及作为 $app-slug插入编辑器，这样 你就可以立即请求 Codex 使用它。

使用 /plugins

1. 浏览插件 /plugins输入。
2. 选择一个市场标签，然后选择一个插件以检查其能力或可用操作。

预期： Codex 会打开插件浏览器，让你查看已安装插件、 你的配置允许发现的插件，以及已安装插件状态。 在已安装插件上按 Space 可切换其启用状态。

使用 /hooks

1. 查看和管理生命周期钩子 /hooks输入。
2. 选择一个钩子事件以检查匹配的处理器。
3. 根据需要信任、禁用或重新启用非托管钩子。

预期： Codex 会打开钩子浏览器，让你查看已配置的生命周期 钩子。托管钩子会显示为托管，且不能从用户钩子 浏览器禁用。

使用 /agent

1. 切换 Agent 线程 /agent 输入 /subagents 或并按 Enter。
2. 从选择器中选择所需线程。

预期： Codex 会切换活动线程，让你可以检查或继续该 Agent 的工作。

使用 /feedback

1. 发送反馈 /feedback 输入并按 Enter。
2. 按照提示包含日志或诊断信息。

预期： Codex 会收集请求的诊断信息，并提交给 维护者。

使用 /logout

1. 退出登录 /logout 输入并按 Enter。

预期： Codex 会清除当前用户会话的本地凭据。

使用 CLI 或 /quit 退出 /exit

1. 输入 /quit （或 /exit）并按 Enter。

预期： Codex 会立即退出。请先保存或提交任何重要工作。

使用这些命令来控制 Codex 从 VS Code 命令面板。你也可以将它们绑定到键盘快捷键。

分配按键绑定

要为 Codex 命令分配或更改按键绑定：

1. 打开命令面板（Cmd+Shift+P 在 macOS 或 Ctrl+Shift+P 在 Windows/Linux）。
2. 运行 Preferences: Open Keyboard Shortcuts。
3. 搜索 Codex 或该命令 ID （例如， chatgpt.newChat）。
4. 选择铅笔图标，然后输入你想要的快捷键。

扩展命令

命令	默认按键绑定	描述
chatgpt.addToThread	-	将选中的文本范围作为当前聊天的上下文添加
chatgpt.addFileToThread	-	将整个文件作为当前聊天的上下文添加
chatgpt.newChat	macOS： Cmd+N\
Windows/Linux： Ctrl+N	创建新聊天
chatgpt.newCodexPanel	-	创建新的 Codex 面板
chatgpt.openCommandMenu	-	打开 Codex 命令菜单
chatgpt.openSidebar	-	打开 Codex 侧边栏面板

斜杠命令可让你控制 Codex 而无需离开输入框。使用它们检查状态、在本地和云模式之间切换，或发送反馈。

使用斜杠命令

1. 在 Codex 输入框中，键入 /。
2. 从列表中选择一个命令，或继续输入以筛选（例如， /status）。
3. 按 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 中运行聊天。

翻译与来源声明

身份 非官方简体中文镜像

翻译状态 AI 翻译

来源版本 官方未提供

同步日期 2026-08-12

官方原文 learn.chatgpt.com