開発者向けコマンド
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 コマンドとフラグを一覧にしています。インタラクティブな表を使用して、キーまたは説明で検索できます。各セクションには、オプションが安定版か実験的機能かが示され、リスクのある組み合わせも明記されています。
グローバルフラグ
| キー | 型／値 | 詳細 |
|---|---|---|
--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 |
この環境変数から bearer token を読み取り、--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 が表示します。 |
codex app-server |
Experimental | ローカルでの開発やデバッグ用に、stdio、WebSocket、または Unix ソケットを介して Codex app server を起動します。 |
codex apply |
Stable | Codex cloud チャットが生成した最新の差分をローカルのワーキングツリーに適用します。エイリアス：codex a。 |
codex archive |
Stable | 保存済みの対話型セッションを、セッション ID またはセッション名でアーカイブします。 |
codex cloud |
Experimental | TUI を開かずに、ターミナルから Codex cloud チャットを閲覧または実行します。エイリアス：codex cloud-tasks。 |
codex completion |
Stable | Bash、Zsh、Fish、または PowerShell 用のシェル補完スクリプトを生成します。 |
codex debug app-server send-message-v2 |
Experimental | 組み込みテストクライアントから単一の V2 メッセージを送信して、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 |
Stable | Codex 自体を stdio 経由の MCP サーバーとして実行します。別のエージェントが 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 認証に bearer token が必要なサーバーでは、--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 |
署名済み bearer token に期待される aud claim です。--ws-auth signed-bearer-token が必要です。 |
--ws-auth |
capability-token | signed-bearer-token |
app-server WebSocket クライアントの認証モードです。省略すると WebSocket 認証は無効になり、ローカル以外のリスナーについて起動時に警告が表示されます。 |
--ws-issuer |
string |
署名済み bearer token に期待される iss claim です。--ws-auth signed-bearer-token が必要です。 |
--ws-max-clock-skew-seconds |
number |
署名済み bearer token の exp および nbf claim を検証するときに許容するクロックスキューです。--ws-auth signed-bearer-token が必要です。 |
--ws-shared-secret-file |
absolute path |
署名済み JWT bearer token の検証に使用する HMAC 共有シークレットを格納したファイルです。--ws-auth signed-bearer-token とともに指定する必要があります。 |
--ws-token-file |
absolute path |
共有 capability token を格納したファイルです。代わりに --ws-token-sha256 を指定しない限り、--ws-auth capability-token とともに使用します。 |
--ws-token-sha256 |
hexadecimal SHA-256 digest |
capability-token 認証で期待される 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 では、開く パスを Codex が表示します。
| キー | 型／値 | 詳細 |
|---|---|---|
--download-url |
url |
インストール時に使用する ChatGPT デスクトップアプリのインストーラー URL を上書きする高度なオプションです。 |
PATH |
path |
ChatGPT デスクトップアプリのワークスペースパスです。macOS では Codex がこのパスを開き、Windows では Codex がパスを表示します。 |
codex app は、インストール済みの ChatGPT デスクトップアプリを開きます。アプリが
見つからない場合はインストーラーを起動します。macOS では、Codex が指定されたワークスペースパスを開きます。
Windows では、インストール後に開くパスを表示します。
codex debug app-server send-message-v2
組み込みの app-server テストクライアントを使用し、app-server の V2 thread/turn フローを通じて1件のメッセージを送信します。
| キー | 型／値 | 詳細 |
|---|---|---|
USER_MESSAGE |
string |
組み込みの V2 テストクライアントフローを通じて app-server に送信するメッセージテキストです。 |
このデバッグフローは experimentalApi: true で初期化し、スレッドを開始してターンを送信し、サーバー通知をストリーミングします。app-server プロトコルの動作をローカルで再現して調査するために使用します。
codex debug models
Codex から見える未加工のモデルカタログを JSON として出力します。
| キー | 型／値 | 詳細 |
|---|---|---|
--bundled |
boolean |
更新をスキップし、現在の Codex バイナリにバンドルされているモデルカタログのみを出力します。 |
リモートの models エンドポイントから更新せず、現在のバイナリにバンドルされているカタログだけを調べる場合は、--bundled を使用します。
codex debug prompt-input
モデルに表示される正確なプロンプト入力リストを JSON としてレンダリングします。 指示の検出、セッションコンテキスト、またはプロンプトの構築をデバッグするときに使用します。
| キー | 型／値 | 詳細 |
|---|---|---|
--image, -i |
path[,path...] |
ユーザープロンプトに1つ以上の画像を添付します。複数のパスはカンマで区切るか、フラグを繰り返します。 |
PROMPT |
string |
セッションコンテキストの後に追加する、省略可能なユーザープロンプトです。 |
codex apply
Codex cloud チャットの最新の差分をローカルリポジトリに適用します。認証済みで、チャットへのアクセス権が必要です。
| キー | 型／値 | 詳細 |
|---|---|---|
TASK_ID |
string |
差分を適用する Codex cloud チャットの識別子です。 |
Codex はパッチを適用したファイルを表示し、git apply が失敗した場合（競合など）はゼロ以外の終了コードで終了します。
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 に認証が必要な場合、この環境変数から bearer token を読み取ります。 |
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 に認証が必要な場合、この環境変数から bearer token を読み取ります。 |
SESSION |
session ID | session name |
削除する保存済みセッションです。セッション ID はセッション名より優先されます。 |
--force はセッション UUID に対してのみ使用してください。名前付きセッションでは、
重複または曖昧な名前を Codex が確認なしに削除しないよう、引き続き
確認が必要です。
codex cloud
ターミナルから Codex cloud チャットを操作します。デフォルトのコマンドでは対話型の選択画面が開きます。codex cloud exec はタスクを直接送信し、codex cloud list はスクリプト処理や簡単な確認用に最近のチャットを返します。
| キー | 型／値 | 詳細 |
|---|---|---|
--attempts |
1-4 |
Codex cloud が実行するアシスタント試行回数（best-of-N）です。 |
--env |
ENV_ID |
対象の Codex cloud 環境識別子です（必須）。選択肢を一覧表示するには、codex cloud を使用します。 |
QUERY |
string |
タスクプロンプトです。省略すると、Codex が対話的に詳細の入力を求めます。 |
認証にはメイン CLI と同じ認証情報が使用されます。タスクの送信に失敗すると、Codex はゼロ以外の終了コードで終了します。
codex cloud list
最近の cloud チャットを、省略可能なフィルターとページネーション付きで一覧表示します。
| キー | 型／値 | 詳細 |
|---|---|---|
--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 はデフォルトで整形済みの出力を書き込みます。状態が変化するたびに1件ずつ、改行区切りの JSON イベントを受け取るには、--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 サーバーを一覧表示します。機械可読出力には --json を追加します。 |
login <name> |
--scopes scope1,scope2 |
ストリーミング対応 HTTP サーバーで OAuth ログインを開始します（OAuth をサポートするサーバーのみ）。 |
logout <name> |
ストリーミング対応 HTTP サーバーに保存されている OAuth 認証情報を削除します。 | |
remove <name> |
保存済みの MCP サーバー定義を削除します。 |
add サブコマンドは、stdio とストリーミング対応 HTTP の両方のトランスポートをサポートします。
| キー | 型／値 | 詳細 |
|---|---|---|
--bearer-token-env-var |
ENV_VAR |
ストリーミング対応 HTTP サーバーに接続するとき、値を bearer token として送信する環境変数です。 |
--env KEY=VALUE |
repeatable |
stdio サーバーの起動時に適用する環境変数の割り当てです。 |
--oauth-client-id |
CLIENT_ID |
ストリーミング対応 HTTP MCP サーバーの OAuth クライアント識別子です。--url が必要です。 |
--oauth-resource |
RESOURCE |
ストリーミング対応 HTTP MCP サーバーへのログイン時に含める OAuth resource パラメーターです。--url が必要です。 |
--url |
https://… |
stdio の代わりに、ストリーミング対応 HTTP サーバーを登録します。COMMAND... とは同時に指定できません。 |
COMMAND... |
stdio transport |
MCP サーバーを起動する実行ファイルと引数です。-- の後に指定します。 |
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 checkout を使用するには --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 を stdio 経由の MCP サーバーとして実行し、ほかのツールから接続できるようにします。このコマンドはグローバル設定のオーバーライドを継承し、接続先のクライアントが接続を閉じると終了します。
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 のセットアップ、プロジェクト、最近のチャットをインポートします。 | 対応している外部エージェントの成果物を 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 のセットアップをインポートする
/importと入力します。- Claude Code を選択します。
- 移行するセットアップ、プロジェクトファイル、または最近のチャットを選択します。
期待される結果：Codex が外部エージェントのインポート選択画面を開き、選択された 対応済み成果物を Codex の設定とローカルファイルへインポートします。セッションの検出対象には、 過去 30 日間のチャットが最大 50 件含まれます。
/import はローカルの TUI セッションから実行してください。タスクの実行中、
リモートセッション、およびローカルの 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と入力します。- 現在の IDE の選択範囲や開いているファイルを Codex でどう扱うか説明したい場合は、 任意のインラインテキストを追加します。
期待される結果：Codex が次のプロンプトに利用可能な IDE コンテキストを含めます。
/vim で Vim モードを切り替える
/vimと入力します。- コンポーザーで編集を続けます。
期待される結果：Codex が現在のセッションのコンポーザー 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 スクロールバックを切り替える
/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、
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 ショートカットを再割り当てする
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 サーバーとツールを把握します。
期待される結果：このセッションで 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 worktree でチャットを実行します。 |