開発者向けコマンド¶
このリファレンスの読み方¶
このページでは、文書化されているすべての Codex CLI コマンドとフラグを一覧にしています。インタラクティブな表を使って、キーまたは説明で検索できます。各セクションでは、オプションが安定版か実験版かを示し、リスクのある組み合わせを取り上げています。
CLI は、ほとんどのデフォルト値を ~/.codex/config.toml から継承します。コマンドラインで渡す
-c key=value のオーバーライドは、その実行において
優先されます。詳しくは Config
basics を参照してください。
グローバルフラグ¶
これらのオプションはベースの codex コマンドに適用されます。ほとんどはサブコマンドにも引き継がれますが、例外については上記の注記または該当するコマンドのヘルプを参照してください。引き継がれるフラグについては、該当するコマンドのヘルプに従ってください。たとえば、codex exec --oss ... は exec に --oss を適用します。
コマンドの概要¶
Maturity 列では、Experimental、Beta、Stable などの機能成熟度ラベルを使用しています。これらのラベルの解釈については、Feature Maturity を参照してください。
コマンドの詳細¶
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 を追加して gated fields と methods を含めてください。
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 で初期化し、スレッドを開始して turn を送信し、サーバー通知をストリーミングします。アプリサーバープロトコルの動作をローカルで再現および検査する場合に使用してください。
codex debug models¶
Codex が認識している raw model catalog を JSON として出力します。
現在のバイナリにバンドルされたカタログだけを、リモートの models endpoint から更新せずに検査したい場合は --bundled を使用してください。
codex debug prompt-input¶
モデルに表示される正確な prompt input list を JSON として出力します。指示の検出、セッションコンテキスト、またはプロンプト構築をデバッグする場合に使用してください。
codex apply¶
Codex cloud chat の最新の diff をローカルリポジトリに適用します。認証済みで、該当する 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 が削除することを防ぎます。
codex cloud¶
ターミナルから Codex cloud chat を操作します。デフォルトのコマンドではインタラクティブピッカーが開きます。codex cloud exec はタスクを直接送信し、codex cloud list はスクリプト処理や簡単な検査用に最近の chat を返します。
認証にはメイン 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 はデフォルトで整形済みの出力を書き込みます。状態変更ごとに 1 件の改行区切り JSON イベントを受け取るには --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 でインタラクティブセッションを継続するか、最新の chat を再開します。codex resume は --last の対象を現在の作業ディレクトリに限定します。--all を渡すとこの限定を解除できます。モデルやサンドボックスのオーバーライドを含め、codex と同じグローバルフラグを受け付けます。
codex fork¶
以前のインタラクティブセッションを新しい chat にフォークします。デフォルトでは 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 を押すと、次の turn 用に後続プロンプト、スラッシュコマンド、またはシェルコマンドをキューに入れられます。
- Codex の処理中に Enter を押すと、現在の turn に新しい指示を挿入できます。
- composer が空の状態で Esc を 2 回押すと、直前のユーザーメッセージを編集し、その時点から chat をフォークできます。
- Ctrl+C を押すか
/exitを実行すると、セッションを閉じられます。
関連リソース¶
- Codex CLI overview: インストール、アップグレード、クイックヒント。
- Config basics: モデルやプロバイダーなどのデフォルト値を永続化します。
- Advanced Config: プロファイル、プロバイダー、サンドボックスの調整、インテグレーション。
- AGENTS.md: Codex エージェントの機能とベストプラクティスの概念的な概要。
スラッシュコマンドを使用すると、キーボード中心で Codex をすばやく操作できます。composer に / と入力してスラッシュポップアップを開き、コマンドを選択すると、ターミナルを離れずにモデルの切り替え、権限の調整、長い chat の要約などを Codex が実行します。
このガイドでは、次の方法を説明します。
- タスクに適した組み込みスラッシュコマンドを見つける
/model、/fast、/personality、/permissions、/approve、/raw、/agent、/statusなどのコマンドでアクティブなセッションを操作する
組み込みスラッシュコマンド¶
Codex には次のコマンドが付属しています。スラッシュポップアップを開き、コマンド名の入力を開始すると一覧を絞り込めます。
chat がすでに実行中の場合は、スラッシュコマンドを入力して Tab を押すと、次の turn 用にキューに入れられます。Codex はキューに入れられたスラッシュコマンドを実行時に解析するため、コマンドメニューとエラーは現在の turn が終了した後に表示されます。キューに入れる前であれば、スラッシュ補完は引き続き機能します。
| コマンド | 目的 | 使用するタイミング |
|---|---|---|
/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 |
ターミナルをクリアして新しい chat を開始します。 | 新たに開始したいときに、表示中の UI と chat コンテキストを同時にリセットする場合。 |
/rename |
現在の chat の名前を変更します。 | TUI を離れずに、保存済みセッションに識別しやすい名前を付ける場合。 |
/archive |
現在のセッションをアーカイブして Codex を終了します。 | トランスクリプトを削除せず、現在のセッションをアクティブなセッション一覧から除外する場合。 |
/delete |
現在のセッションを完全に削除して Codex を終了します。 | アーカイブだけでは不十分で、トランスクリプトと子孫セッションを削除する場合。 |
/compact |
表示中の chat を要約してトークンを解放します。 | 長い実行の後、コンテキストウィンドウを使い切らずに Codex に重要な点を保持させる場合。 |
/copy |
最後に完了した Codex の出力をコピーします。 | 手動で選択せずに、最後に完了した応答または計画テキストを取得する場合。Ctrl+O を押すこともできます。 |
/diff |
Git がまだ追跡していないファイルを含め、Git diff を表示します。 | commit またはテスト実行の前に Codex の編集内容を確認する場合。 |
/exit |
CLI を終了します（/quit と同じです）。 |
別の表記です。どちらのコマンドでもセッションを終了できます。 |
/experimental |
実験的機能を切り替えます。 | 実行中の Network proxy や Prevent sleep などのオプションを有効にする場合。 |
/approve |
直近の自動レビュー拒否を 1 回再試行することを承認します。 | 自動レビューで拒否されたコマンドまたはアクションを再試行する場合。 |
/memories |
メモリの使用と生成を構成します。 | TUI を離れずに、メモリの注入または生成をオン・オフする場合。 |
/skills |
スキルを参照して使用します。 | 関連するローカルスキルを選択して、タスク固有の動作を改善する場合。 |
/import |
Claude Code の設定、プロジェクトファイル、最近の chat をインポートします。 | サポートされている外部エージェントの成果物を Codex の構成とローカルファイルに移行する場合。 |
/feedback |
Codex メンテナーにログを送信します。 | 問題を報告したり、サポート用の診断情報を共有したりする場合。 |
/init |
現在のディレクトリに AGENTS.md の scaffold を生成します。 |
作業中のリポジトリまたはサブディレクトリ向けに永続的な指示を保存する場合。 |
/logout |
Codex からサインアウトします。 | 共有マシンを使用している際に、ローカル認証情報を消去する場合。 |
/mcp |
構成済みの Model Context Protocol（MCP）ツールを一覧表示します。 | セッション中に Codex が呼び出せる外部ツールを確認する場合。サーバーの詳細には verbose を追加します。 |
/mention |
ファイルを chat に添付します。 | Codex に次に検査してほしい特定のファイルまたはフォルダーを指定する場合。 |
/model |
アクティブなモデル（および利用可能な場合は reasoning effort）を選択します。 | タスク実行前に gpt-5.4-mini や gpt-5.5 などのモデルを切り替える場合。 |
/fast |
モデルカタログに Fast service tier が公開されている場合に切り替えます。 | 現在のモデルの Fast tier をオンまたはオフにし、選択を永続化する場合。 |
/plan |
plan mode に切り替え、任意でプロンプトを送信します。 | 実装作業の開始前に、Codex に実行計画を提案させる場合。 |
/goal |
タスク目標を設定、編集、一時停止、再開、表示、または消去します。 | より大きなタスクの実行中に Codex が追跡する永続的な目標を与える場合。 |
/personality |
応答のコミュニケーションスタイルを選択します。 | 指示を変更せずに、Codex の応答をより簡潔、説明的、または協調的にする場合。 |
/ps |
バックグラウンドターミナルと最近の出力を表示します。 | メインのトランスクリプトを離れずに、長時間実行中のコマンドを確認する場合。 |
/stop |
すべてのバックグラウンドターミナルを停止します。 | 現在のセッションが開始したバックグラウンドターミナル処理をキャンセルする場合。 |
/fork |
現在の chat を新しい chat にフォークします。 | 現在のトランスクリプトを失わずに別のアプローチを検討するため、アクティブなセッションを分岐する場合。 |
/app |
ChatGPT デスクトップアプリで現在のセッションを継続します。 | macOS または Windows で TUI からデスクトップアプリに移行する場合。 |
/side, /btw |
一時的なサイド chat を開始します。 | メイン chat のトランスクリプトを中断せず、焦点を絞った追加質問をする場合。 |
/raw |
raw scrollback mode を切り替えます。 | 長い出力を確認する際に、ターミナルでの選択とコピーをより非整形にする場合。 |
/resume |
セッション一覧から保存済み chat を再開します。 | 最初からやり直さず、以前の CLI セッションの作業を継続する場合。 |
/new |
同じ CLI セッション内で新しい chat を開始します。 | 同じリポジトリで新しいプロンプトが必要なときに、CLI を離れず chat コンテキストをリセットする場合。 |
/quit |
CLI を終了します。 | セッションをすぐに離れる場合。 |
/review |
Codex に作業ツリーのレビューを依頼します。 | Codex が作業を完了した後、またはローカル変更を別の観点から確認したい場合。 |
/status |
セッション構成とトークン使用量を表示します。 | アクティブなモデル、承認ポリシー、書き込み可能なルート、残りのコンテキスト容量を確認する場合。 |
/usage |
アカウントのトークン使用量を表示するか、レート制限をリセットします。 | TUI 内で ChatGPT の日次、週次、累積のトークン使用状況を確認する場合。 |
/debug-config |
構成レイヤーと要件の診断情報を出力します。 | 実験的なネットワーク制約を含む、優先順位とポリシー要件をデバッグする場合。 |
/statusline |
TUI のステータスライン項目をインタラクティブに構成します。 | フッター項目（model/context/limits/git/tokens/session）を選択して並べ替え、config.toml に永続化する場合。 |
/title |
ターミナルウィンドウまたはタブのタイトル項目をインタラクティブに構成します。 | project、status、thread、branch、model、task progress などのタイトル項目を選択して並べ替える場合。 |
/theme |
構文強調テーマを選択します。 | ターミナルの構文強調テーマをプレビューして永続化する場合。 |
/pets, /pet |
ターミナルペットを選択または非表示にします。 | 組み込みまたはカスタムの ambient pet で TUI をパーソナライズする場合。 |
/quit と /exit はどちらも CLI を終了します。重要な作業を保存または commit した後にのみ使用してください。
/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 Propose a migration plan for this service）。 - インラインの
/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 が機能の選択内容を config に保存し、再起動時に適用します。
/approve で自動レビューの拒否を承認する¶
自動レビュアーが最近のアクションを拒否し、Codex に一度だけ再試行させたい場合は /approve を使用します。
/approveと入力します。- Codex が該当する拒否済みアクションを表示したら、再試行を確認します。
期待される結果: Codex が現在のセッションポリシーに従って、拒否されたアクションを一度だけ再試行します。
/memories でメモリを設定する¶
/memoriesと入力します。- Codex が既存のメモリを使用するか、新しいメモリを生成するか、メモリ機能を無効のままにするかを選択します。
期待される結果: Codex が今後のセッションに適用されるメモリ設定を更新します。
/skills でスキルを使用する¶
/skillsと入力します。- Codex に適用させるスキルを選択します。
期待される結果: Codex が選択したスキルのコンテキストを挿入し、次のリクエストがそのスキルの指示に従うようにします。
/import で Claude Code の設定をインポートする¶
/importと入力します。- 移行する Claude Code のセットアップ、プロジェクトファイル、または最近のチャットを選択します。
期待される結果: Codex が外部エージェントのインポートピッカーを開き、選択したサポート対象のアーティファクトを Codex の設定とローカルファイルにインポートします。
ローカル TUI セッションから /import を実行します。タスクの実行中、リモートセッション、またはローカルの app-server デーモンに接続している間は使用できません。
/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 が制限トークンの低機能サンドボックスを使用している場合にのみ 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 でサンドボックスの読み取りアクセスを許可する¶
このコマンドは、Windows 上で CLI をネイティブに実行している場合にのみ使用できます。
/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 で config レイヤーを調査する¶
/debug-configと入力します。- 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 diff を調査します。- 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 は別のサイドチャット内およびレビューモード中は使用できません。
AGENTS.md を /init で生成する¶
- 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 として挿入するため、すぐにそのアプリを使うよう Codex に依頼できます。
/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 が直ちに終了します。重要な作業は、先に保存またはコミットしてください。