T07
PYTHONIOENCODING を設定したのに、python -I だと効かない
症状
T06 の対策で PYTHONIOENCODING=utf-8 を入れたのに、python -I で呼んでいる所だけ同じエラーで落ちる。
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\dash.py", 'print("a" + chr(0x2014) + chr(0x2713) + "b")')
$old = $env:PYTHONIOENCODING; $env:PYTHONIOENCODING = 'utf-8'
python -I "$d\dash.py" > "$d\o1.txt" 2> "$d\e1.txt"; $a = $LASTEXITCODE
python "$d\dash.py" > "$d\o2.txt" 2> "$d\e2.txt"; $b = $LASTEXITCODE
$env:PYTHONIOENCODING = $old
$err = [IO.File]::ReadAllText("$d\e1.txt")
"with -I exit=$a, without -I exit=$b"
if ($a -ne 0 -and $err -match 'UnicodeEncodeError' -and $b -eq 0) { 'REPRODUCED' } else { 'NOT REPRODUCED' }
}
なぜ起きるか
-I(隔離モード)は PYTHON で始まる環境変数をすべて無視する。安全のために付けた -I が、文字コードの設定まで消す。Python 3.15 以降は UTF-8 が既定なので、そもそも落ちない見込み(未確認)。
直し方
-I を外すか、スクリプトの中で sys.stdout.reconfigure(encoding='utf-8') を呼ぶ。
import sys
sys.stdout.reconfigure(encoding='utf-8')
作者の PC での結果
-I で終了コード 1、外すと 0
作者の 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 や claude の出力を変数に入れると文字化けする
- 手で動かすと通る Python が、タスクスケジューラやリダイレクトのときだけ落ちる
- 日本語入りの .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 が残っている)