Codexを日本語で使う｜回答の日本語化と文字化けの直し方

日本語で使えるのか — 「応答の言語」と「画面の言語」を分ける

最初に押さえておきたいのは、Codex における「日本語」には二つの意味があり、両者は別物だということだ。一つは Codex が返してくる説明や提案の言語、もう一つは CLI の操作画面に並ぶラベルやプロンプトの言語である。前者は基盤モデルが多言語に対応しているため、日本語で話しかければ日本語で応答が返る。実際、英語が読みづらいと感じるなら、最初の一言を日本語にするだけで会話全体の言語が日本語に寄っていく。一方で後者、つまりターミナル上の操作画面やコマンドのヘルプ表示は英語のままで、インターフェース全体が日本語へ翻訳(ローカライズ)されるわけではない。Codex CLI はターミナルで動くツールとして提供されており、その操作系は英語で統一されている(出典: https://developers.openai.com/codex/cli/features )。「日本語化」という言葉で UI まるごとの翻訳を期待すると肩透かしになるが、実務で効いてくるのは応答の言語のほうだ。ここを分けて捉えておくと、後の設定で迷わなくなる。

応答を日本語に固定する — その場の指示と AGENTS.md

応答を日本語にする方法は、手軽な順に次の三つだ。場面に応じて使い分けると、毎回お願いし直す手間を減らせる。

1. その場で日本語の指示を与える: 単純に日本語で質問・依頼をすれば、応答も日本語で返ってくる。試しに一度だけ日本語で使いたいときは、これで十分だ。
2. プロジェクトの AGENTS.md に書く: リポジトリ直下に置いた AGENTS.md に「ユーザーへの説明や応答は常に日本語で行う」と一行加えておくと、そのプロジェクトでの作業中は日本語が既定になる。AGENTS.md は Codex が作業時に読み込む指示書で、繰り返し伝えたい前提を書き留めておくための仕組みだ(出典: https://developers.openai.com/codex/guides/agents-md )。
3. ユーザー全体の ~/.codex/AGENTS.md に書く: どのプロジェクトでも日本語にしたいなら、ホーム配下の ~/.codex/AGENTS.md に同じ指示を置く。プロジェクト個別の設定より広い範囲に効く。

AGENTS.md の書き方や定番の項目は「Codex の AGENTS.md とは — エージェントへの指示書の書き方」(/articles/codex-agents-md)に詳しい。よく使う依頼文そのものを部品化したいときは、カスタムプロンプトを併用する手もある(/articles/codex-custom-prompts)。いずれにせよ、応答の言語は設定項目ではなく「指示」で決まるのが Codex の考え方だ。

ユーザー全体とプロジェクト単位を使い分ける

~/.codex/AGENTS.md はあなたの全作業に効く土台で、各リポジトリ直下の AGENTS.md はそのプロジェクト固有の上書きになる。普段は日本語で、英語圏チームのリポジトリだけは英語で、といった出し分けは、ユーザー全体に日本語の既定を置きつつ、該当リポジトリの AGENTS.md で言語の指示を上書きすれば実現できる。広い既定と局所の例外を二層で持っておくと管理がほどける(出典: https://developers.openai.com/codex/guides/agents-md )。

指示の書き方 — コードは英語、説明は日本語

応答を日本語にするとき、ひとつ注意したいのが「何を日本語にして、何を英語のままにするか」だ。説明・要約・レビューコメントといった人間向けの文章は日本語が読みやすい。一方で、変数名や関数名、コード中のコメント、コミットの体裁などは英語で統一しておいたほうが、既存コードや外部ライブラリとの一貫性を保ちやすい。そこで AGENTS.md には「ユーザーへの説明は日本語、ただしコードの識別子やコメントは英語で書く」と、対象を分けて書いておくと意図どおりに動きやすい。曖昧に「日本語で」とだけ伝えると、コード中の識別子まで日本語になって読みにくくなることがある。言語の指定は、適用範囲まで添えてはじめて過不足がなくなる。細かな指示を恒常化する発想は前掲のカスタムプロンプトとも地続きで、よく出す注文ほど一度書いて使い回すのが効率的だ。

文字化けを直す — ターミナルの文字コードを UTF-8 にそろえる

日本語の応答が「??」や見慣れない記号として表示される文字化けは、Codex の応答そのものではなく、それを映すターミナル側の設定に原因があることがほとんどだ。Codex CLI はあくまでターミナル上で動くため、表示と入力の文字コードが日本語(UTF-8)に合っていないと、正しい文字列でも画面で崩れて見える(出典: https://developers.openai.com/codex/cli/features )。次の順で環境を整えると、多くの文字化けは解消する。

1. ターミナルの文字コードを UTF-8 にする: 使っているターミナルの設定で、文字エンコーディングを UTF-8 に明示する。古い既定のままだと日本語が崩れやすい。
2. ロケールを日本語/UTF-8 にそろえる: macOS や Linux では環境変数の LANG を ja_JP.UTF-8(または en_US.UTF-8 などの UTF-8 ロケール)に設定しておくと、表示と入力の土台がそろう。
3. 日本語を含むフォントを使う: 等幅でも日本語グリフを持つフォントに切り替える。フォント側にグリフがないと、文字コードが正しくても豆腐(□)になる。

それでも直らないときは、コピー&ペースト経路や SSH 越しの端末設定など、Codex の外側で文字コードが変換されていないかを疑うとよい。切り分けの勘どころは「Codex の応答自体は正しく、見え方だけが崩れている」と捉えることだ。

Windows で文字化けが起きやすい理由

Windows はコンソールの既定コードページが UTF-8 でない場合があり、これが文字化けの典型的な原因になる。コマンドプロンプトなら chcp 65001 でコードページを UTF-8 に切り替え、できれば UTF-8 を既定で扱える Windows Terminal を使うと安定する。あわせてフォントを日本語対応のものにしておけば、表示と入力の双方で崩れにくくなる。

VS Code 拡張やアプリでの日本語 — 入力も応答も同じ考え方

ターミナルだけでなく、VS Code の拡張やデスクトップアプリから Codex を使う場合も、日本語の扱いは基本的に同じだ。入力欄には日本語をそのまま打ち込めるし、応答を日本語にしたいなら、これまでと同様に日本語で依頼するか、リポジトリの AGENTS.md に言語の指示を書いておけばよい。エディタ統合での Codex の位置づけは「VS Code の Codex とは何か」(/articles/what-is-codex-in-vscode)にまとめてある。エディタ上では端末ほど文字化けに悩まされにくいが、出力をターミナルパネルで受け取る構成なら、前節のエンコーディングの考え方がそのまま当てはまる。どの入口から使うにせよ、「応答の言語は指示で決め、表示の崩れは環境で整える」という二本立てで考えれば迷わない(出典: https://developers.openai.com/codex/guides/agents-md )。

まとめ — 応答は指示で、表示は環境で

Codex を日本語で使う鍵は、論点を二つに分けることだ。応答の言語は設定項目ではなく指示で決まる。その場で日本語に頼むのが最も手軽で、恒常化したいならプロジェクトの AGENTS.md に、全作業に効かせたいなら ~/.codex/AGENTS.md に「常に日本語で回答する」と書く(出典: https://developers.openai.com/codex/guides/agents-md )。このとき、説明は日本語・コードの識別子やコメントは英語、と適用範囲まで添えると破綻しにくい。一方の文字化けは、Codex ではなくターミナルの文字コードの問題であることが多い。表示と入力を UTF-8 にそろえ、Windows なら chcp 65001 や Windows Terminal を使い、日本語フォントを当てれば多くは直る(出典: https://developers.openai.com/codex/cli/features )。CLI の操作画面そのものは英語のままだが、実務で効くのは応答の言語のほうだ。指示と環境を切り分けておけば、日本語のまま無理なく使い続けられる。