Как уже в курсе любимый читатель, мы живем в эпоху искусственного интеллекта и агентской разработки. ИИшечки пишут код, код работает, все счастливы. Но есть одна проблема — всё около-иишное как правило живёт и мыслится в окружении macOS/Linux и в контексте в первую очередь питона. А что делать, если ты хочешь использовать иишку для разработки на павершелле и использовать Клода в среде Виндоуз? Ответ по умолчанию — страдать.
Чтобы не было проблем с кириллицей, скрипты нужно хранить в UTF-16 LE с BOM — так их одинаково однозначно опознают что PowerShell 5.1, что pwsh 7+, что тестовые редакторы под Windows, что git/gitlab, и все живут дружно. А вот Claude Code с его встроенными инструментами `Edit` и `Write` живёт только в своей реальности UTF-8 и плевать хотел, в какой кодировке был файл. А поэтому и читать-редактировать старые наработки по умолчанию не может, и новое пишет сломанное.
Проблема старая и известная, но как ’это часто бывает с корнер кейсами, проблемы индейцев шерифа не волнуют — ни фикса, ни какой-либо настройки для клода не существует и, скорее всего, не предвидится. ИЧСХ, проблема тут не только кириллическая, у японцев например ровно та же беда, только с Shift_JIS вместо UTF-16. Но кому какое дело до этих ваших туземных особенностей?
карта мира по мнению программистов (гипотеза)
Сразу как только я наступил на эти грабли, родился обходной маневр: инструкцией в CLAUDE.md агенту было сказано для редактирования PowerShell скриптов делать построчную замену вызовом того же PowerShell. И это в целом работало, но сильно замедляло (и часто ломало) процесс — решение было кустарным, хрупким, и разрешение спрашивалось на каждый чих. Агент регулярно забывал инструкции, а чтобы вспомнить сначала бегло бежал по садовому инвентарю, отнимая моё время, нервные клетки, и тратя драгоценные токены.
Сегодня, устав от очередной порчи скрипта при небольшом изменении, я отправил агента в рисёрч с требованием раз и навсегда решить проблему в корне. Клод обнаружил в интернетах братьев-японцев и других потерпевших, но главное — придумал использовать хуки, которые прозрачно конвертируют файл туда-обратно при редактировании встроенными инструментами. Я затестил и это работает. Щас расскажу.
Доктор Крюк, или как я перестал страдать и полюбил хуки
У Claude Code есть `PreToolUse`/`PostToolUse`/`Stop` hooks — команды, которые выполняются автоматически вокруг вызовов инструментов. Идея простая: пусть файл на диске «в покое» всегда лежит в UTF-16 LE, а хуки на лету превращают его в UTF-8 непосредственно перед тем, как его коснётся Read/Edit/Write, и обратно — сразу после. Модель вообще не должна догадываться, что файл когда-то был не в UTF-8.
Настройки хуков в ~/.claude/settings.json:
"hooks": {
"PreToolUse": [
{
"matcher": "Read|Edit",
"hooks": [{
"type": "command",
"command": "C:\\Program Files\\PowerShell\\7\\pwsh.exe",
"args": ["-NoProfile", "-File", "C:\\Users\\[USER]\\.claude\\hooks\\ps1-pre-encoding.ps1"]
}]
}
],
"PostToolUse": [
{
"matcher": "Edit|Write",
"hooks": [{
"type": "command",
"command": "C:\\Program Files\\PowerShell\\7\\pwsh.exe",
"args": ["-NoProfile", "-File", "C:\\Users\\[USER]\\.claude\\hooks\\ps1-post-encoding.ps1"]
}]
}
],
"Stop": [
{
"hooks": [{
"type": "command",
"command": "C:\\Program Files\\PowerShell\\7\\pwsh.exe",
"args": ["-NoProfile", "-File", "C:\\Users\\[USER]\\.claude\\hooks\\ps1-restore-all.ps1"]
}]
}
]
}
pre-encoding.ps1 (перед Read/Edit — если увидел BOM UTF-16 LE, конвертирует в UTF-8 и запоминает путь):
$ErrorActionPreference = 'Stop'
$stateFile = "C:\Users\[USER]\.claude\hooks\ps1-utf16-state.json"
$scopeRoot = "[ВАШ ПУТЬ]"
try {
$inputJson = [Console]::In.ReadToEnd()
$data = $inputJson | ConvertFrom-Json
$filePath = $data.tool_input.file_path
if (-not $filePath) { exit 0 }
if ($filePath -notmatch '\.ps1$') { exit 0 }
if (-not $filePath.StartsWith($scopeRoot, [System.StringComparison]::OrdinalIgnoreCase)) { exit 0 }
if (-not (Test-Path -LiteralPath $filePath -PathType Leaf)) { exit 0 }
$bytes = [System.IO.File]::ReadAllBytes($filePath)
if ($bytes.Length -ge 2 -and $bytes[0] -eq 0xFF -and $bytes[1] -eq 0xFE) {
$content = [System.IO.File]::ReadAllText($filePath, [System.Text.Encoding]::Unicode)
[System.IO.File]::WriteAllText($filePath, $content, (New-Object System.Text.UTF8Encoding($false)))
$state = @()
if (Test-Path -LiteralPath $stateFile) {
$raw = Get-Content -LiteralPath $stateFile -Raw -ErrorAction SilentlyContinue
if ($raw) { $state = @($raw | ConvertFrom-Json) }
}
if ($state -notcontains $filePath) { $state += $filePath }
($state | ConvertTo-Json) | Set-Content -LiteralPath $stateFile -Encoding utf8
}
} catch {
exit 0
}
exit 0
post-encoding.ps1 (после Edit/Write — конвертирует обратно в UTF-16 LE, но только файлы из стейта):
$ErrorActionPreference = 'Stop'
$stateFile = "C:\Users\[USER]\.claude\hooks\ps1-utf16-state.json"
try {
$inputJson = [Console]::In.ReadToEnd()
$data = $inputJson | ConvertFrom-Json
$filePath = $data.tool_input.file_path
if (-not $filePath) { exit 0 }
if ($filePath -notmatch '\.ps1$') { exit 0 }
if (-not (Test-Path -LiteralPath $stateFile)) { exit 0 }
$raw = Get-Content -LiteralPath $stateFile -Raw -ErrorAction SilentlyContinue
if (-not $raw) { exit 0 }
$state = @($raw | ConvertFrom-Json)
if ($state -notcontains $filePath) { exit 0 }
if (-not (Test-Path -LiteralPath $filePath -PathType Leaf)) { exit 0 }
$content = [System.IO.File]::ReadAllText($filePath, [System.Text.Encoding]::UTF8)
[System.IO.File]::WriteAllText($filePath, $content, [System.Text.Encoding]::Unicode)
$state = @($state | Where-Object { $_ -ne $filePath })
($state | ConvertTo-Json) | Set-Content -LiteralPath $stateFile -Encoding utf8
} catch {
exit 0
}
exit 0
restore-all.ps1 (Stop-хук — подчищает в конце хода всё, что осталось не восстановленным после одиночного Read без последующего Edit):
$ErrorActionPreference = 'Stop'
$stateFile = "C:\Users\[USER]\.claude\hooks\ps1-utf16-state.json"
try {
[Console]::In.ReadToEnd() | Out-Null
if (-not (Test-Path -LiteralPath $stateFile)) { exit 0 }
$raw = Get-Content -LiteralPath $stateFile -Raw -ErrorAction SilentlyContinue
if (-not $raw) { exit 0 }
$state = @($raw | ConvertFrom-Json)
foreach ($filePath in $state) {
if (-not (Test-Path -LiteralPath $filePath -PathType Leaf)) { continue }
$bytes = [System.IO.File]::ReadAllBytes($filePath)
$isUtf16Le = $bytes.Length -ge 2 -and $bytes[0] -eq 0xFF -and $bytes[1] -eq 0xFE
if (-not $isUtf16Le) {
$content = [System.IO.File]::ReadAllText($filePath, [System.Text.Encoding]::UTF8)
[System.IO.File]::WriteAllText($filePath, $content, [System.Text.Encoding]::Unicode)
}
}
Set-Content -LiteralPath $stateFile -Value "[]" -Encoding utf8
} catch {
exit 0
}
exit 0
Собственно, делать эти настройки руками не нужно — просто скопипастите текст заметки в чат своему Клоду и попросите настроить так же.
Доклад окончен
Скрипты на диске и в git теперь всегда лежат в UTF-16 LE с BOM — ровно так, как его и ждёт PowerShell. Пока файла касается Claude Code — он на долю секунды «мигает» в UTF-8 и обратно, а модель работает через свои обычные беззаботные Edit/Write. Роботы работают, человек не напрягается.
Важная тонкость — в скрипты зашита проверка на них самих, чтобы создавая-редактируя их Клод не попадал в бесконечную кодировочную петлю.
Пойду, завайбкожу ещё что-нибудь.
Слава роботам! КЭНК!
