codex 言語設定で迷ったらこれ、日本語に戻す手順とアプリ別の考え方

「codex 言語設定」と検索している人の多くは、OpenAI Codexを使っているときに「返答が英語になる」「日本語で指示したのに英語で返ってくる」「CLI、VS Code拡張、Codexアプリで設定場所が違って見える」といった悩みを持っているはずです。調査した範囲では、Codexには一般的なアプリのような「表示言語を日本語にする」だけの単純なスイッチが用意されているというより、AGENTS.mdやconfig.toml、利用環境ごとの設定で挙動を整えるという考え方が中心になります。

この記事では、2026年5月19日時点で確認できる情報をもとに、codexの言語設定を日本語寄りにする方法、アプリごとに設定を変える考え方、初心者が混乱しやすいCLI・VS Code拡張・Codexアプリの違い、さらに承認モードやMCP、Web検索、Git管理までまとめます。体験談ではなく、調査情報を整理し、「どこを触れば何が変わるのか」が初めてでもわかるように解説します。

この記事のポイント
✅ codexの返答を日本語に寄せる基本はAGENTS.mdに指示を書くこと
✅ UIの表示言語とAIの返答言語は分けて考えること
✅ CLI、VS Code拡張、Codexアプリでは設定の見え方が違うこと
✅ 言語設定とあわせて承認モード・Git管理も確認すること

codex 言語設定の基本と日本語化の最短手順

🧭 この章の見出し一覧

1. 言語設定を日本語に戻す方法はAGENTS.mdに日本語指示を書くこと
2. ~/.codex/AGENTS.mdは全プロジェクト共通、プロジェクトAGENTS.mdは個別ルールに使うこと
3. アプリごとに言語設定を変えるには配置場所を分けること
4. codex 言語設定のAI回答を見る前に「UI言語」と「返答言語」を分けること
5. codex 初心者はconfig.tomlより先にAGENTS.mdを整えること
6. 日本語化が効かない時は起動場所と読み込み階層を見直すこと
7. WindowsではCLIとCodexアプリを分けて考えること

言語設定を日本語に戻す方法はAGENTS.mdに日本語指示を書くこと

codexの返答を日本語に戻したい場合、最初に見るべき場所はAGENTS.mdです。調査した範囲では、Codex CLIでは~/.codex/AGENTS.mdに共通のふるまいを書いておくことで、全体の返答方針を日本語寄りにできます。一般的な「設定画面で日本語を選ぶ」というより、AIに対する恒久的な指示書を作るイメージです。

たとえば、次のような短い文章をAGENTS.mdに書きます。長く複雑にするより、まずは日本語で返すこと、説明を簡潔にすること、コード内の命名は英語でよいことを明示するのが扱いやすいです。

# Instructions

- 回答は日本語で行ってください。
- 初心者にもわかるように、専門用語は必要に応じて補足してください。
- コード内の変数名・関数名・コメントは、既存プロジェクトの方針に合わせてください。
- 不明点がある場合は、推測で進めず確認してください。

この設定は、いわゆる「表示メニューを日本語化する設定」とは少し違います。Codexがどの言語で説明するか、どんなトーンで返すかを決める行動ルールに近いものです。検索意図として「言語設定」と入力している人は、UI言語を探している場合もありますが、実務上の困りごとは「返答が英語になる」ことが多いと考えられます。

📝 設定場所の早見表

やりたいこと	触る場所	期待できる変化
Codexの返答を日本語にしたい	~/.codex/AGENTS.md	全体的に日本語で返りやすくなる
特定プロジェクトだけ日本語ルールを強めたい	プロジェクト直下のAGENTS.md	そのリポジトリでの返答方針を調整しやすい
モデルや承認モードを変えたい	~/.codex/config.toml	動作設定を変えられる
VS Code内で挙動を見直したい	Codex拡張の設定画面	画面上から設定へ入りやすい

注意したいのは、AGENTS.mdに書いたからといって、すべての単語が常に日本語になるとは限らない点です。コード、エラーメッセージ、ライブラリ名、コマンド名、設定キーは英語のまま出ることがあります。むしろ開発作業では、そこまで無理に日本語化しない方が読みやすい場面もあります。

したがって、codexの言語設定で最初に目指すべき状態は、「説明は日本語、コードや設定名は原文のまま」です。このバランスにしておくと、初心者にも理解しやすく、開発中の検索やエラー調査もしやすくなります。

---

~/.codex/AGENTS.mdは全プロジェクト共通、プロジェクトAGENTS.mdは個別ルールに使うこと

