開発者向けコマンド

ChatGPT のウェブ版には、入力欄専用のコマンドメニューがあります。/ を入力すると、 現在のチャットで利用可能なアクションが表示されます。ChatGPT デスクトップアプリや CLI のコマンド群は利用できません。このリファレンスに記載されている Codex のスラッシュコマンド、CLI コマンド、フラグは、 ChatGPT のウェブ版には適用されません。

ChatGPT デスクトップアプリのコマンド

一般的な コマンドページでは、アプリのナビゲーション、 チャットのショートカット、キーボードのカスタマイズ、およびチャット、設定、 スキル、スケジュールされたタスク、プラグイン、ペットへのディープリンクについて説明しています。

スラッシュコマンドページでは、/feedback、/goal、/init、 /mcp、/plan、/review、/status など、アプリのコンポーザーから利用できるコマンドについて説明しています。

このリファレンスの読み方

このページでは、文書化されているすべての Codex CLI コマンドとフラグを一覧にしています。インタラクティブな表では、キーまたは説明で検索できます。各セクションには、オプションが Stable か Experimental かが示され、リスクのある組み合わせには注意事項が記載されています。

グローバルフラグ

これらのオプションは、ベースとなる codex コマンドに適用されます。ほとんどは各コマンドにも引き継がれますが、 例外については上記の注記または該当するコマンドのヘルプを参照してください。引き継がれるフラグについては、該当するコマンドのヘルプに従ってください。たとえば、codex exec --oss ... は --oss を exec に適用します。

コマンドの概要

コマンドの詳細

codex（対話型）

サブコマンドを指定せずに codex を実行すると、インタラクティブなターミナル UI（TUI）が起動します。エージェントには、上記のグローバルフラグと画像添付を指定できます。Web 検索はデフォルトでキャッシュモードです。ライブブラウジングに切り替えるには --search を使用します。手軽にローカル作業を行うには、--sandbox workspace-write --ask-for-approval on-request を使用します。

codex app-server --listen ws://IP:PORT で起動した app server に TUI を接続するには、--remote ws://host:port または --remote wss://host:port を使用します。ローカル Unix ソケットでは、デフォルトソケットに --remote unix://、明示的なパスに --remote unix://PATH を使用します。サーバーが WebSocket 認証用のベアラートークンを要求する場合は、--remote-auth-token-env <ENV_VAR> を追加します。

codex agents

コマンドセンターを開くと、共有サーバー上のチャットを閲覧したり、 エージェントを切り替えたりできます。--remote <URL> でリモートサーバーに接続し、--cd <DIR> で 新しいリモートタスクのディレクトリを設定します。codex agents は --no-daemon に対応していません。

codex queue

既存のセッションにテキストメッセージをキュー登録します：

codex queue --thread <SESSION_ID> --message "Run the remaining checks"

--thread は UUID または完全一致するセッション名を受け付けます。複数のセッションが 同じ名前の場合は、UUID を使用してください。このコマンドは --remote と --remote-auth-token-env も受け付けます。画像の添付には対応していません。

codex app-server

Codex app server をローカルで起動します。主に開発およびデバッグ用であり、予告なく変更される場合があります。

codex app-server --listen stdio:// はデフォルトの JSONL-over-stdio 動作を維持し、codex app-server --stdio はそのトランスポートのエイリアスです。--listen ws://IP:PORT は app-server クライアント用の WebSocket トランスポートを有効にします。サーバーは ws:// リッスン URL を受け付けます。クライアントが wss:// で接続する場合は、TLS 終端またはセキュアなプロキシを使用してください。Codex のデフォルト Unix ソケットで WebSocket ハンドシェイクを受け付けるには --listen unix://、ソケットパスを選択するには --listen unix:///absolute/path.sock を使用します。クライアントバインディング用のスキーマを生成する場合は、制限付きのフィールドとメソッドを含めるために --experimental を追加します。

ローカルホストを起動する代わりに、app-server をリモート Code Mode ホストへ接続するには --code-mode-host wss://code-mode.example.com/host を追加します。この送信接続は --listen とは別のもので、app-server プロセス内のすべてのスレッドで共有されます。ws:// は localhost または SSH 転送されたホストにのみ使用してください。

codex remote-control

codex remote-control を実行すると、条件を満たす場合は管理対象のバックグラウンド サーバー経由でリモート制御を開始し、それ以外の場合はフォアグラウンドで実行します。 codex remote-control --no-daemon を使用すると、明示的にフォアグラウンドで実行できます。 codex remote-control start を使用すると、リモート制御を有効にしてローカルの app-server デーモンを 起動できます。停止するには codex remote-control stop を使用します。管理対象の リモート制御クライアントと SSH リモートワークフローはこれらのコマンドを使用しますが、 ローカルのプロトコルクライアントを構築する際に使用する codex app-server --listen の 代わりにはなりません。

デーモンの起動後、codex remote-control pair を使用して、有効期間の短い手動ペアリングコードを 生成し、表示します。任意のリモート制御コマンドに --json を追加すると、 機械可読形式で出力できます。pair の JSON レスポンスには、 pairingCode、manualPairingCode、environmentId、expiresAt が含まれます。 --no-daemon は、サブコマンドを付けない remote-control コマンドにのみ適用されます。 start、stop、pair と組み合わせないでください。

