config / profiles · 約 8 分

profile ファイル

0.154.0 では --profile が $CODEX_HOME/<name>.config.toml を重ねます。

学習目標

Codex 0.134.0 以降、--profile name は $CODEX_HOME/name.config.toml をユーザー設定の上に重ねます。config.toml 内の [profiles.name] と top-level profile = は使われません。 ^{[codex-config-advanced]}

前提

CODEX_HOME が既定の ~/.codex であること。

なぜ必要か

CI 用に approval を厳しくした層を、毎回 -c せずに呼びたいからです。

実行場所

local-bridge のみ。checks に codex --help があるため browser では完了できません。学習 workspace には内容の控えだけ置きます。実際に --profile safe を使うときは ~/.codex/safe.config.toml へコピーします。

approval_policy = "on-request"
sandbox_mode = "read-only"
model_reasoning_effort = "medium"

codex --profile safe --help

サンプル config にも profile ファイルの説明があります。 ^{[codex-config-sample]}

成功結果

--profile が help にあり、学習用 TOML の sandbox は read-only です。

失敗対処

[profiles.safe] をユーザー config に書いても 0.154.0 では選ばれません。ファイル名を safe.config.toml にしてください。