Error: --profile only applies to runtime commands and `codex mcp`
結論
--profile を使えないコマンドに付けた状態。使える相手はメッセージに全部並ぶ。
確認した版
Codex CLI v0.153.0
確認日
2026年9月3日
最終更新
2026年9月3日
根拠
実機で確認
エラー文字列
Error: --profile only applies to runtime commands and `codex mcp`
⚠️ 標準エラーに出て、終了コードは 1 です。
何が起きているか
--profile はどのコマンドにでも付けられるわけではありません。
⭐ 使える相手はメッセージが全部並べてくれます。
Error: --profile only applies to runtime commands and `codex mcp`:
`codex`, `codex exec`, `codex review`, `codex resume`, `codex queue`,
`codex archive`, `codex delete`, `codex unarchive`, `codex fork`,
`codex mcp`, and `codex sandbox`, and `codex debug prompt-input`.
v0.149.0 で実測しました。
| 付ける相手 | 結果 |
|---|---|
codex exec / codex / codex mcp など実行するもの |
通る |
codex login status のような管理用のもの |
弾かれる |
⚠️ プロファイルは「どう動かすか」の設定です。 ログイン状態の確認のように、動かし方と関係のないコマンドには意味がありません。
直し方
1. 付ける相手を変える
codex --profile work exec "..."
2. プロファイルが定義されているか確認する
🔴 v0.153.0 で置き場所が変わりました。 プロファイルごとに別ファイルにします。
~/.codex/work.config.toml(ファイル名がプロファイル名になる)
model = "gpt-5.6"
sandbox_mode = "workspace-write"
⚠️ config.toml の中に [profiles.work] を書く方式は使えません。
古い書き方が残っていると、--profile を渡した時点で別のエラーで止まります
(詳細)。
⚠️ 定義していないプロファイル名を渡しても、設定ファイル側はエラーになりません(知らないキーは黙って無視されます)。効いているかは実際の動作で確かめてください。
3. 効いているか確かめる
codex exec は起動時に、使っている設定を表示します。
model: gpt-5
sandbox: workspace-write
⭐ ここがプロファイルの値になっているかを見ます。 既定のままなら、プロファイル名が違うか定義が読まれていません。
再発防止
--profileは実行系のコマンドにだけ付ける- プロファイル名を渡したら、起動時の表示で値が変わったことを確認する
- 名前の打ち間違いはエラーにならない。効かないときは綴りを疑う