命令
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。 |
使用 plugin 開始聊天
如果希望幫助使用者發起由 plugin 支援的聊天，請先把 plugin mention 放進提示詞，再對完整提示詞進行編碼：
[@Example](plugin://example@openai-curated) Summarize this document: https://example.com/document/123把完整提示詞編碼為 URI component，例如在 JavaScript 中使用 encodeURIComponent，然後將它傳給 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 即可在該聊天中使用已安裝的 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，或存在額外路徑片段時，連結不會執行任何操作。