命令

Codex 中文站说明： 本页围绕“命令”重新补充了中文使用场景和验证重点。界面名称可能随 Codex 版本更新，请以当前客户端为准。

ChatGPT 桌面 App 的命令与键盘快捷键参考

使用以下命令和键盘快捷键在 App 中导航。

键盘快捷键

分类	操作	快捷键
通用	命令菜单	Cmd/Ctrl + Shift + P 或 Cmd/Ctrl + K
	设置	Cmd/Ctrl + ,
	键盘快捷键	Cmd/Ctrl + Shift + /
	打开文件夹	Cmd/Ctrl + O
	后退	Cmd/Ctrl + [
	前进	Cmd/Ctrl + ]
	增大字号	Cmd/Ctrl + +
	减小字号	Cmd/Ctrl + -
	切换侧边栏	Cmd/Ctrl + B
	打开评审 tab	Ctrl + Shift + G
	切换评审面板	Cmd/Ctrl + Alt + B
	切换底部面板	Cmd/Ctrl + J
	切换终端	Ctrl + `
	清空终端	Ctrl + L
Chat	Quick chat	Cmd + Option + N（macOS）或 Ctrl + Alt + N（Windows）
	新建聊天	Cmd/Ctrl + N 或 Cmd/Ctrl + Shift + O
	搜索聊天	Cmd/Ctrl + G
	在聊天中查找	Cmd/Ctrl + F
	上一个聊天	Cmd/Ctrl + Shift + [
	下一个聊天	Cmd/Ctrl + Shift + ]
输入	听写	Ctrl + Shift + D

要查找、自定义或重置快捷键，请打开 Settings > Keyboard Shortcuts（设置 > 键盘快捷键）。可以按命令名称搜索，也可以把搜索框切换到按键模式，再按下想要查找的组合键。

搜索过去的聊天并在聊天中查找

使用聊天搜索（Cmd/Ctrl + G）重新打开过去的聊天。扩展匹配可用时，它还可以匹配聊天内容和 Git 分支名，因此可以搜索聊天中的某个短语，或 fix/login-redirect 这样的分支。

打开聊天后，使用 Find in chat（在聊天中查找）（Cmd/Ctrl + F）搜索其中的文本。该功能不会跨其他聊天搜索。

以 / 开头的操作参见 Slash commands。

Deep links

为保持兼容性，ChatGPT 桌面 App 继续使用 codex:// URL scheme，因此链接可以直接打开 App 的特定区域。把 query string 值加入 URL 前，应先进行编码。

支持的链接

创建链接时请使用以下权威形式。后续章节会按链接类型列出完整参考。

Deep link	打开的内容
`codex://threads/new`	新本地聊天。
`codex://new?<query>`	至少包含一个 query 参数的新本地聊天。
`codex://threads/<thread-id>`	本地聊天；`<thread-id>` 是技术层面的 thread ID。
`codex://settings`	Settings。
`codex://settings/connections/<connection-type>`	Computer、设备或 SSH 连接设置。
`codex://settings/connections/ssh/add?name=<ssh-config-host>`	从 SSH config 向 Codex 添加主机。
`codex://skills`	Skills。
`codex://automations`	Scheduled，并打开创建流程。
`codex://plugins/install/<plugin-name>?marketplace=<marketplace-name>`	从已知 marketplace 安装 plugin 的流程。
`codex://plugins/<plugin-id>`	plugin 详情页。
`codex://plugins/<plugin-name>?marketplacePath=<absolute-marketplace-path>`	本地 marketplace 中的 plugin 详情页。
`codex://pets/install?name=<pet-name>&imageUrl=<https-image-url>`	pet 安装流程。

聊天

需要打开现有本地聊天或开始新聊天时，使用以下链接。

Deep link	打开的内容
`codex://threads/<thread-id>`	本地聊天；`<thread-id>` 是技术层面的 thread ID。
`codex://threads/new`	新本地聊天。
`codex://threads/new?<query>`	带可选 query 参数的新本地聊天。
`codex://new?<query>`	新本地聊天。必须至少包含 `prompt`、`path` 或 `originUrl` 之一，否则链接不会执行任何操作。

对于 codex://threads/new 或 codex://new，可以按需添加并组合以下 query 参数。

Query 参数	必填	作用
`prompt=<text>`	否	设置输入框中的初始文本。
`path=<absolute-path>`	否	在本地工作区中打开新聊天。`path` 必须是本地目录的绝对路径；有效时 Codex 会把该目录用作当前工作区。
`originUrl=<git-remote-url>`	否	按 Git remote URL 匹配当前某个工作区根目录。如果同时提供 `path`，Codex 会优先解析 `path`。

示例：查看一些关于我如何使用 Codex 的有趣统计信息

使用 plugin 开始聊天

如果希望帮助用户发起由 plugin 支持的聊天，请先把 plugin mention 放进提示词，再对完整提示词进行编码：

text

