T05
python や claude の出力を変数に入れると文字化けする
症状
画面に直接出すと読めるのに、$x = python ... で受け取ると「譌・譛ャ」のような文字になる。ログに書くと、そのまま化けて残る。
30秒で確かめる
PowerShell(Windows PowerShell 5.1)に貼って実行します。一時フォルダ(%TEMP% の下)にだけファイルを作ります。最後に REPRODUCED と出たら、あなたの PC で起きています。
$d = Join-Path $env:TEMP ('cc-trap-' + (Get-Date -Format 'yyyyMMddHHmmss')); New-Item -ItemType Directory $d -Force | Out-Null
$pyv = & python -c "import sys; print('%d.%d.%d' % sys.version_info[:3])" 2>$null
if (-not $pyv) { 'CANNOT CHECK (python not found, or only the Microsoft Store stub: install Python from python.org)' } else {
"python $pyv"
[IO.File]::WriteAllText("$d\say.py", 'import sys; sys.stdout.buffer.write((chr(0x65e5)+chr(0x672c)).encode("utf-8"))')
$s = python "$d\say.py"
$want = [string][char]0x65E5 + [char]0x672C
"read with code page $([Console]::OutputEncoding.CodePage): " + (($s.ToCharArray() | ForEach-Object { '{0:X4}' -f [int]$_ }) -join ' ') + ' (want 65E5 672C)'
if ($s -ne $want) { 'REPRODUCED' } else { 'NOT REPRODUCED' }
}
なぜ起きるか
PowerShell はネイティブのプログラムの出力を [Console]::OutputEncoding(日本語の Windows では既定 932)で読む。相手が UTF-8 で書いていると、読み違える。
直し方
出力を読む側で [Console]::OutputEncoding を UTF-8 にする。送る側の Python は PYTHONIOENCODING を utf-8 に(次の T06)。両方そろえる。
[Console]::OutputEncoding = [System.Text.Encoding]::UTF8
$env:PYTHONIOENCODING = 'utf-8'
作者の PC での結果
2文字が別の4文字になった
作者の PC: Windows 11 / Windows PowerShell 5.1.26100 / Python 3.13.7 / Claude Code 2.1.304、日本語の Windows(コードページ 932)。2026-10-20〜22 に確認。
こんな言葉で探した人へ
関連
この穴を最初から踏まないようにした部品(書き込み先を絞る安全装置〈onFailure: block 付き〉、夜の無人実行、ファイルとフックの設定を調べる健康診断、CLAUDE.md の型、試験一式)は cc-win-kit にまとめています。
ほかの症状
- PowerShell の終了コードが、2 を返したのに 1 になる
- -File で渡した2つ目の引数が、エラーなしで消える
- -File で a,b と渡すと、配列にならず1つの文字列になる
- パイプで渡した日本語が ? になる(claude -p・python・git)
- 手で動かすと通る Python が、タスクスケジューラやリダイレクトのときだけ落ちる
- PYTHONIOENCODING を設定したのに、python -I だと効かない
- 日本語入りの .ps1 が、構文エラーになるか文字化けして動く
- .cmd / .bat のコメントが、コマンドとして実行される
- powershell -Command の1行に書いた $変数 が、呼ぶ前に消える
- Get-ChildItem の -Include が効かず、全部のファイルが返る
- "..." に書いた Markdown のバッククォートで、文字が消えて改行が入る
- 書き込み中のログが 0 バイトに見える
- claude -p --allowedTools の後ろに書いたプロンプトが飲み込まれる
- Claude Code の PreToolUse フックが、時間切れになると書き込みを止めずに通す
- PowerShell のフックを -Command で呼ぶと、Claude Code の拒否が素通りする
- Claude Code のフックが1つも動かない(disableAllHooks が残っている)