codex app

macOS または Windows で、ターミナルから ChatGPT デスクトップアプリを起動します。macOS では、 Codex が指定したワークスペースパスを開けます。Windows では、開くパスが表示されます。

codex app は、インストール済みの ChatGPT デスクトップアプリを開きます。アプリがない場合はインストーラーを起動します。macOS では Codex が指定されたワークスペースパスを開き、 Windows ではインストール後に開くパスを表示します。

codex debug app-server send-message-v2

組み込みの app-server テストクライアントを使用して、app-server の V2 スレッド／ターンフロー経由でメッセージを 1 件送信します。

このデバッグフローは experimentalApi: true で初期化し、スレッドを開始してターンを送信し、サーバー通知をストリーミングします。app-server のプロトコル動作をローカルで再現、調査するために使用します。

codex debug models

Codex が認識している未加工のモデルカタログを JSON として表示します。

リモートのモデルエンドポイントから更新せず、現在のバイナリにバンドルされたカタログだけを調べる場合は、--bundled を使用します。

codex debug prompt-input

モデルに表示される正確なプロンプト入力リストを JSON としてレンダリングします。 指示の検出、セッションコンテキスト、プロンプトの構築をデバッグするときに使用します。

codex apply

Codex クラウドチャットの最新の差分をローカルリポジトリに適用します。認証済みであり、そのチャットへのアクセス権が必要です。

Codex はパッチを適用したファイルを表示し、git apply が失敗した場合（競合など）は 0 以外で終了します。

codex review

コードレビューを非インタラクティブに実行します。レビュー対象を 1 つだけ選択するか、 カスタムレビュー指示をプロンプトとして渡します。

--uncommitted、--base、--commit、カスタムの PROMPT は互いに競合します。--title は --commit とともにのみ使用してください。

codex archive と codex unarchive

保存済みのインタラクティブセッションを、セッション ID またはセッション名でアーカイブまたは復元します。 トランスクリプトを削除せずにセッション選択画面を整理する場合に、これらのコマンドを使用します。セッション ID はセッション名より優先されます。

codex archive <SESSION>
codex unarchive <SESSION>

codex delete

保存済みのインタラクティブセッションを、セッション ID またはセッション名で完全に削除します。 アクティブなセッション一覧から非表示にするのではなく、トランスクリプトを削除する場合にのみ使用してください。

codex delete <SESSION>
codex delete <SESSION_UUID> --force

--force はセッション UUID にのみ使用してください。名前付きセッションでは引き続き確認が必要です。これにより、Codex が重複した名前や曖昧な名前を確認なしで削除することを防ぎます。

codex cloud

ターミナルから Codex クラウドチャットを操作します。デフォルトのコマンドではインタラクティブな選択画面が開きます。codex cloud exec はタスクを直接送信し、codex cloud list はスクリプト処理や簡単な確認のために最近のチャットを返します。

認証にはメイン CLI と同じ認証情報が使用されます。タスクの送信に失敗すると、Codex は 0 以外で終了します。

codex cloud list

最近のクラウドチャットを、任意のフィルタリングとページネーションを使用して一覧表示します。

プレーンテキスト出力では、タスク URL に続いてステータスの詳細が表示されます。自動化には --json を使用します。JSON ペイロードには、tasks 配列と任意の cursor 値が含まれます。各タスクには、id、url、title、status、updated_at、environment_id、environment_label、summary、is_review、attempt_total が含まれます。

codex completion

シェル補完スクリプトを生成し、適切な場所へ出力をリダイレクトします（例: codex completion zsh > "${fpath[1]}/_codex"）。

codex doctor

サポートへの問い合わせを提出する前、または Codex のインストール不良を調査するときに、ローカル診断レポートを生成します。レポートでは、インストール、 設定、認証、ランタイム、Git、ターミナル、app-server、スレッド一覧の健全性を確認します。

codex features

$CODEX_HOME/config.toml に保存されている機能フラグを管理します。enable と disable コマンドは変更を永続化するため、以後のセッションにも適用されます。 features サブコマンドは --profile を受け付けません。

codex exec

人の操作なしで完了させるスクリプト実行や CI 形式の実行には、codex exec（または短縮形の codex e）を使用します。

Codex はデフォルトで整形済みの出力を書き込みます。改行区切りの JSON イベント（状態変更ごとに 1 件）を受け取るには、--json を追加します。任意の resume サブコマンドを使用すると、非インタラクティブタスクを続行できます。現在の作業ディレクトリから最新のセッションを選択するには --last、すべてのセッションを検索するには --all を追加します。

codex exec fork <SESSION_ID> [PROMPT] を使用すると、保存済みのセッションを新しい セッションにコピーできます。セッション引数には UUID または名前を指定できます。プロンプトを指定しない場合、Codex は ターンを開始せずにフォークを作成します。プロンプトとして - を渡すと、 標準入力から読み取ります。--image を追加すると、画像を添付できます。

画像、--output-schema、 --output-last-message、または --ephemeral を使用する場合は、プロンプトが必要です。

管理対象の Git ワークツリー を作成するには、新規またはフォークした実行に --worktree を追加します。

