コマンド
コマンド
ChatGPT デスクトップアプリのコマンドとキーボードショートカットのリファレンス
次のコマンドとキーボードショートカットを使用して、アプリ内を移動できます。
キーボードショートカット
デフォルトのショートカットを表示するプラットフォームを選択してください。一部のショートカットは、対応する機能またはビューが利用できる場合にのみ表示されます。
macOS
| 一般 | ショートカット |
|---|---|
| コマンドメニューを開く | ⌘+⇧+P または ⌘+K |
| 設定を開く | ⌘+, |
| キーボードショートカットを開く | ⌘+/ |
| フォルダーを開く(Codex と Work のみ) | ⌘+O |
| 戻る | ⌘+[ または マウスの戻るボタン |
| 進む | ⌘+] または マウスの進むボタン |
| フォントサイズを大きくする | ⌘++ または ⌘+Numpad + |
| フォントサイズを小さくする | ⌘+- または ⌘+Numpad − |
| フォントサイズをリセット | ⌘+0 または ⌘+Numpad 0 |
| サイドバーの表示を切り替える | ⌘+B または ⌘+⇧+S |
| 下部パネルの表示を切り替える(Codex のみ) | ⌘+J |
| ターミナルの表示を切り替える(Codex のみ) | ⌃+` |
| ターミナルをクリア(ターミナルにフォーカスがある場合) | ⌃+L または ⌘+K |
| すべての未読表示をクリア(Codex のみ) | ⇧+Esc |
| アプリでの直前の操作を元に戻す | ⌘+Z |
| アプリでの直前の操作をやり直す | ⌘+⇧+Z |
| 現在のタブまたはウィンドウを閉じる | ⌘+W |
| 閉じたタブを再度開く | ⌘+⇧+T |
| ほかのタブを閉じる | ⌘+⌥+W |
| 全画面表示を切り替える | ⌘+⌃+F |
| アプリを終了 | ⌘+Q |
| チャット | ショートカット |
|---|---|
| 新しいチャット | ⌘+N または ⌘+⇧+O |
| 新しい独立したチャット(Codex のみ) | ⌘+⌥+O |
| クイックチャット(ChatGPT のみ) | ⌘+⌥+N |
| 新しい一時チャット(ChatGPT のみ) | ⌘+⇧+N |
| チャットをアーカイブする | ⌘+⇧+A |
| チャットを未読にする | ⌘+⇧+U |
| チャットをピン留めまたはピン留め解除する | ⌘+⌥+P |
| チャットの名前を変更する | ⌘+⌥+R |
| サイドチャットを開く(Codex のみ) | ⌘+⌥+S |
| チャットを検索する(Settings > Keyboard Shortcuts で割り当てます) | デフォルトでは未割り当て |
| チャット内を検索する | ⌘+F |
| 次の一致項目を検索する | ⌘+G |
| 前の一致項目を検索する | ⌘+⇧+G |
| 前のチャットまたはタブ | ⌃+⇧+Tab または ⌘+⇧+[ または ⌘+⌥+← |
| 次のチャットまたはタブ | ⌃+Tab または ⌘+⇧+] または ⌘+⌥+→ |
| 次の確認が必要なチャット(Codex のみ) | ⌘+⌥+A |
| 最近のチャット 1~6 を開く | ⌘+⌥+1–6 |
| チャット 1~9 に移動する | ⌘+1–9 |
| 入力とモード | ショートカット |
|---|---|
| モデル選択を開く | ⌃+⇧+M |
| 最近使用したモデルを開く | ⌃+⌘+M |
| プロジェクト選択を開く | ⌘+⌥+⇧+O |
| 音声チャットを開始(音声チャットが利用可能な場合) | ⌃+⇧+V |
| 入力欄の前のプロンプトを復元(入力欄が空の場合) | ↑ |
| リクエストを承認(承認リクエストが開いている場合) | ⏎ |
| リクエストを拒否(承認リクエストが開いている場合) | Esc |
| Chat、Work、Codex に切り替える(表示順) | ⌃+1 または ⌃+2 または ⌃+3 |
| アクティビティビューの表示を切り替える(アクティビティが利用可能な場合) | ⌘+⌥+U |
| ワークスペースとブラウザー | ショートカット |
|---|---|
| 環境アクション 1 を実行(環境にプライマリアクションが定義されている場合) | ⌘+⇧+D |
| ファイルを検索(Codex のみ) | ⌘+P |
| ファイルツリーの表示を切り替える(Codex のみ) | ⌘+⇧+E |
| レビュータブを開く(Codex のみ) | ⌃+⇧+G |
| チャットとタブを切り替える(全体表示時。分割表示時はタブの表示と非表示を切り替え) | ⌘+⌥+B |
| ブラウザータブを開く(内蔵ブラウザーが利用可能な場合) | ⌘+T |
| ワークスペースのレイアウトを順に切り替える(全体表示、分割表示、タブ非表示) | ⌘+⇧+B |
| 全体表示に切り替える、または解除する | ⌘+⇧+F |
| 指定行に移動、またはブラウザーのアドレスバーにフォーカス(フォーカス中のビューによって異なります) | ⌘+L |
| ブラウザーで戻る(内蔵ブラウザーにフォーカスがある場合) | ⌘+← |
| ブラウザーで進む(内蔵ブラウザーにフォーカスがある場合) | ⌘+→ |
| ブラウザーのページを再読み込み(内蔵ブラウザーにフォーカスがある場合) | ⌘+R |
| キャッシュを使わずにブラウザーのページを再読み込み(内蔵ブラウザーにフォーカスがある場合) | ⌘+⇧+R |
| ブラウザーの URL をコピー(内蔵ブラウザーにフォーカスがある場合) | ⌘+⇧+C |
| ブラウザーの閲覧モードとコメントモードを切り替える(ブラウザーでのコメントが利用可能な場合) | ⌘+⇧+. |
| 会話のパスをコピー(Codex のみ) | ⌘+⌥+⇧+C |
| チャットのディープリンクをコピー | ⌘+⌥+L |
| 作業ディレクトリをコピー(Codex のみ) | ⌘+⇧+C |
| Appshot を撮影(両方のキーを同時に押す) | ⌘+⌘ |
Windows
| 一般 | ショートカット |
|---|---|
| コマンドメニューを開く | Ctrl+Shift+P または Ctrl+K |
| 設定を開く | Ctrl+, |
| キーボードショートカットを開く | Ctrl+/ |
| フォルダーを開く(Codex と Work のみ) | Ctrl+O |
| 戻る | Ctrl+[ または マウスの戻るボタン |
| 進む | Ctrl+] または マウスの進むボタン |
| フォントサイズを大きくする | Ctrl++ または Ctrl+= または Ctrl+Numpad + |
| フォントサイズを小さくする | Ctrl+- または Ctrl+Numpad − |
| フォントサイズをリセット | Ctrl+0 または Ctrl+Numpad 0 |
| サイドバーの表示を切り替える | Ctrl+B または Ctrl+Shift+S |
| 下部パネルの表示を切り替える(Codex のみ) | Ctrl+J |
| ターミナルの表示を切り替える(Codex のみ) | Ctrl+` |
| ターミナルをクリア(ターミナルにフォーカスがある場合) | Ctrl+L または Ctrl+K |
| すべての未読表示をクリア(Codex のみ) | Shift+Esc |
| アプリでの直前の操作を元に戻す | Ctrl+Z |
| アプリでの直前の操作をやり直す | Ctrl+Y または Ctrl+Shift+Z |
| 現在のタブまたはウィンドウを閉じる | Ctrl+W または Ctrl+F4 |
| 閉じたタブを再度開く | Ctrl+Shift+T |
| ほかのタブを閉じる | Ctrl+Alt+W |
| 全画面表示を切り替える | F11 |
| アプリを終了 | Ctrl+Q |
| チャット | ショートカット |
|---|---|
| 新しいチャット | Ctrl+N または Ctrl+Shift+O |
| 新しい独立したチャット(Codex のみ) | Ctrl+Alt+O |
| クイックチャット(ChatGPT のみ) | Ctrl+Alt+N |
| 新しい一時チャット(ChatGPT のみ) | Ctrl+Shift+N |
| チャットをアーカイブ | Ctrl+Shift+A |
| チャットを未読にする | Ctrl+Shift+U |
| チャットをピン留めまたは解除 | Ctrl+Alt+P |
| チャットの名前を変更 | Ctrl+Alt+R |
| サイドチャットを開く(Codex のみ) | Ctrl+Alt+S |
| チャットを検索(設定 > キーボードショートカットで割り当て) | デフォルトでは未割り当て |
| チャット内を検索 | Ctrl+F |
| 次の一致箇所を検索 | Ctrl+G |
| 前の一致箇所を検索 | Shift+F3 |
| 前のチャットまたはタブ | Ctrl+Shift+Tab または Ctrl+Shift+[ または Ctrl+Page Up |
| 次のチャットまたはタブ | Ctrl+Tab または Ctrl+Shift+] または Ctrl+Page Down |
| 対応が必要な次のチャット(Codex のみ) | Ctrl+Alt+A |
| 最近のチャット 1~6 を開く | Ctrl+Alt+1–6 |
| チャット 1~9 に移動 | Ctrl+1–9 |
| 入力とモード | ショートカット |
|---|---|
| モデル選択を開く | Ctrl+Shift+M |
| 最近使用したモデルを開く | Alt+M |
| プロジェクト選択を開く | Ctrl+Alt+Shift+O |
| 前のプロンプトを入力欄に復元する(入力欄が空の場合) | ↑ |
| リクエストを承認する(承認リクエストが表示されている場合) | ⏎ |
| リクエストを拒否する(承認リクエストが表示されている場合) | Esc |
| Chat、Work、Codex に切り替える(記載順) | Alt+1 または Alt+2 または Alt+3 |
| アクティビティビューを切り替える(アクティビティが利用可能な場合) | Ctrl+Alt+U |
| ワークスペースとブラウザー | ショートカット |
|---|---|
| 環境アクション 1 を実行する(環境にプライマリアクションが定義されている場合) | Win+Shift+D |
| ファイルを検索する(Codex のみ) | Ctrl+P |
| ファイルツリーの表示を切り替える(Codex のみ) | Ctrl+Shift+E |
| レビュータブを開く(Codex のみ) | Ctrl+Shift+G |
| チャットとタブを切り替える(全体表示の場合。分割表示ではタブの表示と非表示を切り替える) | Ctrl+Alt+B |
| ブラウザータブを開く(内蔵ブラウザーが利用可能な場合) | Ctrl+T |
| ワークスペースのレイアウトを順に切り替える(全体表示、分割表示、タブ非表示) | Ctrl+Shift+B |
| 全体表示に切り替える、または解除する | Ctrl+Shift+F |
| 指定行に移動する、またはブラウザーのアドレスバーにフォーカスする(フォーカス中のビューによって異なる) | Ctrl+L |
| ブラウザーで戻る(内蔵ブラウザーにフォーカスがある場合) | Alt+← |
| ブラウザーで進む(内蔵ブラウザーにフォーカスがある場合) | Alt+→ |
| ブラウザーのページを再読み込みする(内蔵ブラウザーにフォーカスがある場合) | Ctrl+R |
| キャッシュを使わずにブラウザーのページを再読み込みする(内蔵ブラウザーにフォーカスがある場合) | Ctrl+Shift+R |
| ブラウザーの URL をコピーする(内蔵ブラウザーにフォーカスがある場合) | Ctrl+Shift+C |
| ブラウザーの閲覧モードとコメントモードを切り替える(ブラウザーのコメント機能が利用可能な場合) | Ctrl+Shift+. |
| 会話のパスをコピーする(Codex のみ) | Ctrl+Alt+Shift+C |
| チャットのディープリンクをコピーする | Ctrl+Alt+L |
| 作業ディレクトリをコピーする(Codex のみ) | Ctrl+Shift+C |
Linux
| 一般 | ショートカット |
|---|---|
| コマンドメニューを開く | Ctrl+Shift+P または Ctrl+K |
| 設定を開く | Ctrl+, |
| キーボードショートカットを開く | Ctrl+/ |
| フォルダーを開く(Codex と Work のみ) | Ctrl+O |
| 戻る | Ctrl+[ または Mouse Back |
| 進む | Ctrl+] または Mouse Forward |
| フォントサイズを大きくする | Ctrl++ または Ctrl+= または Ctrl+Numpad + |
| フォントサイズを小さくする | Ctrl+- または Ctrl+Numpad − |
| フォントサイズをリセットする | Ctrl+0 または Ctrl+Numpad 0 |
| サイドバーの表示を切り替える | Ctrl+B または Ctrl+Shift+S |
| 下部パネルの表示を切り替える(Codex のみ) | Ctrl+J |
| ターミナルの表示を切り替える(Codex のみ) | Ctrl+` |
| ターミナルをクリアする(ターミナルにフォーカスがある場合) | Ctrl+L または Ctrl+K |
| 未読マークをすべてクリアする(Codex のみ) | Shift+Esc |
| アプリの直前の操作を取り消す | Ctrl+Z |
| アプリの直前の操作をやり直す | Ctrl+Y または Ctrl+Shift+Z |
| 現在のタブまたはウィンドウを閉じる | Ctrl+W または Ctrl+F4 |
| 閉じたタブを再度開く | Ctrl+Shift+T |
| ほかのタブを閉じる | Ctrl+Alt+W |
| 全画面表示を切り替える | F11 |
| アプリを終了する | Ctrl+Q |
| チャット | ショートカット |
|---|---|
| 新しいチャット | Ctrl+N または Ctrl+Shift+O |
| 新しい独立したチャット(Codex のみ) | Ctrl+Alt+O |
| クイックチャット(ChatGPT のみ) | Ctrl+Alt+N |
| 新しい一時チャット(ChatGPT のみ) | Ctrl+Shift+N |
| チャットをアーカイブ | Ctrl+Shift+A |
| チャットを未読にする | Ctrl+Shift+U |
| チャットをピン留めまたは解除 | Ctrl+Alt+P |
| チャットの名前を変更 | Ctrl+Alt+R |
| サイドチャットを開く(Codex のみ) | Ctrl+Alt+S |
| チャットを検索(設定 > キーボードショートカットで割り当て) | デフォルトでは未割り当て |
| チャット内を検索 | Ctrl+F |
| 次の一致箇所を検索 | Ctrl+G |
| 前の一致箇所を検索 | Shift+F3 |
| 前のチャットまたはタブ | Ctrl+Shift+Tab または Ctrl+Shift+[ または Ctrl+Page Up |
| 次のチャットまたはタブ | Ctrl+Tab または Ctrl+Shift+] または Ctrl+Page Down |
| 対応が必要な次のチャット(Codex のみ) | Ctrl+Alt+A |
| 最近のチャット 1~6 を開く | Ctrl+Alt+1–6 |
| チャット 1~9 に移動 | Ctrl+1–9 |
| 入力とモード | ショートカット |
|---|---|
| モデル選択を開く | Ctrl+Shift+M |
| 最近使用したモデルを開く | Alt+M |
| プロジェクト選択を開く | Ctrl+Alt+Shift+O |
| 前のプロンプトを入力欄に復元する(入力欄が空の場合) | ↑ |
| リクエストを承認する(承認リクエストが表示されている場合) | ⏎ |
| リクエストを拒否する(承認リクエストが表示されている場合) | Esc |
| Chat、Work、Codex に切り替える(記載順) | Alt+1 または Alt+2 または Alt+3 |
| アクティビティビューを切り替える(アクティビティが利用可能な場合) | Ctrl+Alt+U |
| ワークスペースとブラウザー | ショートカット |
|---|---|
| 環境アクション 1 を実行する(環境にプライマリアクションが定義されている場合) | Super+Shift+D |
| ファイルを検索する(Codex のみ) | Ctrl+P |
| ファイルツリーの表示を切り替える(Codex のみ) | Ctrl+Shift+E |
| レビュータブを開く(Codex のみ) | Ctrl+Shift+G |
| チャットとタブを切り替える(全体表示の場合。分割表示ではタブの表示と非表示を切り替える) | Ctrl+Alt+B |
| ブラウザータブを開く(内蔵ブラウザーが利用可能な場合) | Ctrl+T |
| ワークスペースのレイアウトを順に切り替える(全体表示、分割表示、タブ非表示) | Ctrl+Shift+B |
| 全体表示に切り替える、または解除する | Ctrl+Shift+F |
| 指定行に移動する、またはブラウザーのアドレスバーにフォーカスする(フォーカス中のビューによって異なる) | Ctrl+L |
| ブラウザーで戻る(内蔵ブラウザーにフォーカスがある場合) | Alt+← |
| ブラウザーで進む(内蔵ブラウザーにフォーカスがある場合) | Alt+→ |
| ブラウザーのページを再読み込みする(内蔵ブラウザーにフォーカスがある場合) | Ctrl+R |
| キャッシュを使わずにブラウザーのページを再読み込みする(内蔵ブラウザーにフォーカスがある場合) | Ctrl+Shift+R |
| ブラウザーの URL をコピーする(内蔵ブラウザーにフォーカスがある場合) | Ctrl+Shift+C |
| ブラウザーの閲覧モードとコメントモードを切り替える(ブラウザーのコメント機能が利用可能な場合) | Ctrl+Shift+. |
| 会話のパスをコピーする(Codex のみ) | Ctrl+Alt+Shift+C |
| チャットのディープリンクをコピーする | Ctrl+Alt+L |
| 作業ディレクトリをコピーする(Codex のみ) | Ctrl+Shift+C |
アプリのショートカットを検索、カスタマイズ、またはリセットするには、Settings > Keyboard Shortcuts を開きます。
コマンド名で検索するか、検索フィールドをキーストロークモードに切り替えて、 検索したいショートカットを押します。Appshots では、Settings > Appshots にある別のグローバルショートカットを使用します。
Linux では、試験的なネイティブ Wayland によってショートカットのサポートに影響が生じる場合があります。詳しくは、 Linux デスクトップアプリガイドをご覧ください。
過去のチャットを検索し、チャット内を検索する
過去のチャットを再度開くには、Search chats を使用します。チャット検索にはデフォルトのショートカットがありません。Settings > Keyboard Shortcuts で割り当てられます。
拡張マッチングが利用可能な場合、検索ではチャットの内容や Git
ブランチ名も照合できるため、チャット内の語句や
fix/login-redirect のようなブランチを検索できます。
チャットを開いた後、その中のテキストを検索するには Find in chat を使用します。他のチャットを横断して検索することはできません。
/ で始まる操作については、スラッシュコマンドを参照してください。
ディープリンク
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、対応していないスプライトバージョン、余分なパスセグメントがある場合、リンクは何も実行しません。