Codex の effort(推論の深さ)を変更する 3 つの方法:config.toml・-c フラグ・/model

Codex の応答が遅い、あるいは逆に簡単な修正なのに考えすぎている。そう感じたときに調整するのが reasoning effort(推論の深さ) です。Claude Code の拡張思考に相当する設定で、Codex では model_reasoning_effort というキーで制御します。

結論として、恒久的に変更するなら ~/.codex/config.toml に model_reasoning_effort = "high" のように書き、1 回の実行だけなら -c フラグ、対話中なら /model コマンドで変更します。公式の設定リファレンスが挙げる値は low / medium / high / xhigh / max / ultra です。

指定できる値

公式の設定リファレンスは、model_reasoning_effort を文字列とし、「選んだモデルが公表する推論の深さ。たとえば low、medium、high、xhigh、max、ultra」と説明しています。あわせて「使える段階はモデルとクライアントによる」とも書かれているため、すべてのモデルで 6 段階すべてが選べるわけではありません。既定値はリファレンスに明記されていないので、ここでは書きません。

値	向いている作業
low	小さなバグ修正、単純なリファクタリング
medium	通常の機能追加や調査
high	複数ファイルにまたがる設計変更、原因が分からないバグの調査
xhigh	難しいアルゴリズムや、失敗が許されない大きな変更のレビュー
max	さらに深く考えさせたいとき(対応するモデルのみ)
ultra	同上。リファレンスが挙げるなかで最も深い例

深くするほど応答は遅くなり、トークン消費も増えます。日常作業は medium 前後にしておき、難しい作業のときだけ上げる運用が扱いやすいです。

なお、以前のリファレンスにあった minimal は、2026 年 9 月時点の設定リファレンスには記載がありません。古い記事や設定ファイルで minimal を見かけた場合は、low に置き換えてください。

恒久的に変える:config.toml

~/.codex/config.toml に 1 行書きます。

model = "gpt-5.5"
model_reasoning_effort = "high"

信頼済みプロジェクトなら、リポジトリ内の .codex/config.toml に書いてそのプロジェクトだけ変えることもできます。プロジェクト設定はユーザー設定より優先されます。

1 回だけ変える:-c フラグ

設定ファイルを触らずに、その実行だけ深さを変えるには -c(--config)を使います。値は TOML として解釈される ため、文字列は二重引用符で囲み、シェルに消されないよう全体を一重引用符で包みます。

codex -c model_reasoning_effort='"high"' "このテストが落ちる原因を調べて直して"

codex exec でスクリプトから使うときも同じ書き方です。引用符を付け忘れると、公式ドキュメントによれば TOML として解釈できない値は文字列として扱われるので多くの場合は動きますが、意図を明確にするために引用符を付けるのが安全です。

対話中に変える:/model

セッションの途中で切り替えるには、/model コマンドを実行します。公式のコマンド一覧では「アクティブなモデル(と、利用可能なら reasoning effort)を選ぶ」コマンドと説明されています。難しい調査に入る前に上げ、終わったら戻す、という使い方ができます。

用途ごとに切り替える:プロファイル

「レビューのときは深く、日常は浅く」を毎回指定するのは面倒なので、プロファイルにまとめます。プロファイルは $CODEX_HOME(既定 ~/.codex)に <名前>.config.toml として置き、--profile <名前> で選びます。

# ~/.codex/deep-review.config.toml
model_reasoning_effort = "xhigh"
approval_policy = "on-request"

codex --profile deep-review

プロファイルには差分だけを書き、共通の設定はベースの config.toml に置きます。プロファイルの仕組み全体は親記事の config.toml でモデル・推論の深さ・プロファイルを切り替える を参照してください。

場面別のキー

設定リファレンスには、特定の場面にだけ効く別のキーがあります。

キー	効く場面
plan_mode_reasoning_effort	プランモードのときだけ上書きする
agents.default_subagent_reasoning_effort	起動したサブエージェントの既定の深さ

「計画は深く考えてほしいが、実装は普通でよい」なら plan_mode_reasoning_effort = "high" だけを足すと、通常の model_reasoning_effort を上げずに済みます。

なお、深さと 表示 は別の設定です。推論を表示したい(show reasoning)場合に触るのは model_reasoning_summary(auto / concise / detailed / none)と show_raw_agent_reasoning で、こちらは hide_agent_reasoning と推論の表示 にまとめてあります。

まとめ

• 推論の深さは model_reasoning_effort。リファレンスが挙げる値は low / medium / high / xhigh / max / ultra で、使える段階はモデルとクライアントによる
• 恒久設定は ~/.codex/config.toml、1 回だけは -c model_reasoning_effort='"high"'、対話中は /model
• 用途別に固定するなら <名前>.config.toml のプロファイルを作って --profile で選ぶ
• プランモードには plan_mode_reasoning_effort、サブエージェントには agents.default_subagent_reasoning_effort
• 深くするほど遅く高くなる。日常は中程度、難しい作業だけ上げる
• 深さではなく表示を変えたいなら model_reasoning_summary と show_raw_agent_reasoning