命令
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/Ctrl + Alt + N |
| 任务 | 新建任务 | 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 task（在任务中查找）（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。 |
设置
需要打开 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，或存在额外路径片段时，链接不会执行任何操作。