Codex の設定方法は？config.toml の場所とおすすめ設定、安全な組み合わせ

やっほー、ぼくてんびん丸！

「Codex の設定ってどこでするの？」って調べに来たきみへ、先に答えを言うね。

Codex の設定は、~/.codex/config.toml というテキストファイルに書くんだ。 CLI（ターミナルで動かす版）と IDE 拡張（VS Code などに入れる版）は、同じファイルを読むよ。プロジェクトごとに変えたいときは、リポジトリの中に .codex/config.toml を置く。いちばん大事なのは どこまで触らせるか（サンドボックス） と いつ確認させるか（承認） の2つで、迷ったら公式の標準（Auto）のままでいいよ。

ここに書いた設定名と既定値は、ぜんぶ2026年10月17日に OpenAI 公式のドキュメントで確認したものだよ。

Codex の設定はどこでする？設定画面と config.toml の場所

Codex の「設定」は、実は2か所に分かれているんだ。

~ はホームフォルダのことで、Mac なら /Users/<きみの名前>/.codex/config.toml、Windows ならユーザーフォルダの .codex\config.toml になるよ。環境変数 CODEX_HOME を設定していると、~/.codex の代わりにそのフォルダが使われるんだ。

config.toml が見つからないときは、自分で作っていいよ。 最初から用意されているとは限らないから、~/.codex フォルダに config.toml という名前で空のファイルを作って、次の節の設定を書けば読み込まれる。

config.toml とは？

config.toml は、Codex の動き方を決める設定ファイルだよ。 「キー = 値」を1行ずつ書く TOML という形式で、たとえるなら新しく来たアシスタントに渡す「仕事の約束ごとメモ」なんだ。どのモデルで動くか、どこまで勝手に作業してよいか、ネットに出てよいか、を最初に決めておける。

書き方はこんな感じ。# から後ろはメモ（コメント）で、Codex は読み飛ばすよ。

model = "gpt-6.1-sol"              # ふだん使うモデル
approval_policy = "on-request"     # 必要なときだけ確認する
sandbox_mode = "workspace-write"   # 作業フォルダの中だけ書き込める
model_reasoning_effort = "medium"  # 考える量
web_search = "cached"              # Web検索は取り置きの結果から

まず入れたいおすすめ設定は？

公式ドキュメントが「よく変える設定」として挙げているものを、何が変わるかと一緒にまとめたよ。

web_search は既定の "cached" のままがおすすめだよ。 OpenAI が取り置いた検索結果を返す方式で、知らないページの文章に紛れた「AIへの命令」（プロンプトインジェクション）を受けにくくなる、と公式に書いてあるんだ。最新の情報がどうしても要る回だけ、コマンドに --search を付ければいい。

もう1つ、地味だけど効くのが環境変数のフィルター。既定では、名前に KEY・SECRET・TOKEN を含む環境変数も Codex が動かすコマンドに渡る設定（ignore_default_excludes = true）になっている。渡したくないなら、こう書くよ。

[shell_environment_policy]
ignore_default_excludes = false

安全に使うには？サンドボックスと承認の組み合わせ

Codex の安全は、2つのつまみで決まるんだ。

• サンドボックス（sandbox_mode）：技術的にどこまで触れるか。書き込める場所と、ネットに出られるか。
• 承認（approval_policy）：作業の途中で、いつきみに「やっていい？」と聞くか。

公式ドキュメントの組み合わせ表を、日本語にしたよ。

Auto のままでも、守られている場所があるよ。 作業フォルダの中でも .git・.codex・.agents・.aws のフォルダは読み取り専用になっていて、Codex が勝手に書き換えられないんだ。

ネット接続は、workspace-write でも既定でオフ。パッケージのインストールなどでネットが要るなら、こう書いて開けるよ。

[sandbox_workspace_write]
network_access = true

ここで1つ気をつけたいことがある。公式のサンプル設定ファイルでは sandbox_mode の既定は read-only と書かれているのに、組み合わせ表では「何も指定しないと Auto（workspace-write）」とされているんだ。どちらで動くかは起動のしかたやフォルダの扱いで変わりうるので、自分の使い方を config.toml に明記しておくのがいちばん確実だよ。いまの状態は、CLI の /permissions コマンドで確かめて切り替えられる。

AGENTS.md との違いは？

config.toml は「Codex という道具の設定」、AGENTS.md は「Codex に渡す作業ルール」だよ。

• config.toml：モデル・サンドボックス・承認など、Codex の動き方そのもの
• AGENTS.md：「JavaScript を直したら npm test を回す」「依存を足す前に確認して」など、仕事の進め方の指示

AGENTS.md は ~/.codex/AGENTS.md（全体）と、リポジトリの各フォルダ（プロジェクト）に置ける。根元から今いるフォルダに向かって順につなげて読み、近いフォルダの指示ほど後ろに来て優先されるんだ。合計が32KB（project_doc_max_bytes の既定）を超えると、そこから先は読まれないよ。

設定が効かない・Codex が起動しないときは？

まず、設定の優先順位を知っておくと迷わないよ。上ほど強いんだ。

1. コマンドの -c／--config 指定
2. プロジェクトの .codex/config.toml（信頼済みのプロジェクトだけ。今いるフォルダに近いほど強い）
3. --profile <名前> で選んだ ~/.codex/<名前>.config.toml
4. ~/.codex/config.toml
5. 会社のワークスペースから配られる既定値
6. システム全体の /etc/codex/config.toml
7. 組み込みの既定値

よくあるつまずきは、この3つ。

untrusted は前は「全部のコマンドで確認する」設定だったんだけど、いまは廃止されていて、残っていると Codex が起動しないことがあると公式に書いてあるよ。同じくらい慎重に使いたいなら、そのプロジェクトだけ信頼しない扱いにすれば、ルールで許したコマンド以外は確認が入るようになるんだ。

[projects."/path/to/project"]
trust_level = "untrusted"

ぼくの見解

設定の中で、お財布にいちばん効くのは model_reasoning_effort（考える量）だと思うんだ。単価は1円も変わらないのに、使うトークンの数が変わるからね。

ぼくたちは LABS の effort 検証 で、Claude の Fable 5.1 に同じ課題を5段階の effort で解かせたことがある。簡単な4課題では low から xhigh まで出力はほぼ同じで、max だけ約3.5倍。難しい3課題では思考が段階どおりに増えて、low から max で約6.8倍になったんだ。Codex の GPT-6.1 Sol で同じ形になるかはまだ測っていないけど、Codex の料金はクレジット（GPT-6.1 Sol は100万トークンあたり出力250クレジット）で減っていくから、考える量を上げっぱなしにすると枠の減りが早くなる気がするよ。ふだんは medium のままにして、難しい設計や原因のわからないバグのときだけ上げるのが、ちょうどいいと思う。

もう1つ、--yolo を常用するのはおすすめしない。公式の標準（Auto）でも作業フォルダの中は自動で進むし、確認が多くてわずらわしいなら auto_review という逃げ道が公式に用意されている。フルアクセスにする前に、まずこっちを試してほしいな。

迷ったらこの順で

1. ~/.codex/config.toml を開く（無ければ作る）
2. sandbox_mode = "workspace-write" と approval_policy = "on-request" を書いておく
3. 名前に KEY・TOKEN を含む環境変数を渡したくないなら、ignore_default_excludes = false を足す
4. プロジェクトの決まりごとは AGENTS.md に書く
5. 効かないときは、-c 指定とプロジェクトの .codex/config.toml が上書きしていないかを見る

設定は一度決めれば毎回効くから、最初の10分をここに使うと、そのあとの作業がずっと楽になるよ。