[@Example](plugin://example@openai-curated) Summarize this document: https://example.com/document/123

把完整提示词编码为 URI component，例如在 JavaScript 中使用 encodeURIComponent，然后将它传给 prompt 参数：

text

codex://new?prompt=%5B%40Example%5D(plugin%3A%2F%2Fexample%40openai-curated)%20Summarize%20this%20document%3A%20https%3A%2F%2Fexample.com%2Fdocument%2F123

该链接会打开一个新聊天，并把解码后的提示词放入输入框，但不会自动发送。用户发送后，Codex 即可在该聊天中使用已安装的 plugin。如果尚未安装、但用户可以使用该 plugin，Codex 会提示用户安装它，并连接所需的连接器。设置完成后，用户可以选择 Continue（继续），在同一聊天中继续。工作区设置可能会限制用户可以安装哪些 plugins。有关 plugin 安装与权限的详细信息，请参阅 Plugins。

设置

需要打开 Settings 或特定设置页时，使用以下链接。

Deep link	打开的内容
`codex://settings`	Settings。
`codex://settings/browser-use`	Browser 设置。
`codex://settings/computer-use/google-chrome`	用于 Computer Use 的 Google Chrome 设置。
`codex://settings/connections`	远程连接设置。
`codex://settings/connections/computer`	从其他设备控制当前 Mac 或 PC 的设置。
`codex://settings/connections/devices`	控制其他设备的设置。
`codex://settings/connections/ssh`	SSH 连接设置。
`codex://settings/connections/ssh/add?name=<ssh-config-host>`	把指定主机别名添加为 Codex 管理的连接，再打开 SSH 连接设置。

name 值必须与 ~/.ssh/config 中的主机别名匹配。该链接会为新增主机禁用自动连接。如果 Codex 找不到指定主机，会打开 SSH 连接设置并显示错误。

不受支持的 codex://settings/... 路径会打开 Settings 主页。

Skills

需要打开 Skills 时使用：

Deep link	打开的内容
`codex://skills`	Skills。

Scheduled

需要打开 Scheduled 时使用：

Deep link	打开的内容
`codex://automations`	Scheduled，并打开创建流程。

Plugins

根据是从 marketplace 安装、打开 plugin，还是使用本地 marketplace.json，plugin 链接会采用不同形式。基础说明参见 Plugins；本地或仓库 marketplace 设置参见构建 plugins。

安装 plugin

使用以下形式打开 Codex 已知 marketplace 中某个 plugin 的安装流程。

Deep link	打开的内容
`codex://plugins/install/<plugin-name>?marketplace=<marketplace-name>`	plugin 详情页或安装流程。

Query 参数	必填	作用
`marketplace=<marketplace-name>`	是	标识 marketplace。OpenAI 精选 plugin 使用 `openai-curated`。

安装链接只接受 marketplace query 参数。如果 Codex 找不到请求的 marketplace 或 plugin，会改为打开 Plugins 页面。

Plugin 详情

Deep link	打开的内容
`codex://plugins/<plugin-id>`	plugin 详情页。

<plugin-id> 必须能够标识 plugin。OpenAI 精选 plugin 使用 <plugin-name>@openai-curated 形式。

Codex 生成的 plugin 链接还可能包含以下 query 参数。手动编写链接时，请省略这两个参数。

Query 参数	必填	作用
`hostId=<host-id>`	否	标识拥有 plugin 上下文的 Codex host，例如 `local` 或某个已配置的远程连接。这些 ID 由 Codex 提供。
`source=manage`	否	保留 App 的 plugin 管理入口；它并非仅供管理员使用。

示例：打开 OpenAI Developers plugin

本地 plugin

本地或仓库 marketplace 设置参见构建 plugins。

Deep link	打开的内容
`codex://plugins/<plugin-name>?marketplacePath=<absolute-marketplace-path>`	本地 marketplace 中的 plugin 详情页。

Query 参数	必填	作用
`marketplacePath=<absolute-marketplace-path>`	是	本地 `marketplace.json` 的绝对路径，例如 `/Users/alex/.agents/plugins/marketplace.json`。
`mode=share`	否	打开该本地 plugin 的分享流程。

Pets

该功能启用时，可以通过以下链接打开 pet 安装流程。

Deep link	打开的内容
`codex://pets/install?name=<pet-name>&imageUrl=<https-image-url>`	pet 安装流程。

Query 参数	必填	作用
`name=<pet-name>`	是	设置 pet 名称。值必须至少包含一个非空白字符。
`imageUrl=<https-image-url>`	是	提供 pet 图片或 sprite sheet 的 HTTPS 绝对 URL。
`description=<text>`	否	为安装流程添加描述。
`spriteVersionNumber=<1-or-2>`	否	选择 sprite sheet 格式。默认值为 `1`，唯一受支持的其他值是 `2`。

安装链接只接受这些 query 参数。名称无效、图片 URL 不是 HTTPS、不支持的 sprite version，或存在额外路径片段时，链接不会执行任何操作。

另请参阅

本站实践建议

阅读“命令”时，建议先在非生产项目中走完一次完整流程，并记录实际界面、命令输出和验证结果。产品更新后，可据此快速判断哪些步骤需要调整。

Codex API 与国内使用

在实践“命令”相关功能时，如需为 Codex 配置 OpenAI-compatible API，可以前往 APIBest 获取 API Key。第三方服务的模型映射、价格、额度和数据处理方式以 APIBest 当前说明为准。

命令 ​

键盘快捷键 ​

搜索过去的聊天并在聊天中查找 ​

Deep links ​

支持的链接 ​

聊天 ​

使用 plugin 开始聊天 ​

设置 ​

Skills ​

Scheduled ​

Plugins ​

安装 plugin ​

Plugin 详情 ​

本地 plugin ​

Pets ​

另请参阅 ​

本站实践建议 ​

Codex API 与国内使用 ​

命令