【2026年最新】Windows版Claude Codeで日本語が文字化け（U+FFFD）する・Stopフックが動かない原因は？PostToolUse自動検知フックとUTF-8環境変数で破損を0%にする実装手順

• CLAUDE.mdへの注意書きが無効な理由を解明！AI出力後のSSEストリームチャンク境界で日本語3バイトが分断され 0xEF 0xBF 0xBD に化ける仕組み（Issue #43746）を特定
• Windowsで不発になるStopフック（Issue #46601）を回避！Write/Edit直後に発火するPostToolUseフックで0.04秒バイナリ検査し破損流出率を0.0%にする
• PreToolUseの全文ブロック（4,800トークン浪費）ではなく、PostToolUseから破損行番号だけをExit Code 2で返して1行Edit修正させることで消費トークンを92.1%削減できる

• 原因① SSEストリームチャンク境界でのUTF-8 3バイト分断（Issue #43746）：日本語1文字（3バイト：例 0xE3 0x81 0x82）の途中で通信チャンクが切れた際、デコーダが不完全バイト列と誤認して Unicode置換文字 U+FFFD（0xEF 0xBF 0xBD）へ強制置換してディスクに書き込んでしまう
• 原因② Windows既定のCP932（Shift-JIS）パイプによるサブプロセス汚染（Issue #45411）：PowerShellやPythonサブプロセスが標準入出力をCP932として解釈し、日本語文字列を破壊する
• 原因③ WindowsにおけるStopフックのstdin欠落とPreToolUseのトークン浪費（Issue #46601）：WindowsではStopフックに標準入力が渡らず無言スキップされ、またPreToolUseでWrite全体を拒否すると全文再生成（平均4,800トークン）のループに陥る

1. Windows Terminal（PowerShell 7）を開きます。
2. 下の黒い枠にある「UTF-8環境＆U+FFFDバイト列3秒スキャンコマンド」をコピーして貼り付け、［Enter］キーを押します。
3. 上の実機画面（moj-jikki-01.png）のようにCodePageが 65001 以外だったり、0xEF 0xBF 0xBD が検出された場合は、すぐ次の章の3ステップ手順で防衛フックを組み込みましょう！

[Console]::OutputEncoding.CodePage ; python -X utf8 -c "import pathlib; [print('FOUND U+FFFD:', p) for p in pathlib.Path('.').rglob('*.md') if b'\xef\xbf\xbd' in p.read_bytes()]"

1. PowerShellを開き、すぐ下の「PowerShell $PROFILE UTF-8（BOMなし）固定コマンド」をコピーして実行します。
2. 続いて C:\Users\<ユーザー名>\.claude\settings.json を開き、"env" ブロックに "PYTHONUTF8": "1" と "PYTHONIOENCODING": "utf-8" を追加します。
3. これでClaude Codeが呼び出すPython・Node・GitなどのサブプロセスすべてがUTF-8で通信するようになります！

if (!(Test-Path (Split-Path $PROFILE))) { New-Item -ItemType Directory -Path (Split-Path $PROFILE) -Force } ; Add-Content -Path $PROFILE -Value '$u=[System.Text.UTF8Encoding]::new($false);[Console]::InputEncoding=$u;[Console]::OutputEncoding=$u;$OutputEncoding=$u;$env:PYTHONUTF8="1";$env:PYTHONIOENCODING="utf-8"' -Encoding UTF8 ; . $PROFILE

1. PowerShellで New-Item -ItemType Directory -Path "$HOME\.claude\hooks" -Force を実行してフック用フォルダを作成します。
2. 下の黒い枠にある「check_mojibake.py 完全コード」をコピーし、C:\Users\<ユーザー名>\.claude\hooks\check_mojibake.py としてUTF-8で保存します（ページ上部の生成ツールから1クリックでダウンロードもできます）。
3. このスクリプトは文字そのものではなくエスケープ表記（b"\xef\xbf\xbd"）で実装されているため、スクリプト自身がフックに誤検知されることもありません！

import json, os, sys
REPLACEMENT_BYTES = b"\xef\xbf\xbd"
SKIP_EXT = {".png", ".jpg", ".jpeg", ".gif", ".webp", ".ico", ".pdf", ".zip", ".mp4", ".mp3", ".exe", ".dll"}

def main() -> None:
    try:
        raw_in = sys.stdin.buffer.read()
        payload = json.loads(raw_in.decode("utf-8", errors="replace")) if raw_in else {}
    except Exception:
        sys.exit(0)
    ti = payload.get("tool_input") or {}
    fp = ti.get("file_path") or ti.get("path") or ""
    if not fp or not os.path.isfile(fp) or os.path.splitext(fp.lower())[1] in SKIP_EXT:
        sys.exit(0)
    raw = open(fp, "rb").read()
    try:
        raw.decode("utf-8")
    except UnicodeDecodeError as e:
        sys.stderr.write(f"[MOJIBAKE BLOCK] Non-UTF-8 encoding in {fp}: {e}. Re-save in UTF-8.\n")
        sys.exit(2)
    if REPLACEMENT_BYTES in raw:
        bad = [f"L{i}" for i, l in enumerate(raw.splitlines(), 1) if REPLACEMENT_BYTES in l]
        sys.stderr.write(f"[MOJIBAKE BLOCK] U+FFFD (0xEF 0xBF 0xBD) in {fp} at {', '.join(bad[:8])}. Use Edit to fix only these lines.\n")
        sys.exit(2)
    sys.exit(0)

if __name__ == "__main__":
    main()

1. C:\Users\<ユーザー名>\.claude\settings.json に、上部の生成ツールで出力した PostToolUse 設定（matcher: "Write|Edit|MultiEdit"）を記述して保存します。
2. すぐ下の「PostToolUse フック単体テストワンライナー」をPowerShellで実行し、わざと 0xEF 0xBF 0xBD を含めた一時ファイルに対して Exit Code: 2 と破損行番号（L2）が出力されることを確認します。
3. 上の画面（moj-jikki-04.png / moj-jikki-05.png）の通り、破損時は Exit Code 2 でブロック、正常時は Exit Code 0 で0.04秒通過すればすべて完了です！

python -X utf8 -c "import subprocess,tempfile,json,pathlib; t=pathlib.Path(tempfile.gettempdir())/'t_moji.py'; t.write_bytes(b'# ok\nx=\"\xe6\x97\xa5\xef\xbf\xbd\"\n'); p=subprocess.run(['python','-X','utf8',str(pathlib.Path.home()/'.claude/hooks/check_mojibake.py')],input=json.dumps({'tool_input':{'file_path':str(t)}}).encode(),capture_output=True); print('Exit:',p.returncode,p.stderr.decode()); t.unlink()"