AGENTS.mdには、大きく分けて全プロジェクト共通の指示とプロジェクトごとの指示があります。~/.codex/AGENTS.mdは全体設定として使いやすく、どの作業フォルダでCodexを起動しても読み込まれる共通ルールに向いています。

一方、リポジトリのルートに置くAGENTS.mdは、そのプロジェクト専用のルールを書く場所として使えます。たとえば「このプロジェクトでは日本語で報告する」「既存の命名規則に合わせる」「ファイル削除は提案に留める」など、チーム運用に関わるルールを書くのに向いています。

この2つを分けると、codexの言語設定をかなり管理しやすくなります。毎回プロンプトで「日本語で答えて」と書く必要が減り、プロジェクト固有の注意点もCodexに渡しやすくなります。Claude CodeのCLAUDE.mdに近い役割として理解すると、移行組にもわかりやすいでしょう。

🗂 AGENTS.mdの使い分け

ファイル	置き場所	向いている内容
共通AGENTS.md	~/.codex/AGENTS.md	返答は日本語、説明は簡潔になどの全体方針
プロジェクトAGENTS.md	リポジトリ直下	そのプロジェクトの開発ルール、テスト方針、禁止事項
サブフォルダAGENTS.md	作業中の下位フォルダ	特定領域だけの細かい注意点

調査した情報では、Codexは起動時にAGENTS.mdを読み込み、近い階層のものを優先しながら扱うとされています。つまり、全体ルールとプロジェクトルールが両方ある場合、プロジェクト側の具体的な指示が効きやすいと考えると整理しやすいです。

ただし、ルールを増やしすぎるとCodexが守るべき前提が複雑になります。日本語化が目的なら、まずは共通AGENTS.mdに短く書き、プロジェクト側には本当に必要な開発ルールだけを書くのがおすすめです。

📌 書き方の優先順位

優先度	書く内容	理由
高	回答言語、報告形式、安全ルール	毎回の作業に影響するため
中	テスト実行方針、ブランチ運用	プロジェクトごとに違いやすいため
低	好みの文体を細かく指定	長くなりすぎると逆に不安定になりやすいため

特に共同作業では、AGENTS.mdは単なる言語設定ではなく、AI向けの作業指示書になります。Codex、Claude、ほかのエージェントが同じリポジトリを見る場合、ここに最低限の共通ルールを残しておくと、作業のズレを減らしやすくなります。

---

アプリごとに言語設定を変えるには配置場所を分けること

「アプリごとに言語設定を変えるには？」という検索意図には、2つの可能性があります。1つは「Codex CLI、VS Code拡張、Codexアプリでそれぞれ言語を変えたい」という意味。もう1つは「プロジェクトごと、用途ごとに日本語・英語を使い分けたい」という意味です。

提供情報を整理すると、Codexの返答言語を切り替える中心はAGENTS.mdです。つまり、アプリごとに専用の言語スイッチを探すより、どの作業フォルダで、どのAGENTS.mdを読ませるかを考える方が実務的です。

たとえば、普段の開発では日本語で説明してほしいが、海外向けOSSのREADMEやIssue文面は英語で作りたい場合、共通AGENTS.mdでは「原則日本語」とし、プロジェクト側のAGENTS.mdや都度プロンプトで「このタスクの出力は英語」と指定します。

🧩 アプリ別に考える設定の整理

利用形態	主な入口	言語設定の考え方
Codex CLI	ターミナル	~/.codex/AGENTS.mdと作業フォルダのAGENTS.mdを重視
VS Code拡張	エディタ内チャット	プロジェクト文脈と設定画面をあわせて確認
Codexアプリ	デスクトップアプリ	タスク単位の指示とプロジェクト設定を分けて考える
ChatGPT上のCodex関連機能	ChatGPT画面	ChatGPT側の個人設定とタスク指示の影響も考える

ここで混同しやすいのが、アプリのメニュー表示言語とAIの返答言語です。たとえばアプリのボタンや設定画面が英語でも、AGENTS.mdやプロンプトで「日本語で回答」と指示すれば、AIの説明は日本語になりやすくなります。

逆に、アプリのUIが日本語でも、プロジェクト指示や会話の流れが英語中心なら、Codexの返答が英語寄りになることも考えられます。AIは直前の文脈にも影響を受けるため、恒久設定とその場の指示を組み合わせるのが現実的です。

🎯 言語を使い分ける例

場面	おすすめの指示
普段の相談	「回答は日本語で、必要なコマンドはそのまま示してください」
英語README作成	「出力文は英語、説明は日本語でお願いします」
海外Issue返信	「Issue本文は英語で、作成意図の説明は日本語でください」
コードレビュー	「レビューコメントは日本語で、修正例はコードブロックで示してください」