codex exec --worktree "implement the next step"
codex exec fork <SESSION_ID> --worktree "try an alternative approach"

--worktree にはローカル実行が必要です。resume、review、 --ephemeral、または --ignore-user-config と併用しないでください。

codex execpolicy

execpolicy ルールファイルを保存する前に確認します。codex execpolicy check は 1 つ以上の --rules フラグ（例: ~/.codex/rules 配下のファイル）を受け取り、最も厳しい判定と一致したルールを示す JSON を出力します。出力を整形するには --pretty を追加します。execpolicy コマンドは現在プレビュー段階です。

codex login

ChatGPT アカウント、API key、またはアクセストークンで CLI を認証します。フラグを指定しない場合、Codex は ChatGPT OAuth フロー用のブラウザーを開きます。

認証情報が存在する場合、codex login status は 0 で終了するため、自動化スクリプトで役立ちます。

codex logout

API key と ChatGPT 認証の両方について、保存済みの認証情報を削除します。このコマンドにフラグはありません。

codex mcp

~/.codex/config.toml に保存された Model Context Protocol サーバーのエントリを管理します。

add サブコマンドは、stdio とストリーミング対応 HTTP の両方のトランスポートをサポートします。

OAuth アクション（login、logout）は、ストリーミング対応 HTTP サーバーでのみ（かつサーバーが OAuth をサポートする場合にのみ）機能します。

codex plugin

設定済みのマーケットプレイスからプラグインをインストール、一覧表示、削除します。

codex plugin add --json は pluginId、name、marketplaceName、 version、installedPath、authPolicy を表示します。codex plugin list --json は installed 配列と available 配列を表示します。エントリには pluginId、name、 marketplaceName、version、installed、enabled、source、installPolicy、 authPolicy が含まれます。また、利用可能な場合は、設定済みのマーケットプレイスソースの型と値を持つ marketplaceSource も含まれます。codex plugin remove --json は pluginId、name、marketplaceName を表示します。

codex plugin marketplace

Codex が参照してインストール元として使用できるプラグインマーケットプレイスのソースを管理します。

codex plugin marketplace add は、owner/repo や owner/repo@ref などの GitHub 短縮表記、HTTP または HTTPS の Git URL、SSH Git URL、ローカルのマーケットプレイスルートディレクトリを受け付けます。Git ref を固定するには --ref を使用し、Git ベースのマーケットプレイスリポジトリでスパースチェックアウトを使用するには --sparse PATH を繰り返し指定します。

codex plugin marketplace list は、暗黙的に検出されたデフォルトマーケットプレイスと設定済みマーケットプレイスのスナップショットを含め、対象範囲内のマーケットプレイス名とルートを表示します。

自動化しやすい出力にするには、マーケットプレイスの追加、一覧表示、アップグレード、削除コマンドに --json を追加します。マーケットプレイス追加の JSON には marketplaceName、 installedRoot、alreadyAdded が含まれます。一覧の JSON には、name、root、任意の marketplaceSource を持つ marketplaces 配列が含まれます。アップグレードの JSON には selectedMarketplaces、upgradedRoots、errors、削除の JSON には marketplaceName と installedRoot が含まれます。

codex mcp-server

codex resume

ID を指定して対話型セッションを続行するか、直近のチャットを再開します。codex resume は、--all を渡さない限り、--last の対象を現在の作業ディレクトリに限定します。モデルとサンドボックスの設定の上書きには対応していますが、--worktree には対応していません。

現在の作業ディレクトリがセッションの保存済みディレクトリと異なる場合、 Codex はどちらのディレクトリを使用するか確認します。この選択を確認なしで再利用するには、 tui.resume_cwd を "current" または "session" に設定します。明示的な --cd（-C）のオーバーライドは、tui.resume_cwd より優先されます。

codex fork

以前のインタラクティブセッションを新しいチャットにフォークします。デフォルトでは、codex fork によってセッション選択画面が開きます。代わりに最新のセッションをフォークするには --last を追加します。

現在のセッションディレクトリと保存済みセッションのディレクトリが異なる場合、codex fork は codex resume と同じ作業ディレクトリの確認と tui.resume_cwd 設定を使用します。

管理対象の Git ワークツリー にフォークするには、codex fork <SESSION_ID> --worktree を実行します。 セッション ID の明示的な指定とローカル実行が必要です。 --last やセッション選択画面には対応していません。

codex sandbox

Codex が内部で使用するものと同じポリシーの下でコマンドを実行するには、サンドボックスヘルパーを使用します。

macOS seatbelt

Linux サンドボックス

Windows

codex update

インストール済みリリースが自己更新に対応している場合、Codex CLI の更新を確認して適用します。デバッグビルドでは、代わりにリリースビルドをインストールするよう案内するメッセージが表示されます。

フラグの組み合わせと安全に使うためのヒント

• ワークスペース内にとどめられる無人のローカル作業には --sandbox workspace-write を使用し、専用のサンドボックス VM 内でない限り --dangerously-bypass-approvals-and-sandbox は避けてください。
• Codex に追加のディレクトリへの書き込みアクセスを許可する必要がある場合は、--sandbox danger-full-access を強制するのではなく、--add-dir を使用してください。
• CI で機械可読の進捗と最終的な自然言語の概要を取得するには、--json と --output-last-message を組み合わせます。

