Codexの出力で日本語が「縺ゅ→縺」のように崩れたり、「□□□」(豆腐)や「???」になったり——日本語の文字化けは、特にWindowsのターミナルで頻発する定番トラブルです。
原因はほぼ「文字コード」か「フォント」のどちらか。この記事の手順で順に直していきましょう。
この記事でわかること
- ✅ 文字化けの2大原因(文字コード/フォント)の見分け方
- ✅ Windowsでの直し方(最短ルートはWindows Terminal)
- ✅ Mac・VS Code・ファイル出力での対処
⚠️ 本記事は OpenAI 公式とは無関係の解説記事です。
まず結論:Windowsなら「Windows Terminal」を使う
原因調査より先に、最も効果的な解決策をお伝えします。
Windowsで文字化けするなら、標準の「コマンドプロンプト」ではなく Windows Terminal(Microsoft Store・無料)を使ってください。 これだけで大半の文字化けが解消します。
古いコマンドプロンプトは日本語まわりの初期設定が旧式(Shift_JIS系)のため、UTF-8前提のCodexと相性が悪いのです。
文字化けの2大原因と見分け方
| 見た目 | 原因 | 直し方 |
|---|---|---|
| 「縺ゅ→縺」のような崩れ | 文字コードの不一致 | UTF-8に統一 |
| 「□□□」(豆腐)「???」 | フォントが日本語非対応 | 日本語フォントに変更 |
Windowsでの直し方
1. Windows Terminalに乗り換える(最優先)
前述の通り、これが最短ルートです。インストール後、Windows TerminalからCodex CLIを使ってください。
2. 文字コードをUTF-8にする
それでも崩れる場合、コードページをUTF-8に:
chcp 65001
毎回打つのが面倒なら、PowerShellのプロファイルに追記して恒久化できます。
3. システムロケールをUTF-8対応にする(根本対策)
- 設定 → 時刻と言語 → 言語と地域 → 管理用の言語の設定
- 「システムロケールの変更」→ 「ベータ: ワールドワイド言語サポートで Unicode UTF-8 を使用」にチェック
- 再起動
⚠️ 一部の古い日本語アプリで逆に文字化けすることがあります。問題が出たらチェックを外して戻せます。
4. フォントを日本語対応にする
豆腐(□)になる場合はフォントの問題。Windows Terminalの設定で、フォントを「MS Gothic」「BIZ UDゴシック」「Cascadia Code(日本語フォールバック付き環境)」などに変更します。
Macでの直し方
Macは標準でUTF-8のため文字化けはまれですが、起きた場合:
- ターミナル → 設定 → プロファイル → 詳細 → **テキストエンコーディングが「Unicode (UTF-8)」**になっているか確認
- 環境変数を確認:
echo $LANG
# ja_JP.UTF-8 や en_US.UTF-8 ならOK。空なら以下を ~/.zshrc に追加
export LANG=ja_JP.UTF-8
VS Code拡張で文字化けする場合
- VS Code右下のエンコーディング表示が「UTF-8」か確認(クリックで変更可能)
- 設定で
"files.encoding": "utf8"を確認 - 統合ターミナルの文字化けは、上記のWindows対処(chcp/フォント)がそのまま効きます
詳しい拡張の使い方は VS Code拡張ガイド を参照。
Codexが出力した「ファイル」が文字化けする場合
ターミナル表示は正常なのに、生成されたファイルをExcelやメモ帳で開くと化けるパターン。
- 原因:開く側のアプリが文字コードを誤判定(特にExcelでCSVを開くとき)
- 対処①:Codexに「BOM付きUTF-8で保存して」と頼む(Excel対策の定番)
- 対処②:「Shift_JISで保存して」と頼む(古いシステムに渡す場合)
Codexは保存時の文字コード指定にも対応できるので、用途を伝えるのが早いです。
それでも直らないとき
- エラー文・化けたテキストの見た目をそのまま Codex に貼って「文字化けの原因を調べて」と聞く(意外と有効)
- 別の入り口で回避:Web版はブラウザ表示なのでターミナル起因の文字化けが起きません
- 他の症状は トラブルシューティング総合ガイド へ
よくある質問(FAQ)
Q. 「chcp 65001」は毎回打たないとダメですか?
A. PowerShellのプロファイル($PROFILE)に追記すれば毎回自動で適用されます。ただしWindows Terminalに乗り換えるほうが根本的です。
Q. 日本語で指示すると精度が落ちますか?
A. 落ちません。Codexは日本語プロンプトに正式対応しています。文字化けは「表示」の問題で、AIの理解とは別物です。
Q. コミットメッセージの日本語が化けます
A. gitの設定です。git config --global core.quotepath false と、ターミナルのUTF-8化で解消することが多いです。
Q. Web版でも文字化けしますか?
A. ほぼ起きません。ブラウザはUTF-8前提のため、ターミナル起因の化けとは無縁です。化ける場合はブラウザのフォント設定を確認してください。
Q. 豆腐(□)と「縺ゅ→縺」は同じ原因ですか?
A. 別原因です。豆腐はフォント(日本語グリフがない)、「縺ゅ→縺」は文字コード不一致。本記事の表で見分けて対処してください。
まとめ
Codexの日本語文字化けは、Windowsなら「Windows Terminalに乗り換える」が最短の解決策。それでも残る場合は、文字コード(chcp 65001/UTF-8統一)とフォント(日本語対応に変更)の2軸で対処すれば直ります。
生成ファイルの化けは「BOM付きUTF-8で保存して」と頼むのが定番。他のトラブルは トラブルシューティング総合ガイド、Windows環境全般は Windows版ガイド もどうぞ。