開発者向けコマンド¶
このリファレンスの読み方¶
このページでは、ドキュメント化されているすべての Codex CLI コマンドとフラグを一覧にしています。インタラクティブな表を使って、キーまたは説明で検索できます。各セクションでは、そのオプションが安定版か実験的機能かを示し、リスクのある組み合わせについて説明します。
CLI は、ほとんどのデフォルト値を ~/.codex/config.toml から継承します。コマンドラインで渡す
-c key=value のオーバーライドは、その実行において優先されます。詳しくは 設定の
基本 を参照してください。
グローバルフラグ¶
これらのオプションは、ベースの codex コマンドに適用されます。ほとんどのオプションはサブコマンドにも引き継がれますが、例外については上記の注記または該当するコマンドのヘルプを参照してください。引き継がれるフラグについては、該当するコマンドのヘルプに従ってください。たとえば、codex exec --oss ... は exec に --oss を適用します。
コマンドの概要¶
成熟度の列では、Experimental、Beta、Stable などの機能成熟度ラベルを使用しています。これらのラベルの解釈方法については、機能成熟度 を参照してください。
コマンドの詳細¶
codex（インタラクティブ）¶
サブコマンドなしで codex を実行すると、インタラクティブなターミナル UI（TUI）が起動します。エージェントは、上記のグローバルフラグに加えて画像の添付を受け付けます。Web 検索はデフォルトでキャッシュモードです。ライブブラウジングに切り替えるには --search を使用してください。手軽なローカル作業には --sandbox workspace-write --ask-for-approval on-request を使用します。
--remote ws://host:port または --remote wss://host:port を使用すると、codex app-server --listen ws://IP:PORT で起動したアプリサーバーに TUI を接続できます。ローカル Unix ソケットの場合、デフォルトソケットには --remote unix://、明示的なパスには --remote unix://PATH を使用します。サーバーが WebSocket 認証に bearer token を必要とする場合は、--remote-auth-token-env <ENV_VAR> を追加します。
codex app-server¶
Codex アプリサーバーをローカルで起動します。主に開発とデバッグを目的としており、予告なく変更される可能性があります。
codex app-server --listen stdio:// はデフォルトの JSONL-over-stdio 動作を維持し、codex app-server --stdio はそのトランスポートのエイリアスです。--listen ws://IP:PORT はアプリサーバークライアント向けの WebSocket トランスポートを有効にします。サーバーは ws:// listen URL を受け付けます。クライアントが wss:// で接続する場合は、TLS 終端または安全なプロキシを使用してください。Codex のデフォルト Unix ソケットで WebSocket ハンドシェイクを受け付けるには --listen unix://、ソケットパスを選択するには --listen unix:///absolute/path.sock を使用します。クライアントバインディング用のスキーマを生成する場合は、--experimental を追加してゲートされたフィールドとメソッドを含めます。
codex remote-control¶
codex remote-control を実行すると、フォアグラウンドでリモート制御を開始します。リモート制御を有効にしてローカルのアプリサーバーデーモンを開始するには codex remote-control start、停止するには codex remote-control stop を使用します。管理対象のリモート制御クライアントと SSH リモートワークフローではこれらのコマンドを使用します。ローカルプロトコルクライアントを構築するときに、codex app-server --listen の代わりとなるものではありません。
デーモンの起動後、codex remote-control pair を使用すると、短時間だけ有効な手動ペアリングコードを作成して表示できます。マシンで読み取り可能な出力が必要な場合は、任意のリモート制御コマンドに --json を追加します。pair の場合、JSON レスポンスには pairingCode、manualPairingCode、environmentId、expiresAt が含まれます。
codex app¶
macOS または Windows のターミナルから ChatGPT デスクトップアプリを起動します。macOS では、Codex が特定のワークスペースパスを開けます。Windows では、Codex が開くパスを表示します。
codex app は、インストール済みの ChatGPT デスクトップアプリを開くか、アプリがない場合はインストーラーを起動します。macOS では、Codex が指定されたワークスペースパスを開きます。Windows では、インストール後に開くパスを表示します。
codex debug app-server send-message-v2¶
組み込みのアプリサーバーテストクライアントを使用して、アプリサーバーの V2 thread/turn フローで 1 件のメッセージを送信します。
このデバッグフローでは、experimentalApi: true で初期化し、スレッドを開始してターンを送信し、サーバー通知をストリーミングします。ローカルでアプリサーバープロトコルの動作を再現・調査する際に使用してください。
codex debug models¶
Codex が認識しているモデルカタログを JSON としてそのまま表示します。
リモートの models endpoint から更新せず、現在のバイナリに同梱されているカタログだけを調査したい場合は、--bundled を使用してください。
codex debug prompt-input¶
モデルから見える正確な prompt input リストを JSON として出力します。命令の検出、セッションコンテキスト、またはプロンプト構築をデバッグするときに使用してください。
codex apply¶
Codex cloud chat から最新の差分をローカルリポジトリに適用します。認証済みで、そのチャットにアクセスできる必要があります。
Codex はパッチが適用されたファイルを表示し、git apply が失敗した場合（たとえば競合が原因の場合）はゼロ以外の終了コードで終了します。
codex review¶
コードレビューを非インタラクティブに実行します。レビュー対象を 1 つだけ選択するか、プロンプトとしてカスタムレビュー指示を渡してください。
--uncommitted、--base、--commit、カスタムの PROMPT は相互に競合します。--title は --commit と組み合わせる場合にのみ使用してください。
codex archive と codex unarchive¶
セッション ID またはセッション名で保存済みのインタラクティブセッションをアーカイブまたは復元します。トランスクリプトを削除せずにセッションピッカーを整理したい場合に使用してください。セッション ID はセッション名より優先されます。
codex delete¶
セッション ID またはセッション名で保存済みのインタラクティブセッションを完全に削除します。アクティブなセッション一覧から非表示にするのではなく、トランスクリプト自体を削除したい場合にのみ使用してください。
--force はセッション UUID と組み合わせる場合にのみ使用してください。名前付きセッションでは、同じ名前や曖昧な名前をプロンプトなしで削除しないよう、引き続き確認が必要です。
codex cloud¶
ターミナルから Codex cloud chat を操作します。デフォルトではインタラクティブピッカーが開きます。codex cloud exec はタスクを直接送信し、codex cloud list はスクリプト処理や簡単な調査のために最近のチャットを返します。
認証にはメイン CLI と同じ認証情報を使用します。タスクの送信に失敗すると、Codex はゼロ以外の終了コードで終了します。
codex cloud list¶
最近の cloud chat を、任意のフィルタリングとページネーション付きで一覧表示します。
プレーンテキスト出力では、タスク 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、ターミナル、アプリサーバー、スレッドインベントリの健全性を確認します。
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 execpolicy¶
保存する前に execpolicy ルールファイルを確認します。codex execpolicy check は 1 つ以上の --rules フラグ（たとえば ~/.codex/rules 以下のファイル）を受け付け、最も厳しい判定と一致するルールを示す JSON を出力します。出力を整形するには --pretty を追加します。execpolicy コマンドは現在プレビュー段階です。
codex login¶
ChatGPT アカウント、API key、または access token で CLI を認証します。フラグを指定しない場合、Codex は ChatGPT OAuth フロー用のブラウザを開きます。
資格情報が存在すると、codex login status は 0 で終了します。これは自動化スクリプトで役立ちます。
codex logout¶
API key と ChatGPT 認証の両方について、保存された資格情報を削除します。このコマンドにはフラグがありません。
codex mcp¶
~/.codex/config.toml に保存された Model Context Protocol サーバーエントリを管理します。
add サブコマンドは、stdio と streamable HTTP の両方のトランスポートをサポートします。
OAuth アクション（login、logout）は、streamable 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 shorthand、HTTP または HTTPS Git URL、SSH Git URL、ローカルのマーケットプレイスルートディレクトリを受け付けます。Git ref を固定するには --ref を使用し、Git ベースのマーケットプレイスリポジトリで sparse checkout を使用するには --sparse PATH を繰り返し指定します。
codex plugin marketplace list は、暗黙的に検出されたデフォルトマーケットプレイスや、設定済みマーケットプレイスのスナップショットを含む、対象範囲内のマーケットプレイス名とルートを表示します。
自動化に適した出力にするには、マーケットプレイスの add、list、upgrade、remove コマンドに --json を追加します。マーケットプレイスの add JSON には marketplaceName、installedRoot、alreadyAdded が含まれます。list JSON には name と root、任意の marketplaceSource を含む marketplaces 配列が含まれます。upgrade JSON には selectedMarketplaces、upgradedRoots、errors、remove JSON には marketplaceName、installedRoot が含まれます。
codex mcp-server¶
Codex を stdio 経由の MCP サーバーとして実行し、他のツールから接続できるようにします。このコマンドはグローバル設定のオーバーライドを継承し、下流クライアントが接続を閉じると終了します。
codex resume¶
ID でインタラクティブセッションを継続するか、最新のチャットを再開します。codex resume は --last の対象を現在の作業ディレクトリに限定しますが、--all を渡すとこの制限を解除できます。モデルやサンドボックスのオーバーライドを含め、codex と同じグローバルフラグを受け付けます。
codex fork¶
以前のインタラクティブセッションを新しいチャットにフォークします。デフォルトでは codex fork がセッションピッカーを開きます。最新のセッションをフォークするには --last を追加します。
codex sandbox¶
サンドボックスヘルパーを使用して、Codex が内部で使用するものと同じポリシーの下でコマンドを実行します。
macOS seatbelt¶
Linux Landlock¶
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 を押して一致項目を使用するか、Esc を押してキャンセルします。
- Ctrl+O を押すか、
/copyを実行すると、最後に完了した Codex の出力をコピーできます。 - 行頭に
!を付けると、現在の承認およびサンドボックス設定の下でローカルシェルコマンドを実行できます。 - Codex の作業中に Tab を押すと、次のターン用に後続のプロンプト、スラッシュコマンド、またはシェルコマンドをキューに追加できます。
- Codex の作業中に Enter を押すと、現在のターンに新しい指示を挿入できます。
- composer が空の状態で Esc を 2 回押すと、前のユーザーメッセージを編集し、その時点からチャットをフォークできます。
- Ctrl+C を押すか、
/exitを実行すると、セッションを閉じます。
関連リソース¶
- Codex CLI の概要：インストール、アップグレード、簡単なヒント。
- 設定の基本：モデルやプロバイダーなどのデフォルト値を永続化します。
- Advanced Config：プロファイル、プロバイダー、サンドボックスの調整、インテグレーション。
- AGENTS.md：Codex エージェントの機能とベストプラクティスの概念的な概要。
スラッシュコマンドを使うと、キーボード中心で Codex をすばやく操作できます。composer に / と入力してスラッシュポップアップを開き、コマンドを選択すると、ターミナルを離れずにモデルの切り替え、権限の調整、長いチャットの要約などを Codex が実行します。
このガイドでは、次の方法を説明します。
- タスクに適した組み込みスラッシュコマンドを見つける
/model、/fast、/personality、/permissions、/approve、/raw、/agent、/statusなどのコマンドでアクティブなセッションを操作する
組み込みスラッシュコマンド¶
Codex には次のコマンドが用意されています。スラッシュポップアップを開き、コマンド名の入力を開始すると一覧を絞り込めます。
チャットがすでに実行中の場合、スラッシュコマンドを入力して Tab を押すと、次のターン用にキューに追加できます。Codex はキューに入ったスラッシュコマンドを実行時に解析するため、コマンドメニューとエラーは現在のターンが完了した後に表示されます。キューに追加する前であれば、スラッシュ補完は引き続き機能します。
| コマンド | 目的 | 使用する場面 |
|---|---|---|
/permissions |
Codex が事前確認なしに実行できる操作を設定します。 | セッション中に承認要件を緩和または厳格化する場合。たとえば Auto と Read Only を切り替えます。 |
/ide |
開いているファイル、現在の選択範囲、その他の IDE コンテキストを含めます。 | IDE で何が開いているかを説明し直さず、エディターのコンテキストを次のプロンプトに取り込む場合。 |
/keymap |
TUI のキーボードショートカットを再割り当てします。 | config.toml でカスタムショートカットの割り当てを確認・永続化する場合。 |
/vim |
composer の Vim モードを切り替えます。 | Vim の normal/insert 動作とデフォルトの composer 編集モードを切り替える場合。 |
/setup-default-sandbox |
昇格エージェントサンドボックスを設定します（Windows のみ）。 | Codex が昇格設定を提示した後、機能が低下した Windows サンドボックスを置き換える場合。 |
/sandbox-add-read-dir |
追加ディレクトリへのサンドボックスの読み取りアクセスを許可します（Windows のみ）。 | 現在読み取り可能なルート外にある絶対ディレクトリパスの読み取りが必要なコマンドのブロックを解除する場合。 |
/agent, /subagents |
アクティブなエージェントスレッドを切り替えます。 | 生成されたサブエージェントスレッドの作業を確認または継続する場合。 |
/apps |
アプリ（コネクター）を参照してプロンプトに挿入します。 | Codex に使用を依頼する前に、$app-slug としてアプリを添付する場合。 |
/plugins |
インストール済みおよび検出可能なプラグインを参照します。 | プラグインツールの確認、推奨プラグインのインストール、またはプラグインの利用可能性を管理する場合。 |
/hooks |
ライフサイクルフックを表示・管理します。 | 設定済みフックの確認、新規または変更されたフックの信頼、実行前の非管理フックの無効化を行う場合。 |
/clear |
ターミナルをクリアして新しいチャットを開始します。 | 新たに開始したいときに、表示 UI とチャットコンテキストを同時にリセットする場合。 |
/rename |
現在のチャットの名前を変更します。 | TUI を離れずに、保存済みセッションに見つけやすい名前を付ける場合。 |
/archive |
現在のセッションをアーカイブして Codex を終了します。 | トランスクリプトを削除せずに、現在のセッションをアクティブなセッション一覧から除外する場合。 |
/delete |
現在のセッションを完全に削除して Codex を終了します。 | アーカイブだけでは不十分で、トランスクリプトと子孫セッションを削除する場合。 |
/compact |
表示中のチャットを要約してトークンを解放します。 | 長時間の実行後、コンテキストウィンドウを圧迫せずに重要な点を Codex に保持させる場合。 |
/copy |
最後に完了した Codex の出力をコピーします。 | 手動で選択せず、最後に完了した応答または計画テキストを取得する場合。Ctrl+O を押すこともできます。 |
/diff |
Git がまだ追跡していないファイルを含め、Git 差分を表示します。 | コミットまたはテスト実行前に、Codex の編集内容を確認する場合。 |
/exit |
CLI を終了します（/quit と同じです）。 |
別の表記を使用する場合。どちらのコマンドでもセッションを終了します。 |
/experimental |
実験的機能を切り替えます。 | Network proxy や Prevent sleep while running などのオプションを有効にする場合。 |
/approve |
直近の自動レビュー拒否に対する 1 回の再試行を承認します。 | 自動レビューで拒否されたコマンドまたはアクションを再試行する場合。 |
/memories |
メモリの使用と生成を設定します。 | TUI を離れずに、メモリの注入または生成を有効・無効にする場合。 |
/skills |
スキルを参照して使用します。 | 関連するローカルスキルを選択して、タスク固有の動作を改善する場合。 |
/import |
Claude Code の設定、プロジェクトファイル、最近のチャットをインポートします。 | 対応する外部エージェントの成果物を Codex の設定とローカルファイルに移行する場合。 |
/feedback |
Codex メンテナーにログを送信します。 | 問題を報告したり、サポートに診断情報を共有したりする場合。 |
/init |
現在のディレクトリに AGENTS.md のひな形を生成します。 |
作業中のリポジトリまたはサブディレクトリ用の永続的な指示を記録する場合。 |
/logout |
Codex からサインアウトします。 | 共有マシンを使用しているときに、ローカル資格情報を消去する場合。 |
/mcp |
設定済みの Model Context Protocol（MCP）ツールを一覧表示します。 | セッション中に Codex が呼び出せる外部ツールを確認する場合。サーバーの詳細には verbose を追加します。 |
/mention |
チャットにファイルを添付します。 | 次に Codex に調査させたい特定のファイルまたはフォルダーを指定する場合。 |
/model |
アクティブなモデル（利用可能な場合は推論の強度も）を選択します。 | タスクの実行前に、gpt-5.4-mini や gpt-5.5 などのモデルを切り替える場合。 |
/fast |
モデルカタログに Fast サービスティアがある場合に切り替えます。 | 現在のモデルの Fast ティアをオンまたはオフにし、選択を永続化する場合。 |
/plan |
プランモードに切り替え、必要に応じてプロンプトを送信します。 | 実装作業の開始前に、Codex に実行計画を提案させる場合。 |
/goal |
タスク目標を設定、編集、一時停止、再開、表示、または消去します。 | 大きなタスクの実行中に Codex が追跡する永続的な目標を設定する場合。 |
/personality |
応答のコミュニケーションスタイルを選択します。 | 指示を変更せずに、Codex をより簡潔、説明的、または協調的にする場合。 |
/ps |
バックグラウンドターミナルと最近の出力を表示します。 | メインのトランスクリプトを離れずに、長時間実行中のコマンドを確認する場合。 |
/stop |
すべてのバックグラウンドターミナルを停止します。 | 現在のセッションが開始したバックグラウンドターミナルの作業をキャンセルする場合。 |
/fork |
現在のチャットを新しいチャットにフォークします。 | 現在のトランスクリプトを失わずに、別のアプローチを試すためアクティブなセッションを分岐する場合。 |
/app |
ChatGPT デスクトップアプリで現在のセッションを継続します。 | macOS または Windows で TUI からデスクトップアプリに移行する場合。 |
/side, /btw |
一時的なサイドチャットを開始します。 | メインチャットのトランスクリプトを中断せず、焦点を絞った追加質問をする場合。 |
/raw |
raw scrollback モードを切り替えます。 | 長い出力を確認する際、ターミナルでの選択とコピーの整形を減らす場合。 |
/resume |
セッション一覧から保存済みチャットを再開します。 | 最初からやり直さず、以前の CLI セッションから作業を継続する場合。 |
/new |
同じ CLI セッション内で新しいチャットを開始します。 | 同じリポジトリで新しいプロンプトを使いたいときに、CLI を離れずチャットコンテキストをリセットする場合。 |
/quit |
CLI を終了します。 | セッションをすぐに離れる場合。 |
/review |
Codex に作業ツリーのレビューを依頼します。 | Codex が作業を完了した後、またはローカル変更を別の視点で確認したい場合。 |
/status |
セッション設定とトークン使用量を表示します。 | アクティブなモデル、承認ポリシー、書き込み可能なルート、残りのコンテキスト容量を確認する場合。 |
/usage |
アカウントのトークン使用量を表示するか、レート制限のリセットを使用します。 | TUI 内から ChatGPT の日次、週次、累積トークン使用状況を確認する場合。 |
/debug-config |
設定レイヤーと要件の診断情報を出力します。 | 実験的なネットワーク制約を含む優先順位とポリシー要件をデバッグする場合。 |
/statusline |
TUI のステータス行フィールドをインタラクティブに設定します。 | フッター項目（モデル、コンテキスト、制限、Git、トークン、セッション）の選択と並べ替えを行い、config.toml に保存する場合。 |
/title |
ターミナルウィンドウまたはタブのタイトルフィールドをインタラクティブに設定します。 | プロジェクト、ステータス、スレッド、ブランチ、モデル、タスク進行状況などのタイトル項目を選択・並べ替えする場合。 |
/theme |
構文ハイライトテーマを選択します。 | ターミナルの構文ハイライトテーマをプレビューして永続化する場合。 |
/pets, /pet |
ターミナルペットを選択または非表示にします。 | 組み込みまたはカスタムの環境ペットで TUI をパーソナライズする場合。 |
/quit と /exit はどちらも CLI を終了します。重要な作業を保存またはコミットしてから使用してください。
/permissions を使用して、事前確認なしに Codex が実行できる操作を調整します。/approve は、自動レビューで拒否された直近のアクションを再試行する必要がある場合にのみ使用してください。
スラッシュコマンドでセッションを制御する¶
次のワークフローを使うと、Codex を再起動せずにセッションを軌道に保てます。
/model でアクティブなモデルを設定する¶
- Codex を起動して composer を開きます。
/modelと入力して Enter を押します。- ポップアップから
gpt-5.4-miniやgpt-5.5などのモデルを選択します。
期待される結果：Codex がトランスクリプトで新しいモデルを確認します。/status を実行して変更を確認します。
/fast で Fast モードを切り替える¶
/fastと入力して、現在のモデルの Fast サービスティアをオンにします。- もう一度
/fastと入力してオフにします。
期待される結果：Codex がティアを切り替え、選択を保存します。TUI のフッターでは、/statusline を使って Fast モードのステータス行項目を表示することもできます。
Fast ティアのコマンドはカタログに基づきます。現在のモデルが Fast ティアを公開していない場合、Codex は /fast を表示しません。
/personality でコミュニケーションスタイルを設定する¶
/personality を使用すると、プロンプトを書き換えずに Codex のコミュニケーション方法を変更できます。
- アクティブなチャットで
/personalityと入力して Enter を押します。 - ポップアップからスタイルを選択します。
期待される結果：Codex がトランスクリプトで新しいスタイルを確認し、チャット内の以後の応答で使用します。
Codex は friendly、pragmatic、none のパーソナリティをサポートします。パーソナリティの指示を無効にするには none を使用します。
アクティブなモデルがパーソナリティ固有の指示をサポートしていない場合、Codex はこのコマンドを非表示にします。
/plan でプランモードに切り替える¶
/planと入力して Enter を押し、アクティブなチャットをプランモードに切り替えます。- 任意：インラインプロンプトテキストを指定します（例：
/plan このサービスの移行計画を提案してください）。 - インラインの
/plan引数を使用している間も、コンテンツを貼り付けたり画像を添付したりできます。
期待される結果：Codex がプランモードに入り、任意のインラインプロンプトを最初の計画リクエストとして使用します。
Codex がすでに作業中の場合、/plan は一時的に使用できません。
/goal でタスク目標を設定または表示する¶
/goal <objective>と入力して目標を設定します。例：/goal Finish the migration and keep tests green。/goalと入力して現在の目標を表示します。/goal editで目標を修正します。/goal pause、/goal resume、/goal clearを使うと、一時停止、再開、削除ができます。
期待される結果：Codex が作業の継続中、アクティブなチャットに目標を保持します。
目標は空でない必要があり、最大 4,000 文字です。長い指示の場合は、詳細をファイルに記載し、そのファイルを目標から参照してください。
/experimental で実験的機能を切り替える¶
/experimentalと入力して Enter を押します。- 必要な機能（Network proxy や Prevent sleep while running など）を切り替え、プロンプトが表示された場合は Codex を再起動します。
期待される結果：Codex が機能の選択を設定に保存し、再起動時に適用します。
/approve で自動レビューの拒否を承認する¶
自動レビューで直近のアクションが拒否され、Codex に 1 回だけ再試行させたい場合は /approve を使用します。
/approveと入力します。- Codex が該当する拒否済みアクションを表示したら、再試行を確認します。
期待される結果：Codex が現在のセッションポリシーの下で、拒否されたアクションを 1 回再試行します。
/memories でメモリを設定する¶
/memoriesと入力します。- Codex が既存のメモリを使用するか、新しいメモリを生成するか、メモリ機能を無効のままにするかを選択します。
期待される結果：Codex が今後のセッション向けに該当するメモリ設定を更新します。
/skills でスキルを使用する¶
/skillsと入力します。- Codex に適用させるスキルを選択します。
期待される結果：Codex が選択したスキルのコンテキストを挿入し、次のリクエストがそのスキルの指示に従うようにします。
/import で Claude Code 設定をインポートする¶
/importと入力します。- 移行する Claude Code の設定、プロジェクトファイル、または最近のチャットを選択します。
期待される結果：Codex が外部エージェントのインポートピッカーを開き、選択した対応済みの成果物を Codex の設定とローカルファイルにインポートします。
ローカル TUI セッションから /import を実行してください。タスクの実行中、リモートセッション中、またはローカルのアプリサーバーデーモンに接続している間は使用できません。
/clear でターミナルをクリアして新しいチャットを開始する¶
/clearと入力して Enter を押します。
期待される結果：Codex がターミナルをクリアし、表示中のトランスクリプトをリセットして、同じ CLI セッションで新しいチャットを開始します。
Ctrl+L とは異なり、/clear は新しいチャットを開始します。
Ctrl+L はターミナル表示だけをクリアし、現在のチャットは保持します。タスクの進行中は、Codex は両方の操作を無効にします。
/archive で現在のセッションをアーカイブする¶
/archiveと入力して Enter を押します。- 現在のセッションをアーカイブして Codex を終了することを確認します。
期待される結果：Codex が現在のセッションをアーカイブし、インタラクティブ TUI を閉じます。Codex はセッションのトランスクリプトをローカルに保存するため、後で codex unarchive <SESSION> を使って復元できます。
/archive はタスクの実行中は使用できません。
/delete で現在のセッションを削除する¶
/deleteと入力して Enter を押します。- 現在のセッションを削除して Codex を終了することを確認します。
期待される結果：Codex が現在のセッションのトランスクリプトを削除し、インタラクティブ TUI を閉じます。削除は完全であり、生成された子孫セッションも削除されます。
/delete はチャットの実行中またはサイドチャット内では使用できません。
/permissions で権限を更新する¶
/permissionsと入力して Enter を押します。- 自分の許容レベルに合った承認プリセットを選択します。たとえば、人手を介さずに実行する場合は
Auto、編集内容を確認する場合はRead Onlyを選択します。名前付き権限プロファイルがアクティブな場合、ピッカーには設定済みのカスタムプロファイルとその説明も表示されます。
期待される結果：Codex が更新されたポリシーを通知します。再度変更するまで、以後のアクションは更新された承認モードに従います。
/ide で IDE コンテキストを含める¶
/ideと入力します。- 現在の IDE の選択範囲または開いているファイルを Codex にどう扱わせるか説明したい場合は、任意のインラインテキストを追加します。
期待される結果：Codex が利用可能な IDE コンテキストを次のプロンプトに含めます。
/vim で Vim モードを切り替える¶
/vimと入力します。- composer で編集を続けます。
期待される結果：Codex が現在のセッションの composer Vim モードを切り替えます。新しいセッションで Vim モードをデフォルトにするには、config.toml の tui.vim_mode_default = true を設定します。
/setup-default-sandbox で昇格された Windows サンドボックスを設定する¶
このコマンドは、Codex が機能の低下した restricted-token サンドボックスを使用している場合に、Windows でのみ表示されます。
/setup-default-sandboxと入力します。- 管理者設定フローに従います。
期待される結果：Codex が昇格された Windows サンドボックスを設定し、対応する自動承認プリセットを選択します。
/copy で最新の応答をコピーする¶
/copyと入力して Enter を押します。
期待される結果：Codex が最後に完了した Codex の出力をクリップボードにコピーします。
ターンがまだ実行中の場合、/copy は進行中の応答ではなく、最後に完了した出力を使用します。最初の Codex 出力が完了する前、およびロールバック直後は、このコマンドを使用できません。
メイン TUI から Ctrl+O を押して、スラッシュコマンドメニューを開かずに最後に完了した応答をコピーすることもできます。
/raw で raw scrollback を切り替える¶
/raw、/raw on、または/raw offと入力します。
期待される結果：Codex が raw scrollback モードを切り替えます。これにより、ターミナルでの選択とコピーをより直接的に行えます。デフォルトの Alt+R バインディングを使用することも、tui.raw_output_mode = true でデフォルトを永続化することもできます。
/sandbox-add-read-dir でサンドボックスの読み取りアクセスを許可する¶
このコマンドは、CLI を Windows 上でネイティブに実行している場合にのみ使用できます。
/sandbox-add-read-dir C:\absolute\directory\pathと入力して Enter を押します。- パスが既存の絶対ディレクトリであることを確認します。
期待される結果：Codex が Windows サンドボックスポリシーを更新し、サンドボックス内で実行される以後のコマンドに対して、そのディレクトリへの読み取りアクセスを許可します。
/status でセッションを調査する¶
- 任意のチャットで
/statusと入力します。 - アクティブなモデル、承認ポリシー、書き込み可能なルート、現在のトークン使用量を出力で確認します。TUI がリモート接続されている場合、出力にはリモートアドレスとサーバーバージョンも表示されます。
期待される結果：Codex が、想定した環境で動作していることを確認する概要を表示します。
/usage でアカウント使用量を表示する¶
/usageと入力して使用量メニューを開きます。- トークンのアクティビティを表示するか、利用可能な獲得済みリセットを引き換えるかを選択します。
- トークンのアクティビティを直接開くには、
/usage daily、/usage weekly、または/usage cumulativeと入力します。
期待される結果：Codex が使用量に関する操作を開くか、選択したビューのアカウントトークンアクティビティを表示します。セッションに Codex サービスアカウント認証がない場合、Codex はサインインが必要であることを表示します。
/debug-config で設定レイヤーを調査する¶
/debug-configと入力します。- 設定レイヤーの順序（優先順位の低いものから）、オン／オフ状態、ポリシーソースを出力で確認します。
期待される結果：Codex がレイヤーの診断情報と、設定されている場合は allowed_approval_policies、allowed_sandbox_modes、mcp_servers、rules、enforce_residency、experimental_network などのポリシー詳細を表示します。
有効な設定が config.toml と異なる理由をデバッグするには、この出力を使用します。
/statusline でフッター項目を設定する¶
/statuslineと入力します。- ピッカーで項目の切り替えと並べ替えを行い、確認します。
期待される結果：フッターのステータス行がすぐに更新され、config.toml の tui.status_line に永続化されます。
利用可能なステータス行項目には、モデル、モデル＋推論、コンテキスト統計、レート制限、Git ブランチ、トークンカウンター、セッション ID、現在のディレクトリ／プロジェクトルート、Codex バージョンがあります。
/title でターミナルタイトル項目を設定する¶
/titleと入力します。- ピッカーで項目の切り替えと並べ替えを行い、確認します。
期待される結果：ターミナルウィンドウまたはタブのタイトルがすぐに更新され、config.toml の tui.terminal_title に永続化されます。
利用可能なタイトル項目には、アプリ名、プロジェクト、スピナー、ステータス、スレッド、Git ブランチ、モデル、タスク進行状況があります。
/theme で構文テーマを選択する¶
/themeと入力します。- ピッカーからテーマをプレビューし、確認します。
期待される結果：Codex が構文ハイライトを更新し、選択を config.toml の tui.theme に永続化します。
/pets でターミナルペットを選択する¶
/pets（または/pet）と入力して、ペットピッカーを開きます。- 組み込みまたはカスタムのペットを選択するか、ペットをオフにします。
期待される結果：Codex が対応するターミナルに選択した環境ペットを表示し、選択を永続化します。/pets off と入力して非表示にすることもできます。
/keymap で TUI ショートカットを再割り当てする¶
/keymap を使用して、TUI のキーボードショートカットの割り当てを確認、更新、永続化します。
/keymapと入力します。- 変更するショートカットのコンテキストとアクションを選択します。
- 新しいバインディングを入力するか、既存のものを削除します。
期待される結果：Codex がアクティブなキーマップを更新し、カスタムバインディングを config.toml の tui.keymap に書き込みます。
キーバインディングでは、ctrl-a、shift-enter、page-down などの名前を使用します。コンテキスト固有のバインディングは tui.keymap.global を上書きします。空のバインディングリストはアクションのバインドを解除します。
/ps でバックグラウンドターミナルを確認する¶
/psと入力します。- バックグラウンドターミナルの一覧とステータスを確認します。
期待される結果：Codex が各バックグラウンドターミナルのコマンドと、直近の空でない出力を最大 3 行表示するため、進行状況を一目で把握できます。
unified_exec が使用されている場合にバックグラウンドターミナルが表示されます。それ以外の場合、一覧は空になる可能性があります。
/stop でバックグラウンドターミナルを停止する¶
/stopと入力します。- Codex が確認を求めた場合は、一覧表示されたターミナルの停止を確認します。
期待される結果：Codex が現在のセッションのすべてのバックグラウンドターミナルを停止します。/clean は /stop のエイリアスとして引き続き使用できます。
/compact でトランスクリプトを簡潔に保つ¶
- 長いやり取りの後、
/compactと入力します。 - これまでのチャットを要約する提案が Codex から表示されたら確認します。
期待される結果：Codex が以前のターンを簡潔な要約に置き換え、重要な詳細を保持しながらコンテキストを解放します。
/diff で変更をレビューする¶
/diffと入力して Git 差分を確認します。- CLI 内の出力をスクロールし、編集内容と追加されたファイルを確認します。
期待される結果：Codex がステージ済みの変更、まだステージしていない変更、Git がまだ追跡していないファイルを表示するため、残すものを判断できます。
/mention でファイルを強調表示する¶
/mentionに続けてパスを入力します。例：/mention src/lib/api.ts。- ポップアップから一致する結果を選択します。
期待される結果：Codex がファイルをチャットに追加し、後続のターンでそのファイルを直接参照できるようにします。
/new で新しいチャットを開始する¶
/newと入力して Enter を押します。
期待される結果：Codex が同じ CLI セッションで新しいチャットを開始するため、ターミナルを離れずにチャットを切り替えられます。
/clear とは異なり、/new は現在のターミナル表示を先にクリアしません。
/rename で現在のチャットの名前を変更する¶
/rename <name>と入力するか、/renameと入力して名前入力プロンプトを開きます。- 後でチャットを見つけやすくなる短い名前を入力します。
期待される結果：Codex がトランスクリプトを変更せずに、保存済みチャットの名前を更新します。
/resume で保存済みチャットを再開する¶
/resumeと入力して Enter を押します。- 保存済みセッションのピッカーから、使用するセッションを選択します。
期待される結果：Codex が選択したチャットのトランスクリプトを再読み込みするため、元の履歴を維持したまま作業を続けられます。
/fork で現在のチャットをフォークする¶
/forkと入力して Enter を押します。
期待される結果：Codex が現在のチャットを新しい ID のチャットに複製し、元のトランスクリプトを変更しないため、別のアプローチを並行して試せます。
現在のセッションではなく保存済みセッションをフォークする必要がある場合は、ターミナルで codex fork を実行してセッションピッカーを開きます。
/app でデスクトップアプリを続行する¶
macOS と Windows では、/app と入力して現在のセッションを ChatGPT デスクトップアプリで開きます。アプリがインストールされていないか起動していない場合、Codex はインストールまたは起動を求めるエラーを表示します。
期待される結果：デスクトップアプリが同じ保存済みチャットを開くため、そこで作業を続けられます。
/side でサイドチャットを開始する¶
/side を使用すると、メインチャットから切り替えずに、現在のチャットから一時的なフォークを開始できます。
/sideと入力してサイドチャットを開きます。- 必要に応じてインラインテキストを追加します。例：
/side Check whether this plan has an obvious risk。 - 焦点を絞った寄り道が終わったら、親チャットに戻ります。
期待される結果：Codex が親チャットとは別のトランスクリプトを持つサイドチャットを開きます。サイドモード中も、TUI には親チャットのステータスが表示されるため、メインチャットがまだ実行中か確認できます。
/side は別のサイドチャット内およびレビュー中は使用できません。
/init で AGENTS.md を生成する¶
- Codex に永続的な指示を探させたいディレクトリで
/initを実行します。 - 生成された
AGENTS.mdを確認し、リポジトリの規約に合わせて編集します。
期待される結果：Codex が、今後のセッションに向けて改良・コミットできる AGENTS.md のひな形を作成します。
/review で作業ツリーのレビューを依頼する¶
/reviewと入力します。- 正確なファイル変更を確認したい場合は、
/diffでフォローアップします。
期待される結果：Codex が作業ツリーで見つけた問題を要約し、動作の変更と不足しているテストに焦点を当てます。config.toml に review_model を設定しない限り、現在のセッションモデルを使用します。
/mcp で MCP ツールを一覧表示する¶
/mcpと入力します。- 一覧を確認し、このセッションで利用可能な MCP サーバーとツールを確認します。
期待される結果：このセッションで Codex が呼び出せる、設定済みの Model Context Protocol（MCP）ツールを確認できます。
詳細なサーバー診断情報を含めるには /mcp verbose を使用します。verbose 以外のものを渡した場合、Codex はコマンドの使用方法を表示します。
/apps でアプリを参照する¶
/appsと入力します。- 一覧からアプリを選択します。
期待される結果：Codex が composer に $app-slug としてアプリへのメンションを挿入するため、すぐにそのアプリの使用を依頼できます。
/plugins でプラグインを参照する¶
/pluginsと入力します。- マーケットプレイスのタブを選択し、プラグインを選んで機能または利用可能なアクションを確認します。
期待される結果：Codex がプラグインブラウザーを開き、インストール済みプラグイン、設定で許可された検出可能なプラグイン、インストール済みプラグインの状態を確認できます。インストール済みプラグインで Space を押すと、有効状態を切り替えられます。
/hooks でライフサイクルフックを表示・管理する¶
/hooksと入力します。- フックイベントを選択して、一致するハンドラーを確認します。
- 必要に応じて、非管理フックを信頼、無効化、または再有効化します。
期待される結果：Codex がフックブラウザーを開き、設定済みのライフサイクルフックを確認できます。管理対象のフックは管理対象として表示され、ユーザーフックブラウザーから無効化することはできません。
/agent でエージェントスレッドを切り替える¶
/agentまたは/subagentsと入力して Enter を押します。- ピッカーから使用するスレッドを選択します。
期待される結果：Codex がアクティブなスレッドを切り替えるため、そのエージェントの作業を確認または継続できます。
/feedback でフィードバックを送信する¶
/feedbackと入力して Enter を押します。- プロンプトに従い、ログまたは診断情報を含めます。
期待される結果：Codex が要求された診断情報を収集し、メンテナーに送信します。
/logout でサインアウトする¶
/logoutと入力して Enter を押します。
期待される結果：Codex が現在のユーザーセッションのローカル資格情報を消去します。
/quit または /exit で CLI を終了する¶
/quit（または/exit）と入力して Enter を押します。
期待される結果：Codex がすぐに終了します。重要な作業は事前に保存またはコミットしてください。