対話操作のショートカット

• @ を入力すると、ワークスペース内のファイルを検索し、そのパスをプロンプトに追加できます。
• Up または Down を押すと、履歴から下書きを復元できます。
• Ctrl+R を押すと、プロンプトの履歴を検索できます。その後、Enter を押すと一致した項目を使用でき、Escape を押すとキャンセルできます。
• Ctrl+O を押すか、/copy を実行すると、直近の完了した Codex の出力をコピーできます。
• 行の先頭に ! を付けると、現在の承認設定とサンドボックス設定でローカルのシェルコマンドを実行できます。
• Codex の作業中に Tab を押すと、追加のプロンプト、スラッシュコマンド、シェルコマンドを次のターンのキューに追加できます。
• Codex の作業中に Enter を押すと、現在のターンに新しい指示を追加できます。
• 入力欄が空の状態で Escape を 2 回押すと、前のユーザーメッセージを編集し、その時点からチャットを分岐できます。
• Ctrl+C を押すか、/exit を実行すると、セッションを終了できます。

関連リソース

• Codex CLI の概要: インストール、アップグレード、クイックヒント。
• 設定の基本: モデルやプロバイダーなどのデフォルト値を永続化します。
• 高度な設定: プロファイル、プロバイダー、サンドボックスの調整、統合。
• AGENTS.md: Codex エージェントの機能とベストプラクティスの概念的な概要。

スラッシュコマンドを使うと、キーボード中心の操作で Codex をすばやく制御できます。コンポーザーに / と入力してスラッシュポップアップを開き、コマンドを選択すると、ターミナルを離れることなくモデルの切り替え、権限の調整、長いチャットの要約などの操作を Codex が実行します。

このガイドでは、次の方法を説明します。

• タスクに適した組み込みスラッシュコマンドを見つける
• /model、/fast、 /permissions、/approve、/raw、/agents、/subagents、/status などのコマンドで、実行中のセッションを制御する

組み込みのスラッシュコマンド

Codex には次のコマンドが付属しています。スラッシュポップアップを開き、 コマンド名を入力し始めると一覧を絞り込めます。

チャットの実行中でも、スラッシュコマンドを入力して Tab を押すと、 次のターンのキューに追加できます。Codex はキュー内のスラッシュコマンドを実行時に解析するため、 コマンドメニューやエラーは現在のターンの完了後に表示されます。スラッシュコマンドをキューに追加する前であれば、引き続き補完を利用できます。

/quit と /exit は、どちらも CLI を終了します。重要な作業を保存またはコミットした後にのみ使用してください。

Codex が事前確認なしで実行できる操作を調整するには、/permissions を使用します。自動レビューで最近拒否されたアクションを再試行する必要がある場合に限り、/approve を使用してください。

スラッシュコマンドでセッションを操作する

以下のワークフローを使用すると、Codex を再起動せずにセッションを順調に進められます。

/tui でターミナルモードを選択する

1. /tui と入力します。
2. スクロールバックモードまたは全画面モードを選択し、確定します。
3. Codex を再起動して選択を適用します。

期待される結果：次回の起動時に、保存したターミナルモードが使用されます。 --no-alt-screen などの起動時の上書き指定は引き続き適用されます。

/export で会話をエクスポートする

1. /export と入力します。
2. クリップボードにコピー またはファイルに保存 を選択します。

期待される結果：Codex が会話全体を Markdown としてエクスポートします。直接 ファイルに保存するには、/export session.md を実行します。現在のターンが完了してから エクスポートしてください。

/recap でチャットを要約する

1. Codex がアイドル状態のときに、/recap と入力します。

期待される結果：Codex が会話の要約を生成します。これは、 tui.auto_recap = false の場合も同様です。コンテキストの容量を空けたい場合は、/compact を使用します。

/cd でディレクトリを変更する

1. /pwd（または /cwd）と入力して、現在のディレクトリを確認します。
2. ディレクトリを変更するには /cd <path>、ホームディレクトリを使用するには /cd と入力します。

期待される結果：Codex が選択したディレクトリでチャットを続行します。ディレクトリを 変更するには、プライマリセッションがアイドル状態で、キューに入った入力やバックグラウンド ターミナルがないことが必要です。

/worktree でワークツリー内で続行する

1. ローカルの Git リポジトリで /worktree と入力します。
2. 新しいワークツリー で新しいチャットを開始するか、現在の会話を続行するかを 選択します。

期待される結果：Codex が管理対象の Git ワークツリー を作成し、選択したチャットを そこで開始します。ワークツリーを参照 を選択すると、既存のワークツリー とそれを所有する チャットを探せます。このコマンドにはローカルのワークツリーサポートが必要で、 タスクの実行中は使用できません。

/daemon でバックグラウンドサーバーを管理する

1. /daemon と入力します。
2. サーバー接続と利用可能な操作を確認します。

期待される結果：Codex は、ローカルのバックグラウンドサーバーに最新の一般公開安定版をインストールするか、 現在の CLI ビルドを使用するかを提示します。更新を確定すると Codex が終了し、進行中の作業が中断されることがあります。リモート接続の場合は、サーバーを そのホスト上で管理してください。