つまり、アプリごとに設定を完全分離するというより、共通ルール、プロジェクトルール、タスクごとの指示を重ねて使うのがcodexの言語設定では扱いやすい方法です。

---

codex 言語設定のAI回答を見る前に「UI言語」と「返答言語」を分けること

検索結果で「codex 言語設定 AI回答を見る」といった導線を見かける場合、AI検索や検索エンジンの要約だけを読んで解決しようとする人もいるかもしれません。ただ、このテーマでは要約だけだと混乱しやすいです。理由は、何の言語設定を変えたいのかが人によって違うからです。

まず分けるべきなのは、UI言語と返答言語です。UI言語は、アプリのボタン、メニュー、設定画面の表示言語を指します。返答言語は、CodexがチャットやCLIで説明するときの言語を指します。「英語で返ってくるから日本語にしたい」という悩みは、多くの場合、返答言語の問題です。

調査した範囲では、Codex CLIの日本語化として紹介されている方法は、AGENTS.mdに「日本語で回答してください」と書く方法が中心です。一方、OpenAI公式のCodex紹介ページでは、CodexはChatGPTのコーディングエージェントとして説明されていますが、UI全体の表示言語だけを切り替える手順が主題ではありません。

🔎 UI言語と返答言語の違い

種類	何が変わるか	主な対処
UI言語	ボタン、メニュー、設定画面	アプリやOS、ChatGPT側の言語設定を確認
返答言語	Codexの説明文、報告文	AGENTS.mdやプロンプトで日本語を指定
コード言語	変数名、関数名、コメント	プロジェクト規約に合わせる
ドキュメント言語	README、Issue、PR本文	タスクごとに日本語・英語を指定

検索で出てくるAI回答は、短く便利な反面、「AGENTS.mdを書けばOK」とだけ説明して終わることがあります。しかし、実際には配置場所、起動ディレクトリ、CLIとVS Code拡張の違い、既存のプロジェクト指示なども絡みます。

特に、仕事で使う場合は「返答だけ日本語にしたい」のか、「プロジェクトのドキュメントも日本語で作りたい」のかを分けて指示する必要があります。ここを曖昧にすると、READMEまで日本語になったり、逆に説明だけ英語になったりすることがあります。

🧠 検索前に決めること

質問	決める理由
日本語にしたいのは画面か、返答か	対処方法が違うため
全プロジェクト共通か、特定プロジェクトだけか	AGENTS.mdの置き場所が変わるため
コードコメントも日本語にしたいか	開発規約に影響するため
英語出力が必要な場面があるか	例外ルールを作る必要があるため

結論として、AI回答を見る前に、まず自分の困りごとを「UI」「返答」「コード」「ドキュメント」に分けると、codexの言語設定はかなり整理しやすくなります。

---

codex 初心者はconfig.tomlより先にAGENTS.mdを整えること

codex初心者が設定を調べると、config.toml、承認モード、モデル、MCP、Web検索など、多くの情報が出てきます。ただ、言語設定だけを目的にしているなら、最初から全部を触る必要はありません。まず整えるべきはAGENTS.mdです。

config.tomlは、モデルや推論の深さ、承認ポリシー、サンドボックス、通知、Web検索など、Codexの動作全体に関わる設定です。便利ですが、初心者がいきなり変更すると「何を変えたから挙動が変わったのか」がわかりにくくなります。

一方、AGENTS.mdは「どう返答してほしいか」を書くファイルです。日本語化、説明の粒度、安全上の注意、作業報告の形式など、言語設定に近い内容を扱いやすい場所です。まずここを短く整え、その後必要に応じてconfig.tomlへ進む流れがわかりやすいでしょう。

🛠 初心者向けの設定順

順番	やること	目的
1	~/.codex/AGENTS.mdを作る	返答を日本語に寄せる
2	プロジェクトのAGENTS.mdを確認	個別ルールと衝突しないようにする
3	/modelや設定画面を確認	使っているモデルを把握する
4	config.tomlを必要な分だけ触る	動作設定を調整する
5	Git管理を確認	意図しない変更に備える

AGENTS.mdに最初から長いルールを書く必要はありません。むしろ、最初は短い方が扱いやすいです。「回答は日本語」「コードは既存方針に合わせる」「不明点は確認する」程度から始め、必要になったら追記する形が現実的です。

⚙️ 最小構成の例

# Codex Instructions

- 回答は日本語で行ってください。
- 変更内容は簡潔に説明してください。
- コマンドやファイル名は原文のまま示してください。
- 判断に迷う場合は、作業前に確認してください。

このように、初心者は「日本語にしたい」という目的をconfig.tomlで解決しようとしない方が迷いにくいです。config.tomlは動作設定、AGENTS.mdはふるまい設定、と分けて考えると理解しやすくなります。

