Codex CLI のエラー

Error: --profile only applies to runtime commands and `codex mcp`

結論

--profile を使えないコマンドに付けた状態。使える相手はメッセージに全部並ぶ。

確認した版 Codex CLI v0.153.0
確認日 2026年9月3日
最終更新 2026年9月3日
根拠 実機で確認

エラー文字列

Codex CLI
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実行系のコマンドにだけ付ける
  • プロファイル名を渡したら、起動時の表示で値が変わったことを確認する
  • 名前の打ち間違いはエラーにならない。効かないときは綴りを疑う

この手順で直りませんでしたか?

環境を添えて報告いただければ、追加の原因を検証してこのページに反映します。

エラーを報告する