/warnings で警告を確認する

1. /warnings と入力します。

期待される結果：Codex が保持されている警告とその診断の詳細を表示します。

/model で使用するモデルを設定する

選択画面には、アカウントとワークスペースで利用可能なモデルのみが表示されます。GPT-6.1 Sol が一覧にない場合は、別のモデルを選択してください。プラン別の GPT-6.1 Sol の利用可否をご覧ください。

1. Codex を起動し、入力欄を開きます。
2. /model と入力し、Enter を押します。
3. ポップアップから gpt-6-luna や gpt-6.1-sol などのモデルを選択します。

期待される結果：Codex がトランスクリプト内で新しいモデルを確認します。変更を検証するには /status を実行します。

/fast で Fast モードを切り替える

1. /fast と入力し、現在のモデルの Fast サービス階層をオンにします。
2. もう一度 /fast と入力してオフにします。

期待される結果：Codex が階層を切り替え、選択内容を保存します。TUI のフッターには、 /statusline を使用して Fast モードのステータスライン項目を表示することもできます。

Fast 階層のコマンドはカタログに基づきます。現在のモデルが Fast 階層を提供していない場合、Codex は /fast を表示しません。

/plan で計画モードに切り替える

1. /plan と入力して Enter キーを押し、アクティブなチャットを計画モードに切り替えます。
2. 任意：インラインでプロンプトテキストを指定します（例：/plan Propose a migration plan for this service）。
3. インラインの /plan 引数を使用しながら、コンテンツの貼り付けや画像の添付もできます。

期待される結果：Codex が計画モードに入り、任意で指定したインラインプロンプトを最初の計画依頼として使用します。

Codex がすでに作業中の場合、/plan は一時的に使用できません。

/goal でタスクの目標を設定または表示する

1. 目標を設定するには、/goal <objective> と入力します（例：/goal Finish the migration and keep tests green）。
2. 現在の目標を表示するには、/goal と入力します。
3. 目的を修正するには /goal edit を使用します。一時停止、再開、削除するには、それぞれ /goal pause、/goal resume、/goal clear を使用します。

期待される結果：作業の進行中、Codex がアクティブなチャットに目標を関連付けたままにします。

目標の目的は空にできず、最大 4,000 文字です。それより長い指示はファイルに記載し、そのファイルを目標から参照してください。

/experimental で実験的機能を切り替える

1. /experimental と入力して Enter キーを押します。
2. 使用する機能（Network proxy や Prevent sleep while running など）を切り替え、プロンプトで求められた場合は Codex を再起動します。

期待される結果：Codex が機能の選択内容を設定に保存し、再起動後に適用します。

/approve で自動レビューに拒否された操作を承認する

自動レビュアーが最近のアクションを拒否し、そのアクションを Codex に 1 回再試行させる場合は、 /approve を使用します。

1. /approve と入力します。
2. Codex に該当する拒否済みアクションが表示されたら、再試行を確認します。

期待される結果：Codex が現在のセッションポリシーに従って、その拒否済みアクションを 1 回再試行します。

/memories でメモリを設定する

1. /memories と入力します。
2. Codex が既存のメモリを使用するか、新しいメモリを生成するか、またはメモリ機能を無効のままにするかを選択します。

期待される結果：Codex が今後のセッションに適用されるメモリ設定を更新します。

/skills でスキルを使用する

1. /skills と入力します。
2. Codex に適用させるスキルを選択します。

期待される結果：Codex が選択したスキルのコンテキストを挿入し、次のリクエストがそのスキルの指示に従うようにします。

/import で Claude Code または Cursor の設定をインポートする

1. /import と入力します。
2. Claude Code または Cursor を選択します。
3. 移行するセットアップ、プロジェクトファイル、または最近のチャットを選択します。

期待される結果：Codex が外部エージェントのインポートピッカーを開き、選択した対応済みの成果物を Codex の設定とローカルファイルにインポートします。セッションの検出対象には、 過去 30 日間のチャットが最大 50 件含まれます。

ローカルの TUI セッションから /import を実行します。タスクの実行中、 リモートセッション、およびローカルの app-server デーモンへの接続中は使用できません。

デスクトップアプリでのワークフローと対応している成果物の種類については、別のエージェントからインポートするを参照してください。

/clear でターミナルをクリアして新しいチャットを開始する

1. /clear と入力して Enter キーを押します。

期待される結果：Codex がターミナルをクリアし、表示中のトランスクリプトをリセットして、 同じ CLI セッションで新しいチャットを開始します。

新しいチャットの作成時に名前を付けるには、/clear release prep を実行します。

Ctrl+L とは異なり、/clear は新しいチャットを開始します。

Ctrl+L はターミナルの表示のみをクリアし、現在の チャットを維持します。タスクの進行中は、Codex がどちらの操作も無効にします。

/archive で現在のセッションをアーカイブする

1. /archive と入力し、Enter を押します。
2. 現在のセッションをアーカイブすることを確認します。

想定される結果：Codex はセッションをアーカイブします。 ローカルのバックグラウンドサーバーまたはリモートサーバーに接続している場合は、コマンドセンターに戻ります。共有サーバーがない場合は、 Codex は終了します。会話履歴は保持され、後から次のコマンドで復元できます： codex unarchive <SESSION>。