---

日本語化が効かない時は起動場所と読み込み階層を見直すこと

AGENTS.mdに日本語指示を書いたのにCodexが英語で返す場合、まず疑うべきはファイルの場所です。~/.codex/AGENTS.mdに置いたつもりでも、実際には別の場所に作っていたり、拡張子が違っていたり、文字コードやファイル名が微妙に違っていたりすることがあります。

次に確認したいのが、作業フォルダ側のAGENTS.mdです。プロジェクト直下やサブフォルダに別のAGENTS.mdがあり、そこに英語での出力を求める指示がある場合、意図した日本語ルールが弱くなる可能性があります。Codexは近い階層の指示を重視する設計と説明されているため、階層関係は重要です。

また、会話の途中で英語のログやドキュメントを多く貼り付けると、Codexがその文脈に引っ張られて英語で返すこともあります。その場合は、プロンプトの最後に「回答は日本語でお願いします」と明示すると戻りやすくなります。

🧪 日本語化が効かない時のチェック表

チェック項目	見るポイント
ファイル名	AGENTS.mdになっているか
置き場所	~/.codex/またはプロジェクト直下か
内容	日本語回答の指示が明確か
競合	下位フォルダのAGENTS.mdに別指示がないか
起動場所	想定したプロジェクトでCodexを起動しているか
直前文脈	英語の長文を貼った後ではないか

よくあるのは、共通AGENTS.mdだけを修正して、実際にはプロジェクト側のAGENTS.mdに別の指示があるケースです。共同開発やAIエージェント併用の現場では、プロジェクトごとの指示ファイルが存在していることも珍しくありません。

🔧 切り分けの進め方

手順	内容
1	新しいセッションで「日本語で自己紹介して」と聞く
2	英語なら共通AGENTS.mdの場所を確認
3	日本語ならプロジェクト側のAGENTS.mdを確認
4	途中から英語になるなら直前の文脈を確認
5	それでも不安定ならプロンプト末尾で明示する

重要なのは、Codexの言語設定はスイッチ式ではなく、指示と文脈の組み合わせで効くという点です。AGENTS.mdを整えたうえで、必要に応じてタスクごとの指示を補うと安定しやすくなります。

---

WindowsではCLIとCodexアプリを分けて考えること

Windows環境で「codex 言語設定」と調べている人は、CLIをPowerShellやcmd.exeで使っているのか、VS Code拡張から使っているのか、Codexアプリを使っているのかを分けて考える必要があります。調査情報には、過去のCodex CLIについて「Windowsは実験的でWSL推奨」とする記述がありました。一方で、OpenAIのリリースノートでは2026年3月4日にWindows版Codexアプリが案内されています。

つまり、WindowsでCodexを使う場合でも、CLIの挙動とWindows版アプリの挙動を同じものとして扱わない方がよいです。CLIではターミナル、シェル、設定ファイルの場所が影響します。アプリではサインイン、タスク管理、ワークツリー、差分レビューなど、アプリ側の体験が中心になります。

言語設定については、どの入口でも「AIに日本語で返すよう指示する」考え方は共通します。ただし、設定ファイルをどこから開くか、どのプロジェクト文脈を読んでいるか、承認やサンドボックスの扱いは環境によって違って見える可能性があります。

🪟 Windows利用時の整理

利用方法	注意点
PowerShellでCodex CLI	設定反映や承認挙動に環境差が出る可能性
cmd.exeでCodex CLI	一部設定が反映されやすいという報告あり
WSL上のCodex CLI	Linux環境として扱いやすい可能性
VS Code拡張	エディタで開いているファイル文脈を使いやすい
Windows版Codexアプリ	CLIとは別のアプリ体験として考える

特に初心者は、「WindowsでCodexが使える」という情報だけを見て、CLI、VS Code拡張、アプリを混同しがちです。日本語化がうまくいかない場合も、どの入口で起きているのかを先に切り分けると対処しやすくなります。

📌 Windowsで最初に決めること

質問	おすすめの考え方
ターミナルで作業したいか	CLIまたはWSLを検討
エディタ中心で作業したいか	VS Code拡張を検討
複数タスクを並行管理したいか	Codexアプリを検討
返答を日本語にしたいだけか	まずAGENTS.mdを確認

Windowsではパス表記やホームディレクトリの扱いも混乱しやすい部分です。~/.codex/AGENTS.mdという表記は、Windowsではユーザーフォルダ配下の.codexディレクトリに相当します。どの環境でCodexを起動しているかによって参照先が変わる可能性もあるため、設定ファイルの実体を確認することが大切です。

codex 言語設定を安定させる運用と関連設定

