命令
如需完整文档索引，请参阅 llms.txt。文档页面的 Markdown 版本可通过在页面后追加
.md来获取 URL。
使用以下命令和键盘快捷键在应用中导航。
| 操作 | 快捷键 | |
|---|---|---|
| 通用 | ||
| 命令菜单 | 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 | |
| 打开审查标签页 | Ctrl + Shift + G | |
| 切换审查面板 | Cmd/Ctrl + Alt + B | |
| 切换底部面板 | Cmd/Ctrl + J | |
| 切换终端 | Ctrl + ` | |
| 清空终端 | Ctrl + L | |
| 聊天 | 快速聊天 | 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 |
要查找、自定义或重置快捷键，请打开 设置 > 键盘快捷键。 你可以按命令名称搜索，或将搜索字段切换到按键模式 并按下你想查找的快捷键。
搜索过去的聊天记录并在聊天中查找
Section titled “搜索过去的聊天记录并在聊天中查找”使用聊天搜索（Cmd/Ctrl + G）重新打开过去的
聊天。当扩展匹配可用时，它还可以匹配聊天内容和
Git 分支名称，因此你可以搜索聊天中的短语或
类似这样的分支 fix/login-redirect。
在打开 在聊天中查找 （Cmd/Ctrl + F）聊天后使用 来在其中查找文本。它不会跨其他聊天搜索。
对于以 / 开头的操作，请参阅 斜杠命令。
该 ChatGPT 桌面应用会保留 codex:// URL 方案以保持兼容性，因此
链接可以直接打开应用的特定部分。请先对查询字符串值进行编码
再将它们添加到 URL。
创建链接时请使用以下规范形式。下面各部分按链接类型列出完整参考。
| 深度链接 | 打开 |
|---|---|
codex://threads/new |
新的本地聊天。 |
codex://new?<query> |
带有至少一个查询参数的新的本地聊天。 |
codex://threads/<thread-id> |
本地聊天。 <thread-id> 是其技术线程 ID。 |
codex://settings |
设置。 |
codex://settings/connections/<connection-type> |
计算机、设备或 SSH 连接设置。 |
codex://settings/connections/ssh/add?name=<ssh-config-host> |
从你的 SSH 配置添加主机到 Codex。 |
codex://skills |
技能。 |
codex://automations |
打开创建流程的定时任务。 |
codex://plugins/install/<plugin-name>?marketplace=<marketplace-name> |
来自已知市场的插件安装流程。 |
codex://plugins/<plugin-id> |
插件详情页。 |
codex://plugins/<plugin-name>?marketplacePath=<absolute-marketplace-path> |
来自本地市场的本地插件详情页。 |
codex://pets/install?name=<pet-name>&imageUrl=<https-image-url> |
宠物安装流程。 |
需要打开现有本地聊天或开始新聊天时，请使用这些链接。
| 深度链接 | 打开 |
|---|---|
codex://threads/<thread-id> |
本地聊天。 <thread-id> 是其技术线程 ID。 |
codex://threads/new |
新的本地聊天。 |
codex://threads/new?<query> |
带有可选查询参数的新的本地聊天。 |
codex://new?<query> |
新的本地聊天。至少包含 prompt、 path或 originUrl之一；否则链接不会执行任何操作。 |
对于 codex://threads/new 或 codex://new，请根据需要添加以下查询参数；可以在同一个 URL 中组合使用这些参数。
| 查询参数 | 必需 | 作用 |
|---|---|---|
prompt=<text> |
否 | 设置初始编辑器文本。 |
path=<absolute-path> |
否 | 在本地工作区中打开新聊天。 path 必须是指向本地目录的绝对路径。有效时， Codex 会将该目录用作活动工作区。 |
originUrl=<git-remote-url> |
否 | 按 Git 远程 URL匹配你当前工作区根目录之一。如果 path 也存在， Codex 会先解析 path 。 |
示例： 给我展示一些关于我如何使用的有趣统计数据 Codex
使用插件开始聊天
Section titled “使用插件开始聊天”为帮助用户启动由插件支持的聊天，请在 编码前的提示词中包含一个插件提及：
[@Example](plugin://example@openai-curated) Summarize this document: https://example.com/document/123将完整提示词编码为 URI 组件，例如在
encodeURIComponent 中使用 JavaScript，并将其传递给 prompt 参数：
codex://new?prompt=%5B%40Example%5D(plugin%3A%2F%2Fexample%40openai-curated)%20Summarize%20this%20document%3A%20https%3A%2F%2Fexample.com%2Fdocument%2F123该链接会打开一个新聊天，并在编辑器中填入解码后的提示词。它不会 自动发送提示词。用户发送后， Codex 可以在该聊天中使用 已安装的插件。如果插件未安装但对 用户可用， Codex 会要求用户安装它并连接任何必需的连接器。 设置完成后，用户可以选择 继续 来恢复同一聊天。工作区 设置可以限制用户能够安装哪些插件。有关插件安装 和权限详情，请参阅 插件。
需要打开设置或特定设置页面时，请使用这些链接。
| 深度链接 | 打开 |
|---|---|
codex://settings |
设置。 |
codex://settings/browser-use |
浏览器设置。 |
codex://settings/computer-use/google-chrome |
用于计算机使用的 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-managed 连接，然后打开 SSH 连接设置。 |
该 name 值必须匹配 ~/.ssh/config中的主机别名。该链接会禁用
已添加主机的自动连接。如果 Codex 找不到指定主机，它会
打开 SSH 连接设置并显示错误。
不受支持的 codex://settings/... 路径会打开主设置页面。
需要打开技能时，请使用这些链接。
| 深度链接 | 打开 |
|---|---|
codex://skills |
技能。 |
Scheduled
Section titled “Scheduled”需要打开 Scheduled 时，请使用这些链接。
| 深度链接 | 打开 |
|---|---|
codex://automations |
打开创建流程的定时任务。 |
插件链接的形式取决于你是从 marketplace 安装插件、打开插件，还是使用本地 marketplace.json。有关插件基础知识，请参阅 插件。有关本地或仓库 marketplace 设置，请参阅 构建插件。
使用此形式可打开 Codex 已知 marketplace 中插件的安装流程。
| 深度链接 | 打开 |
|---|---|
codex://plugins/install/<plugin-name>?marketplace=<marketplace-name> |
插件详情或插件安装流程。 |
| 查询参数 | 必需 | 作用 |
|---|---|---|
marketplace=<marketplace-name> |
是 | 标识市场。对于由 OpenAI策划的插件，请使用 openai-curated。 |
安装链接只接受 marketplace 查询参数。如果 Codex 找不到请求的 marketplace 或插件，则会打开插件页面。
| 深度链接 | 打开 |
|---|---|
codex://plugins/<plugin-id> |
插件详情页。 |
<plugin-id> 必须标识该插件。对于 OpenAI 策划的插件，请使用 <plugin-name>@openai-curated 形式。
Codex-generated 插件链接也可以包含这些查询参数。手动编写链接时请同时省略两者。
| 查询参数 | 必需 | 作用 |
|---|---|---|
hostId=<host-id> |
否 | 标识 Codex 拥有插件上下文的主机，例如 local 或你配置的远程连接之一。 Codex 会提供这些 IDs。 |
source=manage |
否 | 保留应用的插件管理入口点。它不只限管理员使用。 |
有关本地或仓库 marketplace 设置，请参阅 构建插件。
| 深度链接 | 打开 |
|---|---|
codex://plugins/<plugin-name>?marketplacePath=<absolute-marketplace-path> |
来自本地市场的本地插件详情页。 |
| 查询参数 | 必需 | 作用 |
|---|---|---|
marketplacePath=<absolute-marketplace-path> |
是 | 指向本地 marketplace.json的绝对路径，例如 /Users/alex/.agents/plugins/marketplace.json。 |
mode=share |
否 | 打开该本地插件的分享流程。 |
当该功能启用时，请使用这些链接打开宠物安装流程。
| 深度链接 | 打开 |
|---|---|
codex://pets/install?name=<pet-name>&imageUrl=<https-image-url> |
宠物安装流程。 |
| 查询参数 | 必需 | 作用 |
|---|---|---|
name=<pet-name> |
是 | 设置宠物名称。该值必须包含至少一个非空白字符。 |
imageUrl=<https-image-url> |
是 | 提供用于宠物图像或精灵图表的绝对 HTTPS URL 。 |
description=<text> |
否 | 向安装流程添加描述。 |
spriteVersionNumber=<1-or-2> |
否 | 选择精灵图表格式。默认值为 1；唯一其他受支持的值是 2。 |
安装链接只接受这些查询参数。无效名称、非HTTPS 图像 URLs、不受支持的精灵版本或额外路径段都会导致链接 不执行任何操作。