ターンの実行中に /archive を確定すると、そのターンを停止してからアーカイブします。

/delete で現在のセッションを削除する

1. /delete と入力し、Enter を押します。
2. 現在のセッションを削除することを確認します。

想定される結果：Codex は会話履歴と、そこから生成された子孫セッションを 完全に削除します。ローカルのバックグラウンドサーバーまたはリモートサーバーに接続している場合は、Codex は コマンドセンターに戻ります。共有サーバーがない場合は、Codex は終了します。

チャットの実行中またはサイドチャット内では、/delete を使用できません。

/permissions で権限を更新する

1. /permissions と入力して Enter キーを押します。
2. 安心して使用できる承認プリセットを選択します。たとえば、操作を任せる実行には Auto、編集内容を確認するには Read Only を選択します。名前付きの権限プロファイルが有効な場合、ピッカーには設定済みのカスタムプロファイルとその説明も表示されます。

期待される結果：Codex が更新後のポリシーを通知します。以降のアクションには、 再度変更するまで更新後の承認モードが適用されます。

/ide で IDE コンテキストを含める

1. /ide と入力します。
2. Codex に現在の IDE の選択範囲や開いているファイルをどのように扱ってほしいか説明する場合は、 任意のインラインテキストを追加します。

期待される結果：Codex が利用可能な IDE コンテキストを次のプロンプトに含めます。

/vim で Vim モードを切り替える

1. /vim と入力します。
2. コンポーザーで編集を続けます。

期待される結果：Codex が現在のセッションのコンポーザー Vim モードを切り替えます。新しいセッションで Vim モードをデフォルトにするには、config.toml で tui.vim_mode_default = true を設定します。

/setup-default-sandbox で昇格された Windows サンドボックスを設定する

このコマンドは、Codex が機能の制限された制限付きトークンのサンドボックスを使用している Windows でのみ表示されます。

1. /setup-default-sandbox と入力します。
2. 管理者向けのセットアップフローに従います。

期待される結果：Codex が権限を昇格した Windows サンドボックスを設定し、 対応する自動承認プリセットを選択します。

/copy で最新の応答をコピーする

1. /copy と入力して Enter キーを押します。

期待される結果：Codex が完了した最新の Codex 出力をクリップボードにコピーします。

ターンがまだ実行中の場合、/copy は進行中の応答ではなく、完了した最新の出力を使用します。 Codex の最初の出力が完了する前と、ロールバック直後はこのコマンドを使用できません。

メインの TUI で Ctrl+O を押しても、スラッシュコマンドメニューを開かずに完了した最新の応答をコピーできます。

/raw で raw スクロールバックを切り替える

1. /raw、/raw on、または /raw off と入力します。

期待される結果：Codex が raw スクロールバックモードを切り替え、ターミナル上での選択とコピーをより直接的に行えるようにします。デフォルトの Alt+R キーバインドを使用したり、tui.raw_output_mode = true でデフォルト設定を永続化したりすることもできます。

/status でセッションを確認する

1. 任意のチャットで /status と入力します。
2. アクティブなモデル、承認ポリシー、書き込み可能なルート、および現在のトークン使用量を出力で確認します。TUI がリモート接続されている場合、出力にはリモートアドレスとサーバーのバージョンも表示されます。

期待される結果：Codex が想定した場所で動作していることを確認する概要を出力します。

/usage でアカウントの使用状況を表示する

1. /usage と入力して使用量メニューを開きます。
2. トークン使用状況を表示するか、利用可能な獲得済みリセットを適用するかを選択します。
3. トークン使用状況を直接開くには、/usage daily、/usage weekly、または /usage cumulative と入力します。

期待される結果：Codex が使用量に関するアクションを開くか、選択した表示方法でアカウントのトークン使用状況を表示します。セッションに Codex サービスアカウント認証がない場合、Codex はサインインが必要であることを表示します。

/debug-config で設定レイヤーを確認する

1. /debug-config と入力します。
2. 設定レイヤーの順序（優先度が低いものから）、オン／オフの状態、およびポリシーのソースを出力で確認します。

期待される結果：Codex がレイヤーの診断情報に加え、設定されている場合は allowed_approval_policies、allowed_sandbox_modes、mcp_servers、rules、 experimental_network などのポリシー詳細を出力します。

有効な設定が config.toml と異なる理由をデバッグするには、この出力を使用します。

/statusline でフッター項目を設定する

1. /statusline と入力します。
2. ピッカーで項目の表示／非表示を切り替えて並べ替え、確定します。

期待される結果：フッターのステータスラインが即座に更新され、 config.toml の tui.status_line に永続化されます。

使用可能なステータスライン項目には、モデル、モデル＋推論、コンテキスト統計、レート制限、Git ブランチ、トークンカウンター、セッション ID、現在のディレクトリ／プロジェクトルート、 Codex のバージョンがあります。

/title でターミナルのタイトル項目を設定する

1. /title と入力します。
2. ピッカーで項目の表示／非表示を切り替えて並べ替え、確定します。

期待される結果：ターミナルのウィンドウまたはタブのタイトルが即座に更新され、 config.toml の tui.terminal_title に永続化されます。