🧭 この章の見出し一覧

1. codex できることはコード編集だけでなく理解・テスト・リファクタまで広いこと
2. codex アプリとCLIとVS Code拡張は同じ目的でも設定の見え方が違うこと
3. 承認モードは言語設定より安全運用に直結するため最初に確認すること
4. model_reasoning_effortは日本語品質ではなく考える深さを調整する設定であること
5. MCPとWeb検索は便利だがネットワーク許可を広げすぎないこと
6. カスタムプロンプトは定型の日本語依頼を短縮する手段であること
7. Git管理とバックアップはCodex利用前の最低限の守りであること
8. 総括：codex 言語設定のまとめ

codex できることはコード編集だけでなく理解・テスト・リファクタまで広いこと

「codex できること」を知っておくと、言語設定の意味も理解しやすくなります。Codexは単にコードを書くだけのツールではなく、コード理解、バグ修正、リファクタリング、テスト作成、ドキュメント整理、設定ファイルの調整など、開発作業全体を支援するエージェントとして紹介されています。

OpenAI公式のCodexページでも、CodexはChatGPTのコーディングエージェントとして、開発からリリースまでを支援するものとして説明されています。参照元はOpenAI公式ページです。
https://openai.com/ja-JP/codex/

言語設定が重要になるのは、Codexが広い作業を扱うからです。コードの修正だけなら英語でも何とかなるかもしれませんが、設計方針、変更理由、リスク、テスト結果、次の作業を説明してもらう場合、日本語で返ってくる方が判断しやすい人は多いでしょう。

🧰 Codexで扱いやすい作業

作業	具体例	日本語設定が効く場面
コード理解	認証処理の場所を探す	構造説明を日本語で読める
バグ修正	エラー原因を調べて直す	原因と対処を理解しやすい
リファクタリング	大きな関数を分割する	変更意図を追いやすい
テスト作成	ユニットテストを追加する	テスト観点を日本語で確認できる
ドキュメント整理	READMEや手順書を整える	日本語ドキュメントに向く

ただし、すべてを日本語化すればよいわけではありません。プログラミングでは、エラーメッセージ、ライブラリ名、API名、コマンド、設定キーなどは英語のまま扱う方が検索しやすいです。Codexへの指示でも「説明は日本語、技術用語やコマンドは原文維持」と書いておくと、実用性が上がります。

📋 おすすめの言語方針

項目	方針
説明文	日本語
コマンド	原文のまま
エラー文	原文を残し、日本語で補足
コード	既存プロジェクトに合わせる
ドキュメント	読者に合わせて日本語・英語を指定

Codexの価値は、作業そのものを肩代わりするだけでなく、判断材料を出してくれる点にもあります。だからこそ、言語設定は単なる好みではなく、レビューしやすさ、引き継ぎやすさ、事故の減らしやすさにも関わる設定だと考えるとよいでしょう。

---

codex アプリとCLIとVS Code拡張は同じ目的でも設定の見え方が違うこと

codexアプリ、Codex CLI、VS Code拡張は、どれもコーディング支援という目的は近いですが、操作感はかなり違います。CLIはターミナルで動き、VS Code拡張はエディタ内で動き、Codexアプリは複数タスクや差分レビューを扱うアプリとして位置づけられています。

言語設定の観点では、CLIは~/.codex/AGENTS.mdや~/.codex/config.tomlを意識しやすいです。VS Code拡張では、設定画面や開いているファイル文脈、Auto contextのような機能が関係します。Codexアプリでは、タスクごとの指示やワークツリーの扱いが重要になります。

noteの記事では、VS Code拡張のチャットパネルでモデル、Reasoning Effort、Approval Modesを選べることが紹介されていました。Zennの記事では、CLIの設定としてAGENTS.mdやconfig.toml、MCPなどが整理されています。つまり、同じCodexでも、入口によって見える設定項目が変わります。

🖥 入口別の違い

入口	向いている使い方	言語設定の見方
Codex CLI	ターミナルで直接作業	AGENTS.mdとconfig.tomlを重視
VS Code拡張	エディタ内で相談・修正	開いているファイル文脈も影響
Codexアプリ	複数タスクや差分レビュー	タスク指示とプロジェクト設定を分ける
ChatGPT内のCodex関連機能	クラウドやモバイルから依頼	ChatGPT側の設定や会話文脈も影響

ここで大切なのは、「どれを使えば日本語になるか」ではなく、どの入口でも日本語指示を渡せる状態にしておくことです。共通AGENTS.mdを整え、プロジェクト側のAGENTS.mdも必要に応じて置き、タスク単位で例外を指示する形が扱いやすいです。

🧭 入口選びの目安

