開発者向けコマンド
開発者向けコマンド
ChatGPT デスクトップ、Codex CLI、Codex IDE 拡張機能のコマンドおよびスラッシュコマンドのリファレンスです。
ChatGPT Web のコマンド
ChatGPT Web には独自のコンポーザーコマンドメニューがあります。現在のチャットで
利用できるアクションを確認するには、/ と入力します。ChatGPT デスクトップアプリや CLI の
コマンドセットは表示されません。このリファレンスに記載された Codex のスラッシュコマンド、CLI サブコマンド、
フラグは ChatGPT Web には適用されません。
ChatGPT デスクトップアプリのコマンド
一般的な コマンドページでは、アプリのナビゲーション、 チャットのショートカット、キーボードのカスタマイズ、およびチャット、設定、 スキル、スケジュールされたタスク、プラグイン、ペットへのディープリンクについて説明しています。
スラッシュコマンドページでは、/feedback、/goal、/init、
/mcp、/plan、/review、/status など、アプリのコンポーザーから
利用できるコマンドについて説明しています。
Codex CLI コマンドリファレンス
このリファレンスの読み方
このページでは、文書化されているすべての Codex CLI コマンドとフラグを一覧にしています。インタラクティブな表では、キーまたは説明で検索できます。各セクションには、オプションが Stable か Experimental かが示され、リスクのある組み合わせには注意事項が記載されています。
グローバルフラグ
| キー | 型 / 値 | 詳細 |
|---|---|---|
--add-dir |
path |
メインワークスペースに加え、追加のディレクトリへの書き込みアクセスを許可します。複数のパスには繰り返し指定します。 |
--ask-for-approval, -a |
untrusted | on-request | never |
コマンド実行前に Codex が人による承認を求めて一時停止するタイミングを制御します。 |
--cd, -C |
path |
エージェントがリクエストの処理を開始する前に、作業ディレクトリを設定します。 |
--config, -c |
key=value |
設定値をオーバーライドします。可能な場合は TOML として解析され、それ以外の場合はリテラル文字列が使用されます。 |
--dangerously-bypass-approvals-and-sandbox, --yolo |
boolean |
すべてのコマンドを承認もサンドボックスも使用せずに実行します。外部で十分に保護された環境内でのみ使用してください。 |
--dangerously-bypass-hook-trust |
boolean |
この呼び出しでは、永続化されたフックの信頼を要求せず、有効なフックを実行します。フックのソースを事前に検証する自動化専用です。 |
--disable |
feature |
機能フラグを強制的に無効化します（-c features.<name>=false に変換されます）。繰り返し指定できます。 |
--enable |
feature |
機能フラグを強制的に有効化します（-c features.<name>=true に変換されます）。繰り返し指定できます。 |
--image, -i |
path[,path...] |
最初のプロンプトに 1 つ以上の画像ファイルを添付します。複数のパスはカンマで区切るか、フラグを繰り返します。 |
--local-provider |
lmstudio | ollama |
--oss とともに使用するローカルプロバイダーを選択し、この実行では oss_provider をオーバーライドします。 |
--model, -m |
string |
設定で指定されたモデルをオーバーライドします（例: gpt-5.6-terra）。 |
--no-alt-screen |
boolean |
TUI の代替画面モードを無効化します（この実行では tui.alternate_screen をオーバーライドします）。 |
--oss |
boolean |
ローカルのオープンソースモデルプロバイダーを使用します。Codex は --local-provider、設定済みの oss_provider のいずれかを使用するか、LM Studio と Ollama のどちらを使用するか確認します。 |
--profile, -p |
string |
ベースとなるユーザー設定の上に $CODEX_HOME/profile-name.config.toml を重ねて適用します。 |
--remote |
ws://host:port | wss://host:port | unix:// | unix://PATH |
WebSocket または Unix ソケット経由でリモート app-server エンドポイントに接続します。codex、codex resume、codex fork、codex archive、codex delete、codex unarchive でサポートされます。その他のサブコマンドではリモートモードが拒否されます。 |
--remote-auth-token-env |
ENV_VAR |
この環境変数からベアラートークンを読み取り、--remote で接続するときに送信します。--remote が必要です。トークンは wss:// URL またはローカル専用の ws:// URL でのみ送信されます。 |
--sandbox, -s |
read-only | workspace-write | danger-full-access |
モデルが生成したシェルコマンドに適用するサンドボックスポリシーを選択します。 |
--search |
boolean |
ライブ Web 検索を有効にします（デフォルトの "cached" ではなく web_search = "live" を設定します）。 |
--strict-config |
boolean |
config.toml に、このバージョンの Codex が認識しないフィールドが含まれている場合にエラーにします。codex、exec、review、resume、fork、app-server、mcp-server、exec-server などのランタイムコマンドでサポートされます。 |
PROMPT |
string |
セッション開始時に使用する任意のテキスト指示です。メッセージが入力されていない状態で TUI を起動するには省略します。 |
これらのオプションは、ベースとなる codex コマンドに適用されます。ほとんどは各コマンドにも引き継がれますが、
例外については上記の注記または該当するコマンドのヘルプを参照してください。引き継がれる
フラグについては、該当するコマンドのヘルプに従ってください。たとえば、codex exec --oss ... は
--oss を exec に適用します。
コマンドの概要
| キー | 成熟度 | 詳細 |
|---|---|---|
codex |
Stable | ターミナル UI を起動します。上記のグローバルフラグに加え、任意のプロンプトまたは画像添付を指定できます。 |
codex app |
Stable | macOS または Windows で ChatGPT デスクトップアプリを起動します。macOS では Codex がワークスペースのパスを開けます。Windows では開くパスが表示されます。 |
codex app-server |
Experimental | ローカルでの開発やデバッグのため、stdio、WebSocket、または Unix ソケット経由で Codex app server を起動します。 |
codex apply |
Stable | Codex クラウドチャットが生成した最新の差分をローカル作業ツリーに適用します。エイリアス: codex a。 |
codex archive |
Stable | 保存済みのインタラクティブセッションを、セッション ID またはセッション名でアーカイブします。 |
codex cloud |
Experimental | TUI を開かずに、ターミナルから Codex クラウドチャットを参照または実行します。エイリアス: codex cloud-tasks。 |
codex completion |
Stable | Bash、Zsh、Fish、PowerShell 用のシェル補完スクリプトを生成します。 |
codex debug app-server send-message-v2 |
Experimental | 組み込みテストクライアントから V2 メッセージを 1 件送信して app-server をデバッグします。 |
codex debug models |
Experimental | Codex が認識している未加工のモデルカタログを表示します。バンドル済みカタログだけを確認するオプションもあります。 |
codex debug prompt-input |
Experimental | モデルに表示されるプロンプト入力のリストを JSON としてレンダリングします。任意でプロンプトと画像も指定できます。 |
codex delete |
Stable | 保存済みのインタラクティブセッションを、セッション ID またはセッション名で完全に削除します。 |
codex doctor |
Stable | ローカルのインストール、設定、認証、ランタイム、Git、ターミナル、app-server、スレッド一覧の問題に関する診断レポートを生成します。 |
codex exec |
Stable | Codex を非インタラクティブに実行します。エイリアス: codex e。結果を stdout または JSONL にストリーミングし、任意で以前のセッションを再開できます。 |
codex execpolicy |
Experimental | execpolicy ルールファイルを評価し、コマンドが許可、確認、ブロックのいずれになるかを確認します。 |
codex features |
Stable | 機能フラグを一覧表示し、config.toml で永続的に有効化または無効化します。 |
codex fork |
Stable | 元のトランスクリプトを保持したまま、以前のインタラクティブセッションを新しいチャットにフォークします。 |
codex login |
Stable | ChatGPT OAuth、デバイス認証、API key、または stdin から渡したアクセストークンを使用して Codex を認証します。 |
codex logout |
Stable | 保存されている認証情報を削除します。 |
codex mcp |
Stable | Model Context Protocol サーバーを管理します（一覧表示、追加、削除、認証）。 |
codex mcp-server |
Deprecated | Codex を stdio 経由の MCP serverとして実行する非推奨のインターフェースです。代わりに Codex app server を使用してください。Claude Code から Codex を呼び出すには、Claude Code 用 Codex プラグインを使用してください。 |
codex plugin |
Stable | 設定済みのマーケットプレイスソースからプラグインをインストール、一覧表示、削除します。 |
codex plugin marketplace |
Stable | Git またはローカルソースからプラグインマーケットプレイスを追加、一覧表示、アップグレード、削除します。 |
codex remote-control |
Experimental | ローカル app-server のリモートコントロールを実行または管理するか、有効期間の短いペアリングコードを作成します。 |
codex resume |
Stable | 以前のインタラクティブセッションを ID で続行するか、最新のチャットを再開します。 |
codex review |
Stable | 未コミットの変更、ベースブランチとの差分、コミット、またはカスタムレビュー指示を非インタラクティブにレビューします。 |
codex sandbox |
Stable | Codex が提供する macOS、Linux、Windows のサンドボックス内で任意のコマンドを実行します。 |
codex unarchive |
Stable | アーカイブ済みのインタラクティブセッションを、セッション ID またはセッション名で復元します。 |
codex update |
Stable | インストール済みリリースが自己更新に対応している場合、Codex CLI の更新を確認して適用します。 |
コマンドの詳細
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 app-server
Codex app server をローカルで起動します。主に開発およびデバッグ用であり、予告なく変更される場合があります。
| キー | 型 / 値 | 詳細 |
|---|---|---|
--analytics-default-enabled |
boolean |
ユーザーが設定でオプトアウトしていない限り、ファーストパーティの app-server クライアントで分析をデフォルトで有効にします。 |
--listen |
stdio:// | ws://IP:PORT | unix:// | unix://PATH | off |
トランスポートのリスナー URL です。JSONL には stdio://、TCP WebSocket エンドポイントには ws://IP:PORT、デフォルトの Unix ソケットには unix://、カスタム Unix ソケットには unix://PATH、ローカルトランスポートを無効化するには off を使用します。 |
--stdio |
boolean |
stdio トランスポートを使用します。--listen stdio:// と同等で、--listen とは同時に使用できません。 |
--ws-audience |
string |
署名付きベアラートークンに期待される aud クレームです。--ws-auth signed-bearer-token が必要です。 |
--ws-auth |
capability-token | signed-bearer-token |
app-server WebSocket クライアントの認証モードです。省略すると WebSocket 認証は無効になります。ローカル以外のリスナーでは起動時に警告が表示されます。 |
--ws-issuer |
string |
署名付きベアラートークンに期待される iss クレームです。--ws-auth signed-bearer-token が必要です。 |
--ws-max-clock-skew-seconds |
number |
署名付きベアラートークンの exp および nbf クレームを検証するときに許容するクロックスキューです。--ws-auth signed-bearer-token が必要です。 |
--ws-shared-secret-file |
absolute path |
署名付き JWT ベアラートークンの検証に使用する HMAC 共有シークレットを含むファイルです。--ws-auth signed-bearer-token とともに指定する必要があります。 |
--ws-token-file |
absolute path |
共有ケイパビリティトークンを含むファイルです。代わりに --ws-token-sha256 を指定しない限り、--ws-auth capability-token とともに使用します。 |
--ws-token-sha256 |
hexadecimal SHA-256 digest |
ケイパビリティトークン認証で期待される SHA-256 ダイジェストです。クライアントトークンを別のソースから取得する場合は、--ws-token-file の代わりに使用します。 |
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 を実行します。
リモートコントロールを有効にしてローカル app-server デーモンを起動するには
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 では、開くパスが 表示されます。
| キー | 型 / 値 | 詳細 |
|---|---|---|
--download-url |
url |
インストール時に使用する ChatGPT デスクトップアプリのインストーラー URL を高度な設定でオーバーライドします。 |
PATH |
path |
ChatGPT デスクトップアプリのワークスペースパスです。macOS では Codex がこのパスを開き、Windows ではパスを表示します。 |
codex app は、インストール済みの ChatGPT デスクトップアプリを開きます。アプリがない場合は
インストーラーを起動します。macOS では Codex が指定されたワークスペースパスを開き、
Windows ではインストール後に開くパスを表示します。
codex debug app-server send-message-v2
組み込みの app-server テストクライアントを使用して、app-server の V2 スレッド／ターンフロー経由でメッセージを 1 件送信します。
| キー | 型 / 値 | 詳細 |
|---|---|---|
USER_MESSAGE |
string |
組み込みの V2 テストクライアントフローから app-server に送信するメッセージテキストです。 |
このデバッグフローは experimentalApi: true で初期化し、スレッドを開始してターンを送信し、サーバー通知をストリーミングします。app-server のプロトコル動作をローカルで再現、調査するために使用します。
codex debug models
Codex が認識している未加工のモデルカタログを JSON として表示します。
| キー | 型 / 値 | 詳細 |
|---|---|---|
--bundled |
boolean |
更新をスキップし、現在の Codex バイナリにバンドルされたモデルカタログだけを表示します。 |
リモートのモデルエンドポイントから更新せず、現在のバイナリにバンドルされたカタログだけを調べる場合は、--bundled を使用します。
codex debug prompt-input
モデルに表示される正確なプロンプト入力リストを JSON としてレンダリングします。 指示の検出、セッションコンテキスト、プロンプトの構築をデバッグするときに使用します。
| キー | 型 / 値 | 詳細 |
|---|---|---|
--image, -i |
path[,path...] |
ユーザープロンプトに 1 つ以上の画像を添付します。複数のパスはカンマで区切るか、フラグを繰り返します。 |
PROMPT |
string |
セッションコンテキストの後に追加する任意のユーザープロンプトです。 |
codex apply
Codex クラウドチャットの最新の差分をローカルリポジトリに適用します。認証済みであり、そのチャットへのアクセス権が必要です。
| キー | 型 / 値 | 詳細 |
|---|---|---|
TASK_ID |
string |
差分を適用する Codex クラウドチャットの識別子です。 |
Codex はパッチを適用したファイルを表示し、git apply が失敗した場合（競合など）は 0 以外で終了します。
codex review
コードレビューを非インタラクティブに実行します。レビュー対象を 1 つだけ選択するか、 カスタムレビュー指示をプロンプトとして渡します。
| キー | 型 / 値 | 詳細 |
|---|---|---|
--base |
branch |
指定したベースブランチとの差分をレビューします。 |
--commit |
SHA |
指定したコミットによる変更をレビューします。 |
--strict-config |
boolean |
config.toml に、このバージョンの Codex が認識しないフィールドが含まれている場合にエラーにします。 |
--title |
string |
レビュー概要に表示するコミットタイトルを設定します。--commit が必要です。 |
--uncommitted |
boolean |
ステージ済み、未ステージ、未追跡の変更をレビューします。 |
PROMPT |
string | - (read stdin) |
カスタムレビュー指示です。stdin から指示を読み取るには - を使用します。 |
--uncommitted、--base、--commit、カスタムの PROMPT は互いに
競合します。--title は --commit とともにのみ使用してください。
codex archive と codex unarchive
保存済みのインタラクティブセッションを、セッション ID またはセッション名でアーカイブまたは復元します。 トランスクリプトを削除せずにセッション選択画面を整理する場合に、これらのコマンドを使用します。セッション ID はセッション名より優先されます。
codex archive <SESSION>
codex unarchive <SESSION>| キー | 型 / 値 | 詳細 |
|---|---|---|
--remote |
ws://host:port | wss://host:port | unix:// | unix://PATH |
アーカイブ状態を変更する前に、リモート app-server エンドポイントへ接続します。 |
--remote-auth-token-env |
ENV_VAR |
--remote で認証が必要な場合に、この環境変数からベアラートークンを読み取ります。 |
SESSION |
session ID | session name |
アーカイブまたは復元する保存済みセッションです。セッション ID はセッション名より優先されます。 |
codex delete
保存済みのインタラクティブセッションを、セッション ID またはセッション名で完全に削除します。 アクティブなセッション一覧から非表示にするのではなく、トランスクリプトを削除する場合にのみ使用してください。
codex delete <SESSION>
codex delete <SESSION_UUID> --force| キー | 型 / 値 | 詳細 |
|---|---|---|
--force |
boolean |
確認せずに削除します。セッション引数は UUID である必要があります。名前の場合は引き続き対話形式の確認が必要です。 |
--remote |
ws://host:port | wss://host:port | unix:// | unix://PATH |
セッションを削除する前に、リモート app-server エンドポイントへ接続します。 |
--remote-auth-token-env |
ENV_VAR |
--remote で認証が必要な場合に、この環境変数からベアラートークンを読み取ります。 |
SESSION |
session ID | session name |
削除する保存済みセッションです。セッション ID はセッション名より優先されます。 |
--force はセッション UUID にのみ使用してください。名前付きセッションでは引き続き
確認が必要です。これにより、Codex が重複した名前や曖昧な名前を確認なしで削除することを防ぎます。
codex cloud
ターミナルから Codex クラウドチャットを操作します。デフォルトのコマンドではインタラクティブな選択画面が開きます。codex cloud exec はタスクを直接送信し、codex cloud list はスクリプト処理や簡単な確認のために最近のチャットを返します。
| キー | 型 / 値 | 詳細 |
|---|---|---|
--attempts |
1-4 |
Codex クラウドが実行するアシスタントの試行回数（best-of-N）です。 |
--env |
ENV_ID |
対象となる Codex クラウド環境の識別子です（必須）。選択肢を一覧表示するには codex cloud を使用します。 |
QUERY |
string |
タスクのプロンプトです。省略すると、Codex が詳細を対話形式で確認します。 |
認証にはメイン CLI と同じ認証情報が使用されます。タスクの送信に失敗すると、Codex は 0 以外で終了します。
codex cloud list
最近のクラウドチャットを、任意のフィルタリングとページネーションを使用して一覧表示します。
| キー | 型 / 値 | 詳細 |
|---|---|---|
--cursor |
string |
前回のリクエストで返されたページネーションカーソルです。 |
--env |
ENV_ID |
環境識別子でタスクを絞り込みます。 |
--json |
boolean |
プレーンテキストの代わりに機械可読の JSON を出力します。 |
--limit |
1-20 |
返すタスクの最大数です。 |
プレーンテキスト出力では、タスク 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"）。
| キー | 型 / 値 | 詳細 |
|---|---|---|
SHELL |
bash | zsh | fish | power-shell | elvish |
補完を生成するシェルです。出力は stdout に表示されます。 |
codex doctor
サポートへの問い合わせを提出する前、または Codex のインストール不良を 調査するときに、ローカル診断レポートを生成します。レポートでは、インストール、 設定、認証、ランタイム、Git、ターミナル、app-server、スレッド 一覧の健全性を確認します。
| キー | 型 / 値 | 詳細 |
|---|---|---|
--all |
boolean |
詳細な人間可読レポート内の長い一覧を展開します。 |
--ascii |
boolean |
人間可読の出力で ASCII のステータスラベルと区切り文字を使用します。 |
--json |
boolean |
機密情報を削除した機械可読のサポートレポートを出力します。 |
--no-color |
boolean |
人間可読の出力で ANSI カラーを無効にします。 |
--summary |
boolean |
グループ化されたチェック行と最後の件数概要だけを表示します。 |
codex features
$CODEX_HOME/config.toml に保存されている機能フラグを管理します。enable と
disable コマンドは変更を永続化するため、以後のセッションにも適用されます。
features サブコマンドは --profile を受け付けません。
| キー | 型 / 値 | 詳細 |
|---|---|---|
Disable subcommand |
codex features disable <feature> |
$CODEX_HOME/config.toml で機能フラグを永続的に無効化します。 |
Enable subcommand |
codex features enable <feature> |
$CODEX_HOME/config.toml で機能フラグを永続的に有効化します。 |
List subcommand |
codex features list |
既知の機能フラグ、その成熟段階、有効な状態を表示します。 |
codex exec
人の操作なしで完了させるスクリプト実行や CI 形式の実行には、codex exec（または短縮形の codex e）を使用します。
| キー | 型 / 値 | 詳細 |
|---|---|---|
--cd, -C |
path |
タスクの実行前にワークスペースのルートを設定します。 |
--color |
always | never | auto |
stdout の ANSI カラーを制御します。 |
--dangerously-bypass-approvals-and-sandbox, --yolo |
boolean |
承認プロンプトとサンドボックスを迂回します。危険なため、隔離されたランナー内でのみ使用してください。 |
--dangerously-bypass-hook-trust |
boolean |
この呼び出しでは、永続化されたフックの信頼を要求せず、有効なフックを実行します。フックのソースを事前に検証する自動化専用です。 |
--ephemeral |
boolean |
セッションのロールアウトファイルをディスクに永続化せずに実行します。 |
--full-auto |
boolean |
互換性のための非推奨フラグです。--sandbox workspace-write を使用してください。このフラグを使用すると Codex が警告を表示します。 |
--ignore-rules |
boolean |
この実行では、ユーザーまたはプロジェクトの execpolicy .rules ファイルを読み込みません。 |
--ignore-user-config |
boolean |
$CODEX_HOME/config.toml を読み込みません。認証では引き続き CODEX_HOME が使用されます。 |
--image, -i |
path[,path...] |
最初のメッセージに画像を添付します。繰り返し指定でき、カンマ区切りの一覧にも対応します。 |
--json, --experimental-json |
boolean |
整形済みテキストの代わりに、改行区切りの JSON イベントを表示します。 |
--local-provider |
lmstudio | ollama |
--oss とともに使用するローカルプロバイダーを選択し、この実行では oss_provider をオーバーライドします。 |
--model, -m |
string |
この実行で設定済みのモデルをオーバーライドします。 |
--oss |
boolean |
ローカルのオープンソースプロバイダーを使用します。Codex は --local-provider または設定済みの oss_provider を使用し、どちらも設定されていない場合はエラーで終了します。 |
--output-last-message, -o |
path |
アシスタントの最終メッセージをファイルに書き込みます。後続のスクリプト処理に役立ちます。 |
--output-schema |
path |
期待する最終レスポンスの形式を記述する JSON Schema ファイルです。Codex はツール出力をこのスキーマに照らして検証します。 |
--profile, -p |
string |
ベースとなるユーザー設定の上に $CODEX_HOME/profile-name.config.toml を重ねて適用します。 |
--sandbox, -s |
read-only | workspace-write | danger-full-access |
モデルが生成したコマンドのサンドボックスポリシーです。デフォルトは設定値です。 |
--skip-git-repo-check |
boolean |
Git リポジトリ外での実行を許可します（単発作業用のディレクトリに便利です）。 |
-c, --config |
key=value |
非インタラクティブ実行向けのインライン設定オーバーライドです（繰り返し指定できます）。 |
PROMPT |
string | - (read stdin) |
タスクの初期指示です。stdin からプロンプトをパイプするには - を使用します。 |
Resume subcommand |
codex exec resume [SESSION_ID] |
exec セッションを ID で再開します。または --last を追加し、現在の作業ディレクトリで最新のセッションを続行します。任意のディレクトリのセッションも対象にするには --all を追加します。任意のフォローアッププロンプトを指定できます。 |
Codex はデフォルトで整形済みの出力を書き込みます。改行区切りの JSON イベント（状態変更ごとに 1 件）を受け取るには、--json を追加します。任意の resume サブコマンドを使用すると、非インタラクティブタスクを続行できます。現在の作業ディレクトリから最新のセッションを選択するには --last、すべてのセッションを検索するには --all を追加します。
| キー | 型 / 値 | 詳細 |
|---|---|---|
--all |
boolean |
最新のセッションを選択するとき、現在の作業ディレクトリ外にあるセッションも含めます。 |
--image, -i |
path[,path...] |
フォローアッププロンプトに 1 つ以上の画像を添付します。複数のパスはカンマで区切るか、フラグを繰り返します。 |
--last |
boolean |
現在の作業ディレクトリから最新のチャットを再開します。 |
PROMPT |
string | - (read stdin) |
再開直後に送信する任意のフォローアップ指示です。 |
SESSION_ID |
uuid | session name |
指定したセッションを再開します。省略して --last を使用すると、最新のセッションを続行します。 |
codex execpolicy
execpolicy ルールファイルを保存する前に確認します。codex execpolicy check は 1 つ以上の --rules フラグ（例: ~/.codex/rules 配下のファイル）を受け取り、最も厳しい判定と一致したルールを示す JSON を出力します。出力を整形するには --pretty を追加します。execpolicy コマンドは現在プレビュー段階です。
| キー | 型 / 値 | 詳細 |
|---|---|---|
--pretty |
boolean |
JSON の結果を読みやすく整形します。 |
--rules, -r |
path (repeatable) |
評価する execpolicy ルールファイルのパスです。複数のファイルのルールを組み合わせるには、フラグを複数指定します。 |
COMMAND... |
var-args |
指定したポリシーに照らして確認するコマンドです。 |
codex login
ChatGPT アカウント、API key、またはアクセストークンで CLI を認証します。フラグを指定しない場合、Codex は ChatGPT OAuth フロー用のブラウザーを開きます。
| キー | 型 / 値 | 詳細 |
|---|---|---|
--device-auth |
boolean |
ブラウザーウィンドウを起動せず、OAuth デバイスコードフローを使用します。 |
--with-access-token |
boolean |
stdin からアクセストークンを読み取ります（例: printenv CODEX_ACCESS_TOKEN | codex login --with-access-token）。 |
--with-api-key |
boolean |
stdin から API key を読み取ります（例: printenv OPENAI_API_KEY | codex login --with-api-key）。 |
status subcommand |
codex login status |
現在の認証モードを表示し、ログイン済みの場合は 0 で終了します。 |
認証情報が存在する場合、codex login status は 0 で終了するため、自動化スクリプトで役立ちます。
codex logout
API key と ChatGPT 認証の両方について、保存済みの認証情報を削除します。このコマンドにフラグはありません。
codex mcp
~/.codex/config.toml に保存された Model Context Protocol サーバーのエントリを管理します。
| キー | 型 / 値 | 詳細 |
|---|---|---|
add <name> |
-- <command...> | --url <value> |
stdio ランチャーコマンドまたはストリーミング対応 HTTP URL を使用してサーバーを登録します。stdio トランスポートでは --env KEY=VALUE をサポートします。 |
get <name> |
--json |
特定のサーバー設定を表示します。--json は未加工の設定エントリを表示します。 |
list |
--json |
設定済みの MCP serverを一覧表示します。機械可読の出力にするには --json を追加します。 |
login <name> |
--scopes scope1,scope2 |
ストリーミング対応 HTTP サーバーの OAuth ログインを開始します（OAuth をサポートするサーバーのみ）。 |
logout <name> |
ストリーミング対応 HTTP サーバーについて保存された OAuth 認証情報を削除します。 | |
remove <name> |
保存済みの MCP server定義を削除します。 |
add サブコマンドは、stdio とストリーミング対応 HTTP の両方のトランスポートをサポートします。
| キー | 型 / 値 | 詳細 |
|---|---|---|
--bearer-token-env-var |
ENV_VAR |
ストリーミング対応 HTTP サーバーへの接続時に、値をベアラートークンとして送信する環境変数です。 |
--env KEY=VALUE |
repeatable |
stdio サーバーの起動時に適用する環境変数の割り当てです。 |
--oauth-client-id |
CLIENT_ID |
ストリーミング対応 HTTP MCP serverの OAuth クライアント識別子です。--url が必要です。 |
--oauth-resource |
RESOURCE |
ストリーミング対応 HTTP MCP serverへのログイン時に含める OAuth リソースパラメーターです。--url が必要です。 |
--url |
https://… |
stdio の代わりにストリーミング対応 HTTP サーバーを登録します。COMMAND... とは同時に使用できません。 |
COMMAND... |
stdio transport |
MCP serverを起動する実行可能ファイルと引数です。-- の後に指定します。 |
OAuth アクション（login、logout）は、ストリーミング対応 HTTP サーバーでのみ（かつサーバーが OAuth をサポートする場合にのみ）機能します。
codex plugin
設定済みのマーケットプレイスからプラグインをインストール、一覧表示、削除します。
| キー | 型 / 値 | 詳細 |
|---|---|---|
add <plugin[@marketplace]> |
[--marketplace, -m NAME] [--json] |
設定済みのマーケットプレイスからプラグインをインストールします。プラグイン引数に @marketplace がない場合は、--marketplace または -m を使用します。 |
list |
[--marketplace, -m NAME] [--available --json] [--json] |
インストール済みのプラグインを一覧表示します。--json を指定すると、出力には installed 配列と available 配列が含まれます。--available は未インストールのマーケットプレイスプラグインも含めるもので、--json が必要です。 |
marketplace |
設定済みのマーケットプレイスソースを管理します。以下の codex plugin marketplace を参照してください。 |
|
remove <plugin[@marketplace]> |
[--marketplace, -m NAME] [--json] |
インストール済みのプラグインをローカル設定とキャッシュから削除します。自動化しやすい出力には --json を使用します。 |
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 が参照してインストール元として使用できるプラグインマーケットプレイスのソースを管理します。
| キー | 型 / 値 | 詳細 |
|---|---|---|
add <source> |
[--ref REF] [--sparse PATH] [--json] |
GitHub 短縮表記、Git URL、SSH URL、またはローカルのマーケットプレイスルートディレクトリからプラグインマーケットプレイスをインストールします。--sparse は Git ソースでのみサポートされ、繰り返し指定できます。 |
list |
[--json] |
Codex が現在対象としているプラグインマーケットプレイスと、各マーケットプレイスのルートパスを表示します。 |
remove <marketplace-name> |
[--json] |
設定済みのプラグインマーケットプレイスを削除します。 |
upgrade [marketplace-name] |
[--json] |
設定済みの Git マーケットプレイスを 1 つ更新します。名前を指定しない場合は、設定済みのすべての Git マーケットプレイスを更新します。 |
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 で続行するか、最新のチャットを再開します。--all を渡さない限り、codex resume は --last の対象を現在の作業ディレクトリに限定します。モデルやサンドボックスのオーバーライドを含め、codex と同じグローバルフラグを受け付けます。
現在の作業ディレクトリがセッションの保存済みディレクトリと異なる場合、
Codex はどちらのディレクトリを使用するか確認します。この選択を確認なしで再利用するには、
tui.resume_cwd を "current" または
"session" に設定します。明示的な --cd（-C）の
オーバーライドは、tui.resume_cwd より優先されます。
| キー | 型 / 値 | 詳細 |
|---|---|---|
--all |
boolean |
最新のセッションを選択するとき、現在の作業ディレクトリ外にあるセッションも含めます。 |
--include-non-interactive |
boolean |
選択画面および --last の選択対象に、非インタラクティブセッションを含めます。 |
--last |
boolean |
選択画面をスキップし、現在の作業ディレクトリから最新のチャットを再開します。 |
SESSION_ID |
uuid | session name |
指定したセッションを再開します。省略して --last を使用すると、最新のセッションを続行します。 |
codex fork
以前のインタラクティブセッションを新しいチャットにフォークします。デフォルトでは、codex fork によってセッション選択画面が開きます。代わりに最新のセッションをフォークするには --last を追加します。
現在のセッションディレクトリと保存済みセッションのディレクトリが異なる場合、codex fork は
codex resume と同じ作業ディレクトリの確認と tui.resume_cwd 設定を使用します。
| キー | 型 / 値 | 詳細 |
|---|---|---|
--all |
boolean |
選択画面に、現在の作業ディレクトリ外のセッションも表示します。 |
--last |
boolean |
選択画面をスキップし、最新のチャットを自動的にフォークします。 |
SESSION_ID |
uuid |
指定したセッションをフォークします。省略して --last を使用すると、最新のセッションをフォークします。 |
codex sandbox
Codex が内部で使用するものと同じポリシーの下でコマンドを実行するには、サンドボックスヘルパーを使用します。
macOS seatbelt
| キー | 型 / 値 | 詳細 |
|---|---|---|
--allow-unix-socket |
path |
サンドボックス化されたコマンドが、このパスをルートとする Unix ソケットをバインドまたは接続することを許可します。複数のパスを許可するには繰り返し指定します。 |
--cd, -C |
DIR |
プロファイルの解決とコマンドの実行に使用する作業ディレクトリです。--permission-profile が必要です。 |
--config, -c |
key=value |
設定のオーバーライドをサンドボックス実行に渡します（繰り返し指定できます）。 |
--include-managed-config |
boolean |
明示的な権限プロファイルを解決するときに、管理対象の要件を含めます。--permission-profile が必要です。 |
--log-denials |
boolean |
コマンドの実行中に log stream で macOS サンドボックスの拒否を記録し、終了後に表示します。 |
--permission-profile, -P |
NAME |
有効な設定スタックから、名前付きの権限プロファイルを適用します。 |
--profile, -p |
NAME |
ベースとなるユーザー設定の上に $CODEX_HOME/NAME.config.toml を重ねて適用します。 |
COMMAND... |
var-args |
macOS Seatbelt の下で実行するシェルコマンドです。-- より後のすべての内容が転送されます。 |
Linux Landlock
| キー | 型 / 値 | 詳細 |
|---|---|---|
--cd, -C |
DIR |
プロファイルの解決とコマンドの実行に使用する作業ディレクトリです。--permission-profile が必要です。 |
--config, -c |
key=value |
サンドボックスを起動する前に適用する設定のオーバーライドです（繰り返し指定できます）。 |
--include-managed-config |
boolean |
明示的な権限プロファイルを解決するときに、管理対象の要件を含めます。--permission-profile が必要です。 |
--permission-profile, -P |
NAME |
有効な設定スタックから、名前付きの権限プロファイルを適用します。 |
--profile, -p |
NAME |
ベースとなるユーザー設定の上に $CODEX_HOME/NAME.config.toml を重ねて適用します。 |
COMMAND... |
var-args |
Landlock + seccomp の下で実行するコマンドです。-- の後に実行可能ファイルを指定します。 |
Windows
| キー | 型 / 値 | 詳細 |
|---|---|---|
--cd, -C |
DIR |
プロファイルの解決とコマンドの実行に使用する作業ディレクトリです。--permission-profile が必要です。 |
--config, -c |
key=value |
サンドボックスを起動する前に適用する設定のオーバーライドです（繰り返し指定できます）。 |
--include-managed-config |
boolean |
明示的な権限プロファイルを解決するときに、管理対象の要件を含めます。--permission-profile が必要です。 |
--permission-profile, -P |
NAME |
有効な設定スタックから、名前付きの権限プロファイルを適用します。 |
--profile, -p |
NAME |
ベースとなるユーザー設定の上に $CODEX_HOME/NAME.config.toml を重ねて適用します。 |
COMMAND... |
var-args |
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 を押します。
- 完了した最新の Codex 出力をコピーするには、Ctrl+O を押すか、
/copyを実行します。 - 現在の承認およびサンドボックス設定でローカルシェルコマンドを実行するには、行の先頭に
!を付けます。 - Codex の処理中に Tab を押すと、次のターンに向けてフォローアッププロンプト、スラッシュコマンド、シェルコマンドをキューに追加できます。
- Codex の処理中に Enter を押すと、現在のターンに新しい指示を挿入できます。
- コンポーザーが空の状態で Esc を 2 回押すと、前のユーザーメッセージを編集し、その時点からチャットをフォークできます。
- セッションを閉じるには、Ctrl+C を押すか、
/exitを実行します。
関連リソース
- Codex CLI の概要: インストール、アップグレード、クイックヒント。
- 設定の基本: モデルやプロバイダーなどのデフォルト値を永続化します。
- 高度な設定: プロファイル、プロバイダー、サンドボックスの調整、統合。
- AGENTS.md: Codex エージェントの機能とベストプラクティスの概念的な概要。
スラッシュコマンドを使うと、キーボード中心の操作で Codex をすばやく制御できます。コンポーザーに
/ と入力してスラッシュポップアップを開き、コマンドを選択すると、ターミナルを離れることなく
モデルの切り替え、権限の調整、長いチャットの要約などの操作を Codex が実行します。
このガイドでは、次の方法を説明します。
- タスクに適した組み込みスラッシュコマンドを見つける
/model、/fast、/personality、/permissions、/approve、/raw、/agent、/statusなどのコマンドでアクティブなセッションを制御する
Codex CLI のスラッシュコマンド
組み込みスラッシュコマンド
Codex には次のコマンドが付属しています。スラッシュポップアップを開き、 コマンド名を入力し始めると一覧を絞り込めます。
チャットの実行中でも、スラッシュコマンドを入力して Tab を押すと、
次のターンのキューに追加できます。Codex はキュー内のスラッシュコマンドを実行時に解析するため、
コマンドメニューやエラーは現在のターンの完了後に表示されます。スラッシュコマンドを
キューに追加する前であれば、引き続き補完を利用できます。
| コマンド | 目的 | 使用する場面 |
|---|---|---|
/permissions |
Codex が事前確認なしで実行できる操作を設定します。 | セッションの途中で Auto と Read Only を切り替える場合など、承認要件を緩和または厳格化するときに使用します。 |
/ide |
開いているファイル、現在の選択範囲、その他の IDE コンテキストを含めます。 | IDE で何を開いているかを改めて説明せず、エディターのコンテキストを次のプロンプトに取り込むときに使用します。 |
/keymap |
TUI のキーボードショートカットを再割り当てします。 | config.toml のカスタムショートカット割り当てを確認し、永続化するときに使用します。 |
/vim |
コンポーザーの Vim モードを切り替えます。 | Vim のノーマル／挿入モードと、デフォルトのコンポーザー編集モードを切り替えるときに使用します。 |
/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 diff を表示します。 | コミットまたはテスト実行の前に、Codex による編集を確認するときに使用します。 |
/exit |
CLI を終了します（/quit と同じです）。 |
別表記です。どちらのコマンドでもセッションを終了できます。 |
/experimental |
実験的機能を切り替えます。 | Network proxy や Prevent sleep while running などのオプションを有効にするときに使用します。 |
/approve |
最近の自動レビューによる拒否について、1 回の再試行を承認します。 | 自動レビュアーが拒否したコマンドまたはアクションを再試行するときに使用します。 |
/memories |
メモリの使用と生成を設定します。 | TUI から離れず、メモリの注入または生成をオン／オフするときに使用します。 |
/skills |
スキルを参照して使用します。 | 関連するローカルスキルを選択し、タスク固有の動作を改善するときに使用します。 |
/import |
Claude Code または Cursor のセットアップ、プロジェクト、チャットをインポートします。 | 対応している外部エージェントの成果物を Codex の設定とローカルファイルへ移行するときに使用します。 |
/feedback |
Codex のメンテナーにログを送信します。 | 問題を報告したり、診断情報をサポートと共有したりするときに使用します。 |
/init |
現在のディレクトリに AGENTS.md のひな形を生成します。 |
作業中のリポジトリまたはサブディレクトリ向けの永続的な指示を記録するときに使用します。 |
/logout |
Codex からサインアウトします。 | 共有マシンを使用している場合にローカル認証情報を消去するときに使用します。 |
/mcp |
設定済みの Model Context Protocol (MCP) ツールを一覧表示します。 | セッション中に Codex が呼び出せる外部ツールを確認するときに使用します。サーバーの詳細を表示するには verbose を追加します。 |
/mention |
チャットにファイルを添付します。 | 次に Codex に確認させたい特定のファイルまたはフォルダーを指定するときに使用します。 |
/model |
アクティブなモデル（利用可能な場合は推論エフォートも）を選択します。 | タスクの実行前に gpt-5.6-luna や gpt-5.6-terra などのモデルを切り替えるときに使用します。 |
/fast |
モデルカタログで提供されている場合、Fast サービス階層を切り替えます。 | 現在のモデルの Fast 階層をオン／オフし、その選択を永続化するときに使用します。 |
/plan |
計画モードに切り替え、必要に応じてプロンプトを送信します。 | 実装作業を始める前に、Codex に実行計画の提案を依頼するときに使用します。 |
/goal |
タスク目標を設定、編集、一時停止、再開、表示、消去します。 | 大規模なタスクの実行中に追跡する永続的な目標を Codex に与えるときに使用します。 |
/personality |
応答のコミュニケーションスタイルを選択します。 | 指示を変更せず、Codex の応答をより簡潔、詳しい説明付き、または協調的にするときに使用します。 |
/ps |
バックグラウンドターミナルと最近の出力を表示します。 | メインのトランスクリプトから離れず、長時間実行中のコマンドを確認するときに使用します。 |
/stop |
すべてのバックグラウンドターミナルを停止します。 | 現在のセッションが開始したバックグラウンドのターミナル作業をキャンセルするときに使用します。 |
/fork |
現在のチャットを新しいチャットへフォークします。 | 現在のトランスクリプトを失わず、アクティブなセッションから分岐して別のアプローチを検討するときに使用します。 |
/app |
ChatGPT デスクトップアプリで現在のセッションを続行します。 | macOS または Windows で TUI からデスクトップアプリへ移行するときに使用します。 |
/side, /btw |
一時的なサイドチャットを開始します。 | メインチャットのトランスクリプトを妨げず、焦点を絞った追加質問をするときに使用します。 |
/raw |
raw スクロールバックモードを切り替えます。 | 長い出力を確認する際、ターミナルでの選択とコピーの書式を簡素化するときに使用します。 |
/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 を終了します。重要な作業を保存または
コミットした後にのみ使用してください。
Codex が事前確認なしで実行できる操作を調整するには、/permissions を使用します。自動レビューで
最近拒否されたアクションを再試行する必要がある場合に限り、/approve を使用してください。
スラッシュコマンドでセッションを制御する
以下のワークフローを使用すると、Codex を再起動せずにセッションを順調に進められます。
/model でアクティブなモデルを設定する
- Codex を起動し、コンポーザーを開きます。
/modelと入力して Enter キーを押します。- ポップアップから
gpt-5.6-lunaやgpt-5.6-terraなどのモデルを選択します。
期待される結果：Codex がトランスクリプト内で新しいモデルを確認します。変更を検証するには /status を実行します。
/fast で Fast モードを切り替える
/fastと入力し、現在のモデルの Fast サービス階層をオンにします。- もう一度
/fastと入力してオフにします。
期待される結果：Codex が階層を切り替え、選択内容を保存します。TUI のフッターには、
/statusline を使用して Fast モードのステータスライン項目を表示することもできます。
Fast 階層のコマンドはカタログに基づきます。現在のモデルが Fast 階層を提供していない
場合、Codex は /fast を表示しません。
/personality でコミュニケーションスタイルを設定する
プロンプトを書き直さずに Codex のコミュニケーション方法を変更するには、/personality を使用します。
- アクティブなチャットで
/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 が機能の選択内容を設定に保存し、再起動後に適用します。
/approve で自動レビューによる拒否を承認する
自動レビュアーが最近のアクションを拒否し、そのアクションを Codex に 1 回再試行させる場合は、
/approve を使用します。
/approveと入力します。- Codex に該当する拒否済みアクションが表示されたら、再試行を確認します。
期待される結果：Codex が現在のセッション ポリシーに従って、その拒否済みアクションを 1 回再試行します。
/memories でメモリを設定する
/memoriesと入力します。- Codex が既存のメモリを使用するか、新しいメモリを生成するか、または メモリ機能を無効のままにするかを選択します。
期待される結果：Codex が今後のセッションに適用されるメモリ設定を更新します。
/skills でスキルを使用する
/skillsと入力します。- Codex に適用させるスキルを選択します。
期待される結果：Codex が選択したスキルのコンテキストを挿入し、次のリクエストが そのスキルの指示に従うようにします。
/import で Claude Code または Cursor のセットアップをインポートする
/importと入力します。- Claude Code または Cursor を選択します。
- 移行するセットアップ、プロジェクトファイル、または最近のチャットを選択します。
期待される結果：Codex が外部エージェントのインポートピッカーを開き、選択した 対応済みの成果物を Codex の設定とローカルファイルにインポートします。セッションの検出対象には、 過去 30 日間のチャットが最大 50 件含まれます。
ローカルの TUI セッションから /import を実行します。タスクの実行中、
リモートセッション、およびローカルの app-server デーモンへの接続中は使用できません。
デスクトップアプリでのワークフローと対応している成果物の種類については、別のエージェントから インポートするを参照してください。
/clear でターミナルをクリアして新しいチャットを開始する
/clearと入力して Enter キーを押します。
期待される結果：Codex がターミナルをクリアし、表示中のトランスクリプトをリセットして、 同じ CLI セッションで新しいチャットを開始します。
新しいチャットの作成時に名前を付けるには、/clear release prep を実行します。
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と入力します。- Codex に現在の IDE の選択範囲や開いているファイルをどのように扱ってほしいか説明する場合は、 任意のインラインテキストを追加します。
期待される結果：Codex が利用可能な IDE コンテキストを次のプロンプトに含めます。
/vim で Vim モードを切り替える
/vimと入力します。- コンポーザーで編集を続けます。
期待される結果：Codex が現在のセッションのコンポーザー 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 スクロールバックを切り替える
/raw、/raw on、または/raw offと入力します。
期待される結果：Codex が raw スクロールバックモードを切り替え、ターミナル上での選択と
コピーをより直接的に行えるようにします。デフォルトの 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 で設定レイヤーを確認する
/debug-configと入力します。- 設定レイヤーの順序（優先度が低いものから）、オン／オフの 状態、およびポリシーのソースを出力で確認します。
期待される結果：Codex がレイヤーの診断情報に加え、設定されている場合は
allowed_approval_policies、allowed_sandbox_modes、mcp_servers、rules、
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 のショートカットを再割り当てする
TUI のキーボードショートカット割り当てを確認、更新、永続化するには、/keymap を使用します。
/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 セッション内で新しいチャットを開始するため、 ターミナルを終了せずにチャットを切り替えられます。
新しいチャットの作成時に名前を付けるには、/new bug bash を実行します。
/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 serverとツールを把握します。
期待される結果：このセッションで Codex が呼び出せる、設定済みの Model Context Protocol (MCP) ツールが表示されます。
サーバーの詳細な診断情報を含めるには、/mcp verbose を使用します。verbose 以外の引数を渡すと、Codex はコマンドの使用方法を表示します。
/apps でアプリを参照する
/appsと入力します。- 一覧からアプリを選択します。
期待される結果：Codex がアプリへのメンションを $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 が直ちに終了します。先に重要な作業を保存またはコミットしてください。
IDE 拡張機能のコマンド
以下のコマンドを使用して、VS Code の Command Palette から Codex を操作します。キーボードショートカットに割り当てることもできます。
キーバインドを割り当てる
Codex コマンドのキーバインドを割り当てる、または変更するには、次の手順に従います。
- Command Palette を開きます（macOS では Cmd+Shift+P、Windows/Linux では Ctrl+Shift+P）。
- Preferences: Open Keyboard Shortcuts を実行します。
Codexまたはコマンド ID（例：chatgpt.newChat）を検索します。- 鉛筆アイコンを選択し、使用するショートカットを入力します。
拡張機能のコマンド
| コマンド | デフォルトのキーバインド | 説明 |
|---|---|---|
chatgpt.addToThread |
- | 選択したテキスト範囲を現在のチャットのコンテキストとして追加します |
chatgpt.addFileToThread |
- | ファイル全体を現在のチャットのコンテキストとして追加します |
chatgpt.newChat |
macOS: Cmd+N Windows/Linux: Ctrl+N |
新しいチャットを作成します |
chatgpt.newCodexPanel |
- | 新しい Codex パネルを作成します |
chatgpt.openCommandMenu |
- | Codex のコマンドメニューを開きます |
chatgpt.openSidebar |
- | Codex のサイドバーパネルを開きます |
IDE 拡張機能のスラッシュコマンド
スラッシュコマンドを使用すると、コンポーザーから離れずに Codex を操作できます。ステータスの確認、ローカルモードとクラウドモードの切り替え、フィードバックの送信に使用できます。
スラッシュコマンドを使用する
- Codex のコンポーザーで
/と入力します。 - 一覧からコマンドを選択するか、さらに入力して絞り込みます（例：
/status）。 - Enter キーを押します。
使用可能なスラッシュコマンド
| スラッシュコマンド | 説明 |
|---|---|
/approve |
自動レビューが有効な場合に、最近の自動レビューによる拒否について 1 回の再試行を承認します。 |
/cloud |
クラウド実行が利用可能な場合に、クラウドでチャットを実行します。 |
/cloud-environment |
チャットに使用するクラウド環境を選択します。 |
/compact |
現在のチャットのコンテキストを圧縮します。 |
/fast |
カタログで提供される Fast サービス階層が利用可能な場合に、オン／オフを切り替えます。 |
/feedback |
フィードバックダイアログを開き、必要に応じてログを含めてフィードバックを送信します。 |
/fork |
ローカルチャットを新しいローカルチャットへコピーします。 |
/goal |
Codex が取り組む永続的な目標を設定します。 |
/ide-context |
IDE コンテキストの自動取り込みをオン／オフします。 |
/init |
現在のプロジェクトに AGENTS.md のひな形を生成します。 |
/local |
ローカルワークスペースでチャットを実行します。 |
/mcp |
MCP のステータスを開き、接続済みのサーバーを表示します。 |
/memories |
Memories が利用可能な場合に、チャットがメモリを使用または生成できるかどうかを設定します。 |
/model |
現在のチャットに使用するモデルを選択します。 |
/personality |
現在のモデルがパーソナリティをサポートしている場合に、Codex の応答方法を選択します。 |
/plan |
複数ステップの計画に使用する計画モードを切り替えます。 |
/project |
新しいチャットに使用するプロジェクトを選択します。 |
/reasoning |
現在のチャットに使用する推論エフォートを選択します。 |
/review |
コードレビューモードを開始し、未コミットの変更をレビューするか、ベースブランチと比較します。 |
/side |
メインチャットを中断せず、一時的なサイドチャットを開始します。 |
/status |
チャット ID、コンテキスト使用量、レート制限を表示します。 |
/worktree |
新しい Git ワークツリーでチャットを実行します。 |