コマンド¶

アプリを操作するには、以下のコマンドとキーボードショートカットを使用します。

キーボードショートカット¶

	操作	ショートカット
一般
	コマンドメニュー	`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 に追加する前に、クエリ文字列の値をエンコードしてください。

サポートされているリンク¶

リンクを作成するときは、以下の正規形式を使用してください。以下のセクションでは、リンクの種類ごとに完全なリファレンスを示します。

ディープリンク	開く対象
`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 設定からホストを 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` を解決します。

例: Codex の使用状況に関する楽しい統計を見せて

プラグインを使用してチャットを開始する¶

ユーザーがプラグインを使用したチャットを開始できるようにするには、エンコードする前にプロンプトにプラグインメンションを含めます。

[@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>`	いいえ	プラグインコンテキストを所有する Codex ホストを識別します。たとえば `local` や、設定済みのリモート接続のいずれかです。これらの ID は Codex が提供します。
`source=manage`	いいえ	アプリのプラグイン管理エントリーポイントを保持します。管理者専用ではありません。

例: OpenAI Developers プラグインを開く

ローカルプラグイン¶

ローカルまたはリポジトリのマーケットプレイスのセットアップについては、プラグインをビルドするを参照してください。

ディープリンク	開く対象
`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、サポートされていないスプライトバージョン、または余分なパスセグメントがある場合、リンクは何も実行しません。