コマンド
ChatGPT デスクトップアプリのコマンドとキーボードショートカットのリファレンス
次のコマンドとキーボードショートカットを使用して、アプリ内を移動できます。
キーボードショートカット
| 操作 | ショートカット | |
|---|---|---|
| 一般 | ||
| コマンドメニュー | 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 |
ショートカットを検索、カスタマイズ、リセットするには、設定 > キーボードショートカット を開きます。コマンド名で検索することも、検索フィールドをキー入力モードに切り替えて、検索するショートカットを押すこともできます。
過去のチャットを検索し、チャット内を検索する
チャット検索(Cmd/Ctrl + G)を使用すると、過去のチャットを再び開けます。拡張一致を利用できる場合は、チャットの内容と
Git ブランチ名も検索対象になるため、チャット内の語句や
fix/login-redirect などのブランチを検索できます。
チャットを開いた後に チャット内を検索(Cmd/Ctrl + F)を使用すると、チャット内のテキストを検索できます。ほかのチャットは検索されません。
/ で始まる操作については、スラッシュコマンドを参照してください。
ディープリンク
ChatGPT デスクトップアプリは互換性のために codex:// URL スキームを維持しており、リンクからアプリの特定部分を直接開くことができます。クエリ文字列の値は、URL に追加する前にエンコードしてください。
対応しているリンク
リンクを作成するときは、次の canonical 形式を使用します。以降のセクションでは、リンクの種類ごとに完全なリファレンスを示します。
| ディープリンク | 開く対象 |
|---|---|
codex://threads/new |
新しいローカルチャット。 |
codex://new?<query> |
1 つ以上のクエリパラメーターを指定した新しいローカルチャット。 |
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 config のホストを 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 のうち 1 つ以上を含めてください。それ以外の場合、リンクは何も実行しません。 |
codex://threads/new または codex://new には、必要に応じて次のクエリパラメーターを追加できます。同じ URL 内で組み合わせることもできます。
| クエリパラメーター | 必須 | 動作 |
|---|---|---|
prompt=<text> |
いいえ | 入力欄の初期テキストを設定します。 |
path=<absolute-path> |
いいえ | ローカルワークスペースで新しいチャットを開きます。path はローカルディレクトリへの絶対パスである必要があります。有効な場合、Codex はそのディレクトリをアクティブなワークスペースとして使用します。 |
originUrl=<git-remote-url> |
いいえ | Git リモート URL に基づいて、現在のワークスペースルートのいずれかと照合します。path も指定されている場合、Codex は最初に path を解決します。 |
プラグインを使用してチャットを開始する
ユーザーがプラグインを利用するチャットを開始できるようにするには、エンコードする前にプロンプトへプラグインメンションを含めます。
[@Example](plugin://example@openai-curated) Summarize this document: https://example.com/document/123プロンプト全体を URI コンポーネントとしてエンコードします。たとえば 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 はそのチャットでインストール済みのプラグインを使用できます。プラグインがインストールされていなくてもユーザーが利用できる場合、 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 管理の接続として追加し、SSH 接続設定を開きます。 |
name の値は、~/.ssh/config 内のホストエイリアスと一致する必要があります。このリンクでは、追加したホストへの自動接続が無効になります。Codex が指定されたホストを見つけられない場合は、
SSH 接続設定が開き、エラーが表示されます。
対応していない codex://settings/... パスを開くと、設定のメインページが表示されます。
スキル
スキルを開く場合は、次のリンクを使用します。
| ディープリンク | 開く対象 |
|---|---|
codex://skills |
スキル。 |
スケジュール
スケジュール を開く場合は、次のリンクを使用します。
| ディープリンク | 開く対象 |
|---|---|
codex://automations |
作成フローを開いた状態のスケジュール。 |
プラグイン
プラグインのリンクは、マーケットプレイスからインストールする場合、プラグインを開く場合、ローカルの marketplace.json を使用する場合で形式が異なります。プラグインの基本については、プラグインを参照してください。ローカルまたはリポジトリのマーケットプレイス設定については、プラグインを構築するを参照してください。
プラグインのインストール
Codex がすでに認識しているマーケットプレイスからプラグインをインストールするフローを開くには、次の形式を使用します。
| ディープリンク | 開く対象 |
|---|---|
codex://plugins/install/<plugin-name>?marketplace=<marketplace-name> |
プラグインの詳細またはインストールフロー。 |
| クエリパラメーター | 必須 | 動作 |
|---|---|---|
marketplace=<marketplace-name> |
はい | マーケットプレイスを識別します。OpenAI が管理するプラグインには openai-curated を使用します。 |
インストールリンクで使用できるクエリパラメーターは marketplace のみです。Codex が指定されたマーケットプレイスまたはプラグインを見つけられない場合は、代わりにプラグインページが開きます。
プラグインの詳細
| ディープリンク | 開く対象 |
|---|---|
codex://plugins/<plugin-id> |
プラグインの詳細ページ。 |
<plugin-id> にはプラグインを識別する値を指定する必要があります。OpenAI が管理するプラグインには、<plugin-name>@openai-curated の形式を使用します。
Codex が生成するプラグインリンクには、次のクエリパラメーターが含まれる場合もあります。リンクを手動で作成するときは、どちらも省略してください。
| クエリパラメーター | 必須 | 動作 |
|---|---|---|
hostId=<host-id> |
いいえ | local や設定済みのリモート接続など、プラグインのコンテキストを所有する Codex ホストを識別します。これらの ID は Codex が提供します。 |
source=manage |
いいえ | アプリのプラグイン管理エントリーポイントを維持します。管理者専用ではありません。 |
ローカルプラグイン
ローカルまたはリポジトリのマーケットプレイス設定については、プラグインを構築するを参照してください。
| ディープリンク | 開く対象 |
|---|---|
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> |
はい | ペット名を設定します。値には、空白以外の文字が 1 文字以上含まれている必要があります。 |
imageUrl=<https-image-url> |
はい | ペットの画像またはスプライトシートの絶対 HTTPS URL を指定します。 |
description=<text> |
いいえ | インストールフローに説明を追加します。 |
spriteVersionNumber=<1-or-2> |
いいえ | スプライトシートの形式を選択します。デフォルトは 1 で、ほかに対応している値は 2 のみです。 |
インストールリンクで使用できるのは、これらのクエリパラメーターのみです。無効な名前、HTTPS 以外の画像 URL、対応していないスプライトバージョン、余分なパスセグメントがある場合、リンクは何も実行しません。