状況	選びやすい入口
コマンド操作に慣れている	CLI
コードを見ながら相談したい	VS Code拡張
並行タスクを管理したい	Codexアプリ
外出先から軽く依頼したい	ChatGPT側のCodex機能

言語設定で迷ったら、まず「今どのCodexを使っているのか」を確認してください。CLIの解説を読んでアプリ側を直そうとしても、設定場所が違って見えるため混乱しやすくなります。

---

承認モードは言語設定より安全運用に直結するため最初に確認すること

言語設定に集中していると見落としがちですが、Codexを使ううえで重要なのが承認モードです。承認モードとは、Codexがファイル編集やコマンド実行をする際に、どこまで自動で進めるかを決める設定です。

調査情報では、CLIの/modeでsuggest、auto-edit、full-autoのようなモードが紹介されています。また、config.tomlではapproval_policyやsandbox_modeを設定する例もあります。VS Code拡張側では、Chat or Plan、Agent、Agent Full Accessのような考え方が紹介されていました。

日本語で返ってくるようになっても、承認モードが強すぎると、意図しないファイル変更やコマンド実行が起きる可能性があります。逆に、承認が厳しすぎると毎回止まって作業が進みにくいです。初心者は、まず安全寄りのモードから始めるのが無難です。

🔐 承認モードの考え方

モードの方向性	内容	向いている人
読み取り中心	提案や調査が中心	初心者、レビュー目的
編集は許可	ファイル編集は任せる	Git管理済みの開発
フル自動	編集やコマンドを広く許可	仕組みを理解している上級者
都度承認	重要操作前に確認	安全と効率のバランスを取りたい人

言語設定と承認モードは別物ですが、実務ではセットで考えるべきです。日本語で丁寧に説明してくれても、危険な操作を自動で進めてしまう設定なら、安心して任せにくくなります。

⚙️ config.tomlの設定例

model = "gpt-5-codex"
model_reasoning_effort = "medium"
sandbox_mode = "workspace-write"
approval_policy = "untrusted"

上記は一例です。実際の設定値は、利用しているCodexのバージョンや環境によって扱いが変わる可能性があります。提供情報の中にも、PowerShellでは承認設定が期待通り効かなかったがcmd.exeでは反映されたという報告がありました。Windows環境では特に、設定を書いたあとに実際の挙動を確認することが大切です。

---

model_reasoning_effortは日本語品質ではなく考える深さを調整する設定であること

model_reasoning_effortは、codexの言語設定と混同されやすい項目です。名前に「reasoning」とある通り、これはモデルがどれくらい深く考えるかに関わる設定であり、日本語にするための設定ではありません。

調査情報では、low、medium、highのような推論レベルが紹介されています。lowは速度重視、mediumはバランス、highは複雑なタスク向けという説明が多く見られました。日常的な開発ではmediumが扱いやすいとする情報もあれば、highを推す記事もあります。

ここで大切なのは、「日本語が自然になるかどうか」と「深く考えるかどうか」は別問題だという点です。日本語で返してほしいならAGENTS.mdやプロンプトで指定します。複雑なリファクタリングや設計相談をしたいなら、model_reasoning_effortを上げることを検討します。

🧠 reasoning effortの目安

設定	向いている作業	注意点
low	軽い修正、短い質問	複雑な判断には不向きな場合あり
medium	日常的な開発作業	まず試す設定として扱いやすい
high	大きな設計、複雑な調査	時間や利用量が増えやすい可能性
xhighなど	対応環境がある場合の高難度作業	利用できるかは環境依存

言語設定で悩んでいる人が、いきなりhighにしても、日本語化の根本解決にはなりにくいです。むしろ、返答言語の指示が曖昧なままhighにすると、長く詳しい英語回答が返ってくる可能性もあります。

✅ 使い分けの考え方

目的	触る設定
日本語で返してほしい	AGENTS.md、プロンプト
回答を短くしたい	AGENTS.md、model_verbosity
複雑な問題を深く考えてほしい	model_reasoning_effort
勝手に進める範囲を変えたい	approval_policy、sandbox_mode

つまり、model_reasoning_effortは「日本語設定」ではなく、「思考の深さ設定」です。codexの設定を調べるときは、この違いを押さえておくと、不要な設定変更を減らせます。

---

MCPとWeb検索は便利だがネットワーク許可を広げすぎないこと

CodexはMCPやWeb検索と組み合わせることで、外部ツールや最新情報を扱いやすくなります。調査情報では、Playwright、Context7、Notion、Markitdown、Chrome DevTools、Figma、GitHub MCPなどが紹介されていました。

