开发者命令

如需完整文档索引，请参阅 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。

命令概览

Maturity 列使用 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 令牌进行 --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 以包含受控字段和方法。

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

使用内置的应用服务器测试客户端，通过 app-server 的 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 中配对，以捕获机器可读的进度和最终的自然语言摘要。

交互式快捷键

• 键入 @ 以在工作区中搜索文件，并将其路径添加到提示中。
• 按 上 或 下 恢复草稿历史。
• 按 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 设置、项目文件和最近聊天。	将受支持的外部 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 切换到 macOS 或 Windows 上的桌面应用。
/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 配置 /import键入。
2. 选择你想迁移的 Claude Code 设置、项目文件或最近聊天。

预期： Codex 会打开外部 Agent 导入选择器，并将选定的 受支持工件导入到 Codex 配置和本地文件中。

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

使用 /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。

可用的状态行项目包括模型、模型+推理、上下文统计、速率 限制、 git branch、token 计数器、会话 ID、当前 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 在 Windows 上键入 /app 以在 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-07-31

官方原文 learn.chatgpt.com