Codexの設定プロファイルを使う

調査と普段の作業でCodexの設定を変えたいとき、毎回同じファイルを書き換えると、元の値を忘れやすくなります。設定プロファイルは、変えたい項目を別のファイルにまとめ、CLIの起動時に選ぶための仕組みです。

この記事はローカルのCodex CLIが対象です。すでにCLIを起動でき、設定ファイルの場所が分かる状態から進めます。アプリの画面設定や権限プロファイルとは区別します。

基本設定と差分を分ける

2026年9月12日時点の公式資料では、--profile 名前 を付けると、ユーザーの config.toml に同じ場所の 名前.config.toml を重ねます。別ファイルに全設定をコピーする必要はありません。

~/.codex は標準の保存先です。CODEX_HOME を変更している環境では実際の保存先に合わせます。まず元の設定を控え、同名のファイルが存在しないか確認してください。

各段階で確認してから、次の操作へ進みます。

1. 1差分を決める既定値と変える項目を一つ選びます。
2. 2別ファイルで選ぶ設定ファイルを用意しCLIで名前を指定します。
3. 3有効な設定を確認上書き元と実際の動作を照合します。

具体的な依頼と、結果の確かめ方は本文にあります。

プロファイルは設定の一つの層です。選択しただけで、すべての設定より優先されるわけではありません。

変える項目を一つにする

形式を理解する練習として、friendly-check.config.toml の先頭に次の一項目を置く例を使います。

personality = "friendly"

これは対応モデルの回答スタイルに関する設定です。モデルが対応しない場合やタスク側で上書きされる場合があり、返答が親切に見えることだけで読み込み成功とは判定できません。利用中のモデルへの対応は公式の設定リファレンスで確認します。

Codex CLIの設定プロファイルを一つ用意する案を示してください。
実際のCODEX_HOMEとユーザー設定の場所を確認し、秘密の値は引用しません。
既存config.tomlを変更せず、friendly-check.config.tomlへ置く差分だけを示します。
同名ファイルがあれば新規作成せず報告してください。
この設定の対応条件と、上書きする可能性がある設定も確認してください。

内容を確認してから別ファイルを作ります。承認やサンドボックスを緩める項目を、回答スタイルの変更に便乗して足す必要はありません。

CLIで名前を指定する

練習用の作業フォルダーで、新しく起動するときの形は次です。

codex --profile friendly-check

ファイル名の .config.toml は付けず、プロファイル名を指定します。名前に使えるのは英数字、ハイフン、アンダースコアです。

起動時の警告、選んだ名前、実際の設定ファイルを照合します。構文の検査はTOMLの点検を使えますが、パーサーで読めることとCodexで有効になることは別です。

変わらないときは上書き元を見る

起動フラグ・--config や、信頼済みプロジェクトの設定は、選択したプロファイルより優先されます。組織が強制する制限も別に確認します。

このプロファイルで指定した項目が反映されるか確認してください。
起動時の指定、プロジェクト設定、プロファイル、ユーザー設定の順に同じキーを調べます。
設定を追加変更せず、確認できた有効値と未確認の範囲を分けて報告してください。

現行資料では、Codex 0.134.0以降は config.toml 内の旧 [profiles.名前] と profile = "名前" による選択を使いません。古い記事を参考にした場合は、利用中の版を確かめ、旧項目の差分を控えてから別ファイル形式へ移します。

普段の設定へ戻す

このプロファイルを指定したCLIを終了し、次は --profile friendly-check を付けずに起動します。作った設定ファイルを整理するときは今回の一枚だけを対象にし、元の config.toml を消しません。

設定の切り替えは、Codexがすでに行ったファイル変更を巻き戻す機能ではありません。作業結果を戻す場合は変更内容の確認を別に行います。

公式の設定仕様と例のTOML構文を確認しました。ここでは実際のCodex設定や認証状態を変更しておらず、プロファイルを指定したモデル実行は未検証です。