一方で、ネットワークアクセスを許可すると、外部サイトや外部ドキュメントに含まれる不正な指示、いわゆるプロンプトインジェクションのリスクも考える必要があります。Microsoft有志の記事でも、ネットワークアクセスやサンドボックス、プロンプトインジェクションへの注意が整理されていました。

言語設定だけをしたい初心者は、最初からMCPやWeb検索を有効にしなくても問題ありません。まずはローカルのコードを日本語で説明してもらう状態を作り、その後、必要になったらMCPを追加する方が安全に進めやすいです。

🌐 MCPとWeb検索の使いどころ

機能	できること	注意点
Web検索	最新情報を調べる	情報源の信頼性確認が必要
Context7	ライブラリ文書を参照	APIキーや設定が必要な場合あり
Playwright	ブラウザ操作や検証	ローカル環境の影響を受ける
GitHub MCP	IssueやPR連携	権限管理が重要
Figma MCP	デザイン情報の参照	デスクトップアプリや接続設定が必要

Web検索を有効にする設定例として、config.tomlに次のような記述が紹介されています。ただし、環境やバージョンによって仕様が変わる可能性があるため、公式ドキュメントや現在の設定画面も確認した方がよいでしょう。

[tools]
web_search = true

🔒 安全に使うための考え方

方針	理由
必要な時だけWeb検索を使う	外部情報の混入を減らすため
認証情報をプロンプトに貼らない	漏えいリスクを下げるため
MCPの権限を広げすぎない	不要な操作を避けるため
出力をそのまま本番反映しない	誤りや危険な変更を確認するため

MCPやWeb検索は便利ですが、codexの言語設定とは別の話です。まず日本語でやり取りできる土台を整え、その後に外部連携を足すと、トラブル時の切り分けがしやすくなります。

---

カスタムプロンプトは定型の日本語依頼を短縮する手段であること

Codexには、カスタムプロンプトを使って定型作業を呼び出す考え方があります。調査情報では、~/.codex/prompts/にMarkdownファイルを置くと、カスタムコマンドとして使えると紹介されていました。Claude Codeのスラッシュコマンドに近い使い方として理解するとわかりやすいです。

これは、言語設定を補助する手段としても使えます。たとえば、毎回「変更点を日本語で要約して、リスクと確認方法も書いて」と入力する代わりに、カスタムプロンプトとして保存しておけば、作業報告の形式をそろえやすくなります。

ただし、カスタムプロンプトは全プロジェクト共通の置き場として紹介されており、プロジェクトごとのpromptsディレクトリが同じように使えるとは限らないようです。プロジェクト固有ルールはAGENTS.md、繰り返し使う依頼文はカスタムプロンプト、と分けるのが扱いやすいでしょう。

📄 カスタムプロンプトに向く依頼

用途	例
日本語レビュー	変更差分を日本語でレビューする
テスト追加	対象コードに必要なテスト観点を出す
変更要約	Git差分を日本語で短くまとめる
リスク確認	本番影響や破壊的変更の可能性を見る
ドキュメント化	READMEや手順書を整える

たとえば、~/.codex/prompts/review-ja.mdのようなファイルを作り、次のような内容を入れておくと、レビュー時の日本語出力を安定させやすくなります。

差分を日本語でレビューしてください。

観点:
- 重大なバグ
- 仕様変更の影響
- テスト不足
- セキュリティ上の懸念
- 読みにくい実装

出力は、重要度の高い指摘から順に簡潔にまとめてください。

🧩 AGENTS.mdとの違い

項目	AGENTS.md	カスタムプロンプト
役割	常に守る基本ルール	必要な時に呼び出す定型依頼
内容	言語、作業方針、安全ルール	レビュー、要約、テスト作成など
粒度	全体方針	タスク単位
更新頻度	低め	高め

カスタムプロンプトは、codexの言語設定そのものではありません。しかし、毎回の出力形式を日本語でそろえるうえではかなり役立ちます。特にチーム運用では、レビューや完了報告の形式を固定できるため、作業の受け取りやすさが上がります。

---

Git管理とバックアップはCodex利用前の最低限の守りであること

Codexを使う前に、Git管理はできるだけ整えておきたいところです。調査情報の中でも、AIコーディングツールでは意図しない変更や削除に備えてGit管理が重要だと説明されていました。これはCodexに限らず、AIエージェント全般に当てはまる注意点です。

特に、承認モードを緩めたり、ファイル編集を任せたりする場合、作業前の状態に戻せることが大切です。Gitで差分を確認できれば、Codexが何を変えたのかを把握しやすくなります。変更が不要なら取り消し、よければコミットするという流れを作れます。

