Slash commands in Codex CLI

概要

composer で / を打つと slash popup が開き、モデル切り替え・権限変更・長いチャットの要約などをターミナルから離れずに行える。あわせて、deprecated な custom prompts（~/.codex/prompts/ の Markdown を slash コマンドにする仕組み）もこのページで扱う。

仕様

キューイング

チャットが実行中でも slash コマンドを打って Tab で次のターン用にキューできる。キューされた slash コマンドは実行時に解析されるため、コマンドメニューやエラーは現在のターンが終わってから出る。 キューする前の slash 補完は通常どおり効く。

組み込み slash コマンド

コマンド	目的
`/permissions`	確認なしに Codex ができることを設定する
`/ide`	開いているファイル・選択範囲などの IDE コンテキストを含める
`/keymap`	TUI のキーボードショートカットを再割り当てする
`/vim`	composer の Vim モードを切り替える
`/setup-default-sandbox`	elevated な agent sandbox をセットアップする（Windows 専用）
`/sandbox-add-read-dir`	sandbox の読み取りを追加ディレクトリに許可する（Windows 専用）
`/agent`、`/subagents`	アクティブな agent スレッドを切り替える
`/apps`	apps（connector）を閲覧してプロンプトに挿入する
`/plugins`	インストール済み・発見可能な plugin を閲覧する
`/hooks`	ライフサイクル hook を閲覧・管理する
`/clear`	ターミナルを消して新しいチャットを始める
`/rename`	現在のチャットの名前を変える
`/archive`	現在のセッションをアーカイブして Codex を終了する
`/delete`	現在のセッションを完全に削除して Codex を終了する
`/compact`	表示中のチャットを要約してトークンを空ける
`/copy`	直近の完了した出力をコピーする
`/diff`	Git の diff を表示する（未追跡ファイルを含む）
`/exit`、`/quit`	CLI を終了する
`/experimental`	実験的機能を切り替える
`/approve`	直近の auto review 拒否を 1 回だけ承認する
`/memories`	memory の利用と生成を設定する
`/skills`	skill を閲覧して使う
`/import`	Claude Code のセットアップ・プロジェクト・最近のチャットを取り込む
`/feedback`	ログを Codex のメンテナに送る
`/init`	現在のディレクトリに `AGENTS.md` の雛形を生成する
`/logout`	サインアウトする
`/mcp`	設定済みの MCP ツールを一覧する
`/mention`	ファイルをチャットに添付する
`/model`	アクティブなモデル（可能なら reasoning effort も）を選ぶ
`/fast`	モデルカタログが公開していれば Fast service tier を切り替える
`/plan`	plan モードに切り替える。任意でプロンプトも送る
`/goal`	タスクの goal を設定・編集・一時停止・再開・表示・削除する
`/personality`	応答のコミュニケーションスタイルを選ぶ
`/ps`	バックグラウンドターミナルと直近の出力を表示する
`/stop`（別名 `/clean`）	すべてのバックグラウンドターミナルを止める
`/fork`	現在のチャットを新しいチャットに fork する
`/app`	現在のセッションを ChatGPT desktop app で続ける
`/side`、`/btw`	一時的な side chat を始める
`/raw`	raw scrollback モードを切り替える
`/resume`	保存済みのチャットを再開する
`/new`	同じ CLI セッション内で新しいチャットを始める
`/review`	作業ツリーのレビューを依頼する
`/status`	セッション設定とトークン使用量を表示する
`/usage`	アカウントのトークン使用量、または rate-limit reset の利用
`/debug-config`	config レイヤーと requirements の診断を表示する
`/statusline`	TUI のフッター項目を対話的に設定する
`/title`	ターミナルのウィンドウ／タブタイトル項目を対話的に設定する
`/theme`	シンタックスハイライトのテーマを選ぶ
`/pets`、`/pet`	ターミナルの pet を選ぶ／隠す

条件付きで表示されるコマンド

/fast: Fast tier コマンドはカタログ駆動。現在のモデルが Fast tier を宣言していない場合、/fast は表示されない
/personality: アクティブなモデルが personality 固有の指示に対応していない場合、このコマンドは隠される。値は friendly / pragmatic / none
/setup-default-sandbox: Windows で、Codex が degraded な restricted-token sandbox を使っているときだけ表示される
/sandbox-add-read-dir: Windows ネイティブで CLI を実行しているときだけ使える

実行中に使えないコマンド

/plan: Codex が作業中は一時的に使えない
/archive: タスク実行中は使えない
/delete: チャット実行中と side chat 内では使えない
/side: 別の side chat の中と review モード中は使えない
/import: ローカルの TUI セッションから実行する。 タスク実行中、リモートセッション、ローカル app-server デーモンへの接続中は使えない
/copy: 最初の完了出力より前とロールバック直後は使えない。ターン実行中は進行中の応答ではなく直近の完了出力を使う
/clear と Ctrl+L はタスク進行中は無効になる

各コマンドの詳細

