Codexの設定を整理する

Codexの設定を変えたのに反映されないとき、入力した値よりも「どの場所の設定を読んでいるか」が原因になっていることがあります。この記事では、ローカルCodexの設定ファイルの場所と優先順位、変更を小さく確かめる方法を整理します。

主な対象はCodex CLIとIDE拡張です。ChatGPTのWeb画面に設定ファイルを貼り付けても、PC上のCodex設定が変わるわけではありません。

自分全体とプロジェクト限定を分ける

設定ファイルはTOMLという形式で書きます。項目名と値を = で結び、まとまりを [名前] で表す形式です。

場所	主な役割
`~/.codex/config.toml`	自分のCodexで共通に使う既定値
プロジェクト内の `.codex/config.toml`	そのプロジェクトに限定した設定

~ はユーザーのホームフォルダーを表します。標準的なWindows環境なら C:\Users\自分のユーザー名\.codex\config.toml が対応します。Codexの保存先を変更している環境では実際の場所を確認してください。

プロジェクトの設定は、信頼済みのプロジェクトだけで読み込まれます。他人から取得した設定は、内容を確認してから扱います。

IDE拡張では、歯車から Codex Settings → Open config.toml と進む方法が公式資料にあります。見つからないときは、利用中の拡張の版と公式案内を確認します。

2026年9月12日時点の公式資料では、上から優先されます。

たとえばユーザー設定を変更しても、同じ項目をプロジェクトや起動時に指定していれば、そちらが使われます。この順位とは別に、組織が強制する管理上の制限が存在する場合があります。

下の図は設定を変更するときの確認順です。優先順位の一覧そのものとは区別してください。

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

図解Codexの設定を整理する：進める順番

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

最初に作業場所を確認し、次に上書き元を探します。設定を増やし続ける前に、同じ項目がほかにないかを見ます。

設定に慣れていない場合は、Codexへ次のように依頼できます。

このプロジェクトでCodexの設定が置かれている場所を確認してください。
ファイルは変更せず、見つかった設定の役割と適用範囲を説明してください。
認証情報や秘密の値は回答へ引用しないでください。
読み取れない場所や、実際の有効値を確認できない項目は未確認としてください。

この依頼で調査できるのは、Codexが実際に読める範囲です。ファイルが見つからないことと、設定が一切存在しないことを同じ意味にしないのが大切です。

設定形式の例として、回答の雰囲気に関する項目は次のように書きます。

personality = "friendly"

これは形を理解するための例です。既存の設定をこの一行だけで上書きしないでください。TOMLでは [mcp_servers.example] などの見出しより下へ書くと、その表の項目として解釈されます。全体の項目を追加する場所と、特定サーバーの表の中を混同しないようにします。

困ったら追加した変更だけを元へ戻し、再起動して元の動作に戻るか確認します。ほかの人の更新が入っている場合は、控えでファイル全体を上書きせず、今回の差分を見て戻します。

承認の頻度と、ファイル・ネットワークへアクセスできる範囲は別の設定です。「止まるから」という理由だけで両方を広げる前に、必要な操作と対象を特定します。判断の考え方は承認と権限の基本へ進めます。

モデルや接続先などの構成は config.toml、プロジェクトで守る作業方針はAGENTS.md、必要に応じて使う手順はSkillsで整理できます。外部ツールの設定はMCPの入門も参照してください。

この記事は公式の設定資料と照合した説明です。あなたのPCの設定を変更したり、各クライアントで設定反映を実測したりした結果ではありません。

目的別に設定を選ぶ場合は設定プロファイル、書式や項目の場所で迷う場合はTOMLの点検で小さな例から確認できます。

実行するプログラムへ値を渡す場合は、環境変数と.envファイルの違いを小さな例で確認できます。