言語設定だけを調べている人にとっては遠回りに見えるかもしれません。しかし、Codexが日本語で丁寧に説明してくれても、ファイル変更の結果を確認できなければ運用としては不安が残ります。日本語化と安全運用はセットで考えるのが現実的です。

🛡 Codex利用前の安全チェック

チェック項目	理由
Git管理されているか	変更前に戻しやすくするため
作業前の差分が空か	Codexの変更だけを見分けるため
重要ファイルのバックアップがあるか	DBや生成物の消失に備えるため
承認モードを理解しているか	自動変更の範囲を把握するため
secretを貼り付けていないか	APIキー漏えいを避けるため

Gitを使っている場合、Codexに作業を依頼する前に次のような確認をしておくと安心です。

git status

差分がある状態でCodexに依頼すると、元からあった変更とCodexの変更が混ざります。個人開発ならまだしも、チーム開発や本番運用では確認が難しくなります。可能であれば、作業前に現在の差分を把握しておきましょう。

📦 バックアップが特に必要なもの

対象	理由
データベース	コードより復旧が難しい場合がある
環境設定ファイル	認証や接続に関わるため
生成済み成果物	再生成に時間がかかる場合がある
手作業で作った素材	Git管理外になりやすいため

Codexの言語設定を整える目的は、作業を理解しやすくすることです。その効果を活かすには、変更内容を確認できる状態、戻せる状態、危険な操作を止められる状態を合わせて作っておく必要があります。

---

総括：codex 言語設定のまとめ

最後に記事のポイントをまとめます。

1. codex 言語設定の基本は、AGENTS.mdに日本語で回答する指示を書くことである。
2. ~/.codex/AGENTS.mdは全プロジェクト共通のふるまい設定として使う場所である。
3. プロジェクト直下のAGENTS.mdは、そのリポジトリ固有のルールを書く場所である。
4. UI言語とAIの返答言語は別物である。
5. アプリごとに言語を変えたい場合は、共通ルール、プロジェクトルール、タスク指示を分けて考えるべきである。
6. codex 初心者は、config.tomlより先にAGENTS.mdを整える方が迷いにくい。
7. 日本語化が効かない時は、ファイル名、置き場所、起動ディレクトリ、下位階層のAGENTS.mdを確認するべきである。
8. Windowsでは、CLI、VS Code拡張、Codexアプリを混同しないことが重要である。
9. codex できることは、コード生成だけでなく、理解、修正、テスト、リファクタ、ドキュメント化まで広い。
10. 承認モードは、言語設定以上に安全運用へ直結する設定である。
11. model_reasoning_effortは日本語化の設定ではなく、考える深さを調整する設定である。
12. MCPやWeb検索は便利だが、ネットワーク許可を広げすぎるとリスクも増える。
13. カスタムプロンプトは、定型の日本語レビューや要約を短縮する手段である。
14. Git管理とバックアップは、Codex利用前の最低限の守りである。
15. codex 言語設定は、単独のスイッチではなく、指示ファイル、起動場所、利用環境、会話文脈の組み合わせで整えるものである。

記事作成にあたり参考にさせて頂いたサイト

• https://www.reddit.com/r/codex/comments/1rg75jl/after_the_latest_codex_app_update_i_cant_switch/?tl=ja
• https://biz.addisteria.com/codex-cli/
• https://www.reddit.com/r/Warhammer40k/comments/scamxf/change_codex_language_in_app/?tl=ja
• https://note.com/hip_tiger5987/n/n658d79c916e6
• https://zenn.dev/hokuto_tech/articles/97fa88f7805a23
• https://help.openai.com/ja-jp/articles/6825453-chatgpt-%E3%83%AA%E3%83%AA%E3%83%BC%E3%82%B9%E3%83%8E%E3%83%BC%E3%83%88
• https://zenn.dev/dely_jp/articles/codex-cli-matome
• https://openai.com/ja-JP/codex/
• https://zenn.dev/microsoft/articles/codex_fully_understood
• https://substack.com/home/post/p-195343521

当サイトについて

当サイトでは、インターネット上に散らばるさまざまな情報を収集し、AIを活用しながら要約・編集を行い、独自の切り口で見解を交えながらわかりやすい形でお届けしています。 情報の整理・編集にあたっては、読者やオリジナル記事の筆者へご迷惑をおかけしないよう、細心の注意を払って運営しておりますが、万が一、掲載内容に問題がある場合や修正・削除のご要望がございましたら、どうぞお気軽にお問い合わせください。 迅速に対応をさせていただきます。 その際には、該当記事の URLやタイトルをあわせてお知らせいただけますと、より速やかに対応 することができますのでそちらもご協力いただけますと大変幸いでございます。 今後とも当サイトをよろしくお願いいたします。