使用可能なタイトル項目には、アプリ名、プロジェクト、スピナー、ステータス、スレッド、Git ブランチ、モデル、タスク進捗があります。

/theme でシンタックスハイライトのテーマを選択する

1. /theme と入力します。
2. ピッカーでテーマをプレビューし、確定します。

期待される結果：Codex がシンタックスハイライトを更新し、選択内容を config.toml の tui.theme に永続化します。

/pets でターミナルのペットを選択する

1. /pets（または /pet）と入力してペットピッカーを開きます。
2. 組み込みまたはカスタムのペットを選択するか、ペットをオフにします。

期待される結果：Codex が対応しているターミナルに選択したアンビエントペットを表示し、 選択内容を永続化します。非表示にするには、/pets off と入力することもできます。

/keymap で TUI のショートカットを再割り当てする

TUI のキーボードショートカット割り当てを確認、更新、永続化するには、/keymap を使用します。

1. /keymap と入力します。
2. 変更するショートカットのコンテキストとアクションを選択します。
3. 新しい割り当てを入力するか、既存の割り当てを削除します。

期待される結果：Codex がアクティブなキーマップを更新し、カスタム割り当てを config.toml の tui.keymap に書き込みます。

キーバインドには、ctrl-a、shift-enter、page-down などの名前を使用します。コンテキスト固有の割り当ては tui.keymap.global より優先され、空の割り当てリストを指定するとアクションの割り当てが解除されます。

/ps でバックグラウンドターミナルを確認する

1. /ps と入力します。
2. バックグラウンドターミナルの一覧とその状態を確認します。

期待される結果：Codex が各バックグラウンドターミナルのコマンドに加え、 直近の空でない出力を最大 3 行表示するため、進捗をひと目で把握できます。

unified_exec の使用中はバックグラウンドターミナルが表示されます。それ以外の場合、一覧は空になることがあります。

/stop でバックグラウンドターミナルを停止する

1. /stop と入力します。
2. 一覧のターミナルを停止する前に Codex から確認を求められた場合は、確定します。

期待される結果：Codex が現在のセッションのすべてのバックグラウンドターミナルを停止します。/clean は引き続き /stop のエイリアスとして使用できます。

/compact で会話履歴をコンパクトに保つ

1. 長いやり取りの後に、/compact と入力します。
2. Codex からここまでのチャットを要約する提案が表示されたら、確定します。

期待される結果：Codex が以前のターンを簡潔な要約に置き換え、重要な詳細を維持しながらコンテキストを解放します。

/diff で変更を確認する

1. /diff と入力して Git diff を確認します。
2. CLI 内で出力をスクロールし、編集内容と追加されたファイルを確認します。

期待される結果：Codex がステージ済みの変更、まだステージしていない変更、 および Git がまだ追跡していないファイルを表示するため、残す内容を判断できます。

/mention でファイルを指定する

1. /mention に続けてパスを入力します（例：/mention src/lib/api.ts）。
2. ポップアップから一致する結果を選択します。

期待される結果：Codex がファイルをチャットに追加し、以降のターンからそのファイルを直接参照できるようにします。

/new で新しいチャットを開始する

1. /new と入力し、Enter を押します。
2. Codex にチェックアウト先の選択肢が表示された場合は、現在のディレクトリまたは新しいワークツリーを選択します。

期待される結果：Codex が同じ CLI セッション内で新しいチャットを開始するため、 ターミナルを終了せずにチャットを切り替えられます。

新しいチャットの作成時に名前を付けるには、/new bug bash を実行します。

/clear とは異なり、/new は現在のターミナル表示を先にクリアしません。

/rename で現在のチャットの名前を変更する

1. /rename <name> と入力するか、/rename と入力して名前入力プロンプトを開きます。
2. 後でチャットを見つける際に役立つ短い名前を入力します。

期待される結果：Codex がトランスクリプトを変更せず、保存済みのチャット名を更新します。

/resume で保存済みのチャットを再開する

1. /resume と入力して Enter キーを押します。
2. 保存済みセッションのピッカーから目的のセッションを選択します。

期待される結果：Codex が選択したチャットのトランスクリプトを再読み込みし、元の履歴をそのまま維持しながら、中断したところから再開できるようにします。

/fork で現在のチャットを分岐する

1. /fork と入力し、Enter を押します。
2. Codex にチェックアウト先の選択肢が表示された場合は、現在のディレクトリまたは新しいワークツリーを選択します。

期待される結果：Codex が現在のチャットを新しい ID のチャットへ複製し、元のトランスクリプトを変更せずに維持するため、別のアプローチを並行して検討できます。

現在のチャットではなく保存済みセッションをフォークする必要がある場合は、ターミナルで codex fork を実行してセッションピッカーを開きます。

/app でデスクトップアプリに引き継ぐ

macOS と Windows では、/app と入力して現在のセッションを ChatGPT デスクトップアプリで開きます。アプリがインストールされていない、または実行されていない場合、Codex はインストールまたは起動を求めるエラーを表示します。

期待される結果：デスクトップアプリで同じ保存済みチャットが開き、そこで作業を続けられます。

/side でサイドチャットを開始する

メインチャットから切り替えず、現在のチャットから一時的にフォークするには、/side を使用します。