/model: 変更後は /status で確認できる
/goal: objective は空でなく、最大 4,000 文字。長い指示はファイルに置いて goal からそのファイルを指す
/experimental: 選択は config に保存され、再起動時に適用される（Network proxy、Prevent sleep while running など）
/approve: 自動レビューが拒否したアクションを、現在のセッションポリシーのもとで 1 回だけ再試行する
/import: Claude Code を選び、移行したいセットアップ・プロジェクトファイル・最近のチャットを選ぶ。セッションの発見対象は直近 30 日の最大 50 チャット
/clear: ターミナルを消して同じ CLI セッション内で新しいチャットを始める。/clear release prep のように名前を付けられる。Ctrl+L はターミナル表示を消すだけで現在のチャットは維持する
/archive: トランスクリプトはローカルに残る。codex unarchive <SESSION> で復元する
/delete: 削除は恒久的で、派生した子セッションも消える
/permissions: 名前付き permission profile が有効なとき、ピッカーに設定済みのカスタム profile とその説明も出る
/vim: 新しいセッションでも既定にするには tui.vim_mode_default = true
/raw: /raw on / /raw off も使える。既定の Alt+R バインドや tui.raw_output_mode = true でも同じ
/status: アクティブなモデル、approval policy、writable roots、トークン使用量を表示する。TUI がリモート接続しているときはリモートアドレスとサーバーバージョンも出る
/usage: /usage daily / weekly / cumulative で直接開く。Codex service account の認証が無いセッションではサインインが必要と表示される
/debug-config: config レイヤーの順序（優先度の低い順）、on/off 状態、ポリシーの出所を出す。設定されていれば allowed_approval_policies、allowed_sandbox_modes、mcp_servers、rules、enforce_residency、experimental_network も出る
/statusline: 選択は tui.status_line に保存される。項目は model、model+reasoning、context stats、rate limits、git branch、token counters、session id、現在のディレクトリ／プロジェクトルート、Codex バージョン
/title: tui.terminal_title に保存される。項目は app 名、project、spinner、status、thread、git branch、model、task progress
/keymap: バインドは ctrl-a、shift-enter、page-down のような名前。コンテキスト固有のバインドが tui.keymap.global を上書きする。空のバインドリストでアクションのバインドを外す
/ps: 各バックグラウンドターミナルのコマンドと、空でない直近の出力を最大 3 行表示する。バックグラウンドターミナルは unified_exec を使っているときに現れる。そうでなければ一覧は空になりうる
/review: review_model を config.toml に設定していない限り、現在のセッションのモデルを使う
/mcp: /mcp verbose で詳細なサーバー診断を含める。verbose 以外を渡すと使い方が表示される
/apps: 選んだ app を $app-slug として composer に挿入する
/plugins: インストール済み plugin で Space を押すと有効・無効を切り替えられる
/hooks: managed hook は managed として表示され、ユーザーの hook ブラウザからは無効化できない
/fork: 現在のチャットを新しい ID のチャットに複製する。元のトランスクリプトはそのまま。保存済みセッションを fork したい場合はターミナルで codex fork
/app: macOS と Windows で使える。app が未インストール／未起動ならエラーになる
/side: 親チャットとは別のトランスクリプトを持つ。side モード中も TUI は親チャットの状態を表示し続ける

custom prompts（deprecated）

custom prompts は deprecated。 明示的にも暗黙的にも呼べる再利用可能な指示には skills を使うことが案内されている。

Markdown ファイルを slash コマンドとして使える仕組みで、Codex CLI と IDE extension の両方で動く
明示的な呼び出しが必要で、ローカルの Codex home（例: ~/.codex）に置くためリポジトリ経由で共有されない。共有したい／暗黙に呼ばせたい場合は skills を使う
~/.codex/prompts/ に Markdown を置き、Codex を再起動する（CLI セッションの再起動、IDE extension のリロード）と読み込まれる
/prompts:<name> で呼ぶ

メタデータとプレースホルダ:

要素	説明
`description`（YAML front matter）	popup でコマンド名の下に表示される
`argument-hint`（YAML front matter）	`KEY=<value>` の形で期待するパラメータを書く
`$1`〜`$9`	コマンドの後に渡す空白区切りの引数に展開される
`$ARGUMENTS`	すべての引数を含む
`$FILE` などの大文字の名前	`KEY=value` の形で値を渡す。空白を含む値はクォートする
`$$`	展開後のプロンプトに `$` を 1 個出す

プロンプトファイルを編集した後は、Codex を再起動するか新しいチャットを開くと反映される
prompts ディレクトリの Markdown 以外のファイルは無視される
トップレベルの Markdown ファイルだけを走査する。サブディレクトリではなく ~/.codex/prompts/ 直下に置く

設定

---
description: Prep a branch, commit, and open a draft PR
argument-hint: [FILES=<paths>] [PR_TITLE="<title>"]
---

Create a branch named `dev/<feature_name>` for this work.
If files are specified, stage them first: $FILES.

/prompts:draftpr FILES="src/pages/index.astro src/lib/api.ts" PR_TITLE="Add hero animation"