命令

命令

OpenAI ChatGPT 与 Codex App 命令中文参考,覆盖键盘快捷键、任务搜索、Slash commands,以及 codex:// 任务、设置、Skills、Scheduled、Plugins 和 Pets deep links 的路由、参数与示例。

命令#

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
打开评审 tabCtrl + Shift + G
切换评审面板Cmd/Ctrl + Alt + B
切换底部面板Cmd/Ctrl + J
切换终端Ctrl + `
清空终端Ctrl + L
ChatQuick chatCmd + 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

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

支持的链接#

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

Deep link打开的内容
codex://threads/new新本地聊天。
codex://new?至少包含一个 query 参数的新本地聊天。
codex://threads/本地聊天; 是技术层面的 thread ID。
codex://settingsSettings。
codex://settings/connections/Computer、设备或 SSH 连接设置。
codex://settings/connections/ssh/add?name=从 SSH config 向 Codex 添加主机。
codex://skillsSkills。
codex://automationsScheduled,并打开创建流程。
codex://plugins/install/?marketplace=从已知 marketplace 安装 plugin 的流程。
codex://plugins/plugin 详情页。
codex://plugins/?marketplacePath=本地 marketplace 中的 plugin 详情页。
codex://pets/install?name=&imageUrl=pet 安装流程。

聊天#

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

Deep link打开的内容
codex://threads/本地聊天; 是技术层面的 thread ID。
codex://threads/new新本地聊天。
codex://threads/new?带可选 query 参数的新本地聊天。
codex://new?新本地聊天。必须至少包含 promptpathoriginUrl 之一,否则链接不会执行任何操作。

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

Query 参数必填作用
prompt=设置输入框中的初始文本。
path=在本地工作区中打开新聊天。path 必须是本地目录的绝对路径;有效时 Codex 会把该目录用作当前工作区。
originUrl=按 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://settingsSettings。
codex://settings/browser-useBrowser 设置。
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/sshSSH 连接设置。
codex://settings/connections/ssh/add?name=把指定主机别名添加为 Codex 管理的连接,再打开 SSH 连接设置。

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

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

Skills#

需要打开 Skills 时使用:

Deep link打开的内容
codex://skillsSkills。

Scheduled#

需要打开 Scheduled 时使用:

Deep link打开的内容
codex://automationsScheduled,并打开创建流程。

Plugins#

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

安装 plugin#

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

Deep link打开的内容
codex://plugins/install/?marketplace=plugin 详情页或安装流程。
Query 参数必填作用
marketplace=标识 marketplace。OpenAI 精选 plugin 使用 openai-curated

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

Plugin 详情#

Deep link打开的内容
codex://plugins/plugin 详情页。

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

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

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

示例:打开 OpenAI Developers plugin

本地 plugin#

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

Deep link打开的内容
codex://plugins/?marketplacePath=本地 marketplace 中的 plugin 详情页。
Query 参数必填作用
marketplacePath=本地 marketplace.json 的绝对路径,例如 /Users/alex/.agents/plugins/marketplace.json
mode=share打开该本地 plugin 的分享流程。

Pets#

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

Deep link打开的内容
codex://pets/install?name=&imageUrl=pet 安装流程。
Query 参数必填作用
name=设置 pet 名称。值必须至少包含一个非空白字符。
imageUrl=提供 pet 图片或 sprite sheet 的 HTTPS 绝对 URL。
description=为安装流程添加描述。
spriteVersionNumber=<1-or-2>选择 sprite sheet 格式。默认值为 1,唯一受支持的其他值是 2

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

另请参阅#

本站实践建议#

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

Codex API 与国内使用#

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