1. /side と入力してサイドチャットを開きます。
2. 必要に応じてインラインテキストを追加します（例：/side Check whether this plan has an obvious risk）。
3. 焦点を絞った寄り道が終わったら、親チャットに戻ります。

期待される結果：Codex が親チャットとは別のトランスクリプトを持つサイドチャットを開きます。 サイドモードの間も、TUI は親チャットの状態を表示し続けるため、 メインチャットがまだ実行中かどうかを確認できます。

別のサイドチャット内およびレビューモード中は、/side を使用できません。

AGENTS.md を生成するには /init を使用する

1. Codex に永続的な指示を検索させるディレクトリで /init を実行します。
2. 生成された AGENTS.md を確認し、リポジトリの規約に合わせて編集します。

期待される結果：Codex が AGENTS.md のひな形を作成します。このひな形を調整してコミットすれば、 今後のセッションで使用できます。

/review で作業ツリーのレビューを依頼する

1. /review と入力します。
2. 正確なファイル変更を確認する場合は、続けて /diff と入力します。

期待される結果：Codex がワーキングツリーで見つかった問題を要約し、 動作の変更と不足しているテストを重視して報告します。config.toml で review_model を設定していない限り、 現在のセッションのモデルを使用します。

/mcp で MCP ツールの一覧を表示する

1. /mcp と入力します。
2. 一覧を確認し、利用可能な MCP serverとツールを把握します。

期待される結果：このセッションで Codex が呼び出せる、設定済みの Model Context Protocol (MCP) ツールが表示されます。

/mcp verbose を使用すると、サーバーの詳細な診断情報も表示できます。 /mcp login <name> を使用すると、アクティブなセッションから設定済みの MCP server にサインインできます。

/apps でアプリを探す

1. /apps と入力します。
2. 一覧からアプリを選択します。

期待される結果：Codex がアプリへのメンションを $app-slug としてコンポーザーに挿入するため、 すぐにそのアプリの使用を Codex に依頼できます。

/plugins でプラグインを探す

1. /plugins と入力します。
2. マーケットプレイスのタブを選択し、プラグインを選んで機能や利用可能なアクションを確認します。

期待される結果：Codex がプラグインブラウザーを開き、インストール済みのプラグイン、 設定で許可されている検出可能なプラグイン、およびインストール済みプラグインの状態を確認できるようにします。 インストール済みプラグイン上で Space を押すと、有効／無効を切り替えられます。

/hooks でライフサイクルフックを表示・管理する

1. /hooks と入力します。
2. フックイベントを選択し、一致するハンドラーを確認します。
3. 必要に応じて、管理対象外のフックを信頼、無効化、または再有効化します。

期待される結果：Codex がフックブラウザーを開き、設定済みのライフサイクルフックを確認できるようにします。管理対象のフックは管理対象として表示され、ユーザー用のフックブラウザーから無効にすることはできません。

/agents でチャットを管理する

1. /agents と入力し、Enter を押します。
2. コマンドセンターでチャットを選択して開きます。

想定される結果：Codex は接続先サーバー上のチャットの概要を表示します。 各チャットの状態を確認したり、チャットを切り替えたりできます。コマンドセンターを ターミナルから直接開くには、codex agents を実行します。コマンドセンターには、 共有のローカルサーバーまたはリモートサーバーが必要です。

/subagents でエージェントのスレッドを切り替える

1. /subagents と入力し、Enter を押します。
2. 選択画面で目的のスレッドを選択します。

期待される結果：Codex がアクティブなスレッドを切り替え、そのエージェントの作業を確認または続行できるようにします。

/feedback でフィードバックを送信する

1. /feedback と入力して Enter キーを押します。
2. プロンプトに従い、ログまたは診断情報を含めます。

期待される結果：Codex が要求された診断情報を収集し、メンテナーに送信します。

/logout でサインアウトする

1. /logout と入力して Enter キーを押します。

期待される結果：Codex が現在のユーザーセッションのローカル認証情報を消去します。

/quit または /exit で CLI を終了する

1. /quit（または /exit）と入力して Enter キーを押します。

期待される結果：Codex が直ちに終了します。先に重要な作業を保存またはコミットしてください。

以下のコマンドを使用して、VS Code の Command Palette から Codex を操作します。キーボードショートカットに割り当てることもできます。

キーバインドを割り当てる

Codex コマンドのキーバインドを割り当てる、または変更するには、次の手順に従います。

1. Command Palette を開きます（macOS では Cmd+Shift+P、Windows/Linux では Ctrl+Shift+P）。
2. Preferences: Open Keyboard Shortcuts を実行します。
3. Codex またはコマンド ID（例：chatgpt.newChat）を検索します。
4. 鉛筆アイコンを選択し、使用するショートカットを入力します。

拡張機能のコマンド

スラッシュコマンドを使用すると、コンポーザーから離れずに Codex を操作できます。ステータスの確認、ローカルモードとクラウドモードの切り替え、フィードバックの送信に使用できます。

スラッシュコマンドを使用する

1. Codex のコンポーザーで / と入力します。
2. 一覧からコマンドを選択するか、さらに入力して絞り込みます（例：/status）。
3. Enter キーを押します。

利用可能なスラッシュコマンド