PowerShell 한글 깨짐 때문에 같은 실수를 넉 달 동안 7번 했습니다. 한글이 든 .ps1 스크립트를 BOM 없이 저장했을 뿐인데, 어떤 날은 ParserError가 났고 어떤 날은 API 요청이 전부 HTTP 401로 돌아왔습니다.
저는 IT 회사에서 마케팅을 하는 비개발자입니다. 개인 유튜브 채널 영상과 블로그 발행을 AI 코딩 도구(클로드 코드)로 만든 스크립트로 돌립니다. 작업 폴더가 구글 드라이브 데스크톱의 G:\내 드라이브 아래라서 경로마다 한글이 들어갑니다. 2026년 11월 기준, Windows PowerShell 5.1에서 겪은 증상과 원인, 지금 쓰는 설정을 정리합니다.
같은 실수가 매번 다른 오류로 나타났습니다
처음은 7월 11일, 블로그 글을 워드프레스 REST API로 올리는 발행 스크립트였습니다. 한글이 든 파라미터가 깨지면서 스크립트가 파싱 단계에서 멈췄습니다. 8월 30일에는 일본어 채널 업로드용 파일명 복사 스크립트가 파서 에러를 냈습니다.
가장 헷갈렸던 건 10월 16일입니다. 영어 채널 롱폼 영상의 TTS(음성 합성) 스크립트를 돌렸더니 -Raw 인자 오류가 나고 API 요청이 전부 HTTP 401로 돌아왔습니다. 401은 인증 실패라서 API 키부터 의심하기 쉽습니다. 실제로는 스크립트가 한글이 든 경로를 잘못 읽은 탓이었습니다.
10월 31일에는 영어 쇼츠 8편을 하룻밤에 만드는 배치에서 또 걸렸습니다. BOM 없이 저장된 .ps1이 한글 경로 때문에 ParserError를 냈고 Start-Process 인자에 한글 경로를 그대로 넣은 부분도 깨졌습니다.

오류 이름은 제각각이었지만 깨진 .ps1 파일에는 공통점이 두 가지 있었습니다. 스크립트에 한글(또는 일본어)이 있었고 파일 맨 앞에 BOM이 없었습니다.
Windows PowerShell 5.1이 BOM 없는 파일을 cp949로 읽는 게 원인
BOM(Byte Order Mark)은 파일 맨 앞에 붙는 표식으로, UTF-8에서는 EF BB BF 3바이트입니다. Microsoft의 about_Character_Encoding 문서는 스크립트에 ASCII가 아닌 문자가 있으면 BOM이 있는 UTF-8로 저장하라고 안내합니다. BOM이 없으면 Windows PowerShell이 스크립트를 레거시 ANSI 코드 페이지로 잘못 해석하기 때문입니다.
한국어 윈도우의 ANSI 코드 페이지는 949, 흔히 cp949라고 부르는 방식입니다. UTF-8에서 한글 한 글자는 3바이트인데(‘내’는 EB 82 B4) cp949는 한글을 2바이트 단위로 읽습니다. 글자 경계부터 어긋나니 내 드라이브가 엉뚱한 글자로 바뀌고 그 경로로는 파일을 찾지 못합니다.
제가 쓰는 AI 코딩 도구는 파일을 만들 때 BOM 없이 저장합니다. VS Code도 기본 인코딩이 BOM 없는 UTF-8이고 PowerShell 7도 기본값이 BOM 없는 UTF-8입니다. 만드는 쪽은 BOM 없는 UTF-8이 기본인데, 윈도우의 5.1만 그 파일을 옛 방식으로 읽는 셈입니다.
| 항목 | Windows PowerShell 5.1 | PowerShell 7 |
|---|---|---|
| 실행 파일 | powershell.exe | pwsh.exe |
| BOM 없는 스크립트 읽기 | ANSI 코드 페이지 (한국어 윈도우는 cp949) | UTF-8 |
| Out-File, > 기본 저장 | UTF-16LE | UTF-8 (BOM 없음) |
| Set-Content 기본 저장 (새 파일) | ANSI | UTF-8 (BOM 없음) |
| -Encoding UTF8 | BOM 있는 UTF-8 | BOM 없는 UTF-8 |
BOM을 붙여 다시 저장하고 실행 전에 첫 3바이트를 확인합니다
고치는 방법은 7월에 처음 쓴 그대로입니다. 한글이 든 .ps1을 BOM이 있는 UTF-8로 다시 저장합니다. .NET의 UTF8Encoding 생성자에 $true를 넘겨 WriteAllText에 주면 파일 맨 앞에 EF BB BF가 붙습니다. 인코딩 인자를 빼면 BOM 없는 UTF-8로 저장되니 주의하세요.
$p = 'G:\내 드라이브\scripts\generate_full_tts.ps1'
$c = Get-Content $p -Raw -Encoding UTF8
[IO.File]::WriteAllText($p, $c, (New-Object System.Text.UTF8Encoding $true))

10월 롱폼 작업 때는 실행 전에 첫 3바이트가 EF BB BF인지 파이썬으로 확인하는 단계를 절차에 넣었습니다. 고쳤다는 기억에 기대지 않고 실행할 때마다 파일을 직접 봅니다.
파이썬 subprocess가 죽은 것도 같은 뿌리였습니다
9월에 영상 도구를 만들 때는 파이썬 쪽에서 비슷한 일이 있었습니다. ffprobe가 한글 경로가 섞인 오류 메시지를 내보냈는데, 파이썬이 그 출력을 cp949로 디코드하다 예외가 나면서 작업 스레드가 죽었습니다. 9월 15일 만든 모의투자 자동매매 봇에서는 .ps1 파서 에러와 함께 subprocess 출력의 cp949 디코드 예외도 나서 encoding='utf-8'을 넣었습니다.
파이썬은 text=True만 주면 지역 설정의 인코딩, 한국어 윈도우에서는 cp949로 출력을 읽습니다. 파이썬 3.15부터는 UTF-8 모드가 기본이 되어 이 기본값이 UTF-8로 바뀌었습니다. 그래도 버전과 상관없이 결과가 같도록 encoding="utf-8", errors="replace"를 직접 적는 편이 안전합니다. 파이썬이 콘솔에 찍는 글자는 PYTHONIOENCODING=utf-8이나 sys.stdout.reconfigure(encoding="utf-8")로 맞춥니다. 이 블로그 발행 도구도 첫머리에 reconfigure를 넣어 두었습니다.
기록으로 세어 보니 넉 달 동안 7번이었습니다
이 글을 쓰면서 작업 기록(스킬 문서와 세션 요약)을 뒤져 같은 함정을 적은 곳을 세어 봤습니다. PowerShell 스크립트가 걸린 기록만 셌고, 파이썬만 문제였던 9월 ffprobe 건은 넣지 않았습니다.
| 날짜 | 작업 | 증상 | 처리 |
|---|---|---|---|
| 7월 11일 | 블로그 발행 스크립트 | 한글 파라미터 깨짐, 파싱 에러 | BOM 붙여 재저장 |
| 8월 16일 | 영어 쇼츠 채널 1호 TTS | 한글 경로 깨짐 | BOM 필수로 기록 |
| 8월 30일 | 일본어 채널 파일명 복사 스크립트 | 파서 에러 | BOM 추가 |
| 9월 15일 | 모의투자 자동매매 봇 | .ps1 파서 에러, 파이썬 cp949 디코드 예외 | BOM, encoding 명시 |
| 10월 16일 | 영어 롱폼 TTS 스크립트 | -Raw 인자 오류, 요청 전부 HTTP 401 | BOM, 첫 3바이트 확인 |
| 10월 31일 | 영어 쇼츠 8편 배치 | 한글 경로 ParserError, Start-Process 인자 깨짐 | BOM 재저장, Bash로 실행 |
| 11월 10일 | 개인 채널 영상 런처 | 한글 경로 깨짐 | 런처를 BOM으로 저장 |
7월 11일부터 11월 10일까지 넉 달 동안 7번이고 고친 방향도 거의 같았습니다. 파일 맨 앞에 3바이트를 붙이거나 읽는 쪽에 인코딩을 적었고, Start-Process 인자처럼 그걸로 안 되는 곳만 실행 방식을 바꿨습니다.
반복된 이유도 기록에 보였습니다. 파일을 만든 도구가 적혀 있는 세 건(7월 11일, 10월 16일, 10월 31일)은 모두 AI 코딩 도구가 새로 쓴 파일이었습니다. 새 스크립트를 만들 때마다 BOM 없는 파일이 새로 생기니 한 번 고쳤다는 기억으로는 막을 수 없었습니다. 7월에 적어 둔 함정을 8월에 또 밟은 이야기는 클로드 코드로 만든 업무 비서 기록에도 짧게 썼습니다. 그때는 기록이 작업별 문서에 흩어져 다른 작업에서 읽히지 않았습니다.
한글 경로에서 스크립트를 돌리는 분께
PowerShell 한글 깨짐을 한 번이라도 겪었다면 아래를 확인해 보세요.
- 한글이나 일본어가 든 .ps1을
powershell.exe(5.1)로 실행한다면 BOM 있는 UTF-8로 저장합니다 - 에디터나 AI 도구가 새로 만든 파일은 BOM이 없다고 보고 첫 3바이트를 확인합니다. VS Code는
"[powershell]": { "files.encoding": "utf8bom" }설정으로 PowerShell 파일만 BOM으로 저장할 수 있습니다 - 401이나
-Raw인자 오류처럼 엉뚱한 오류라도 경로에 한글이 있으면 인코딩부터 봅니다 - 5.1에서 BOM 없는 UTF-8 파일을 읽을 때는
Get-Content -Encoding UTF8처럼 인코딩을 적습니다. 저장할 때도 앞의 버전 비교 표를 보고-Encoding을 적습니다 - 외부 프로그램 인자에 한글 경로나 큰따옴표가 섞여도 5.1에서 깨질 수 있습니다. 저는
Start-Process로 넘기던 한글 경로 실행을 Bash 쪽으로 옮겼습니다. 제미나이를 터미널에서 부르는 CLI 도구에서 “unexpected argument” 오류가 났을 때는 큰따옴표 없는 프롬프트를 파일로 저장해[IO.File]::ReadAllText로 읽어 넘겼습니다 - 파이썬 subprocess에는
encoding="utf-8", errors="replace"를 붙입니다
자주 묻는 질문
PowerShell 7을 쓰면 BOM을 신경 쓰지 않아도 되나요?
PowerShell 7(pwsh.exe)은 BOM이 없어도 UTF-8로 읽으니 이 문제는 거의 사라집니다. 다만 7은 5.1과 나란히 설치되는 방식이라 powershell.exe를 부르면 여전히 5.1이 실행됩니다. 작업 스케줄러나 다른 프로그램이 어느 쪽을 부르는지 모르면 BOM을 붙여 두는 편이 안전합니다. Microsoft의 5.1 문서도 스크립트에 ASCII가 아닌 문자가 있으면 BOM 있는 UTF-8로 저장하라고 안내합니다.
chcp 65001로 바꾸면 해결되나요?
스크립트가 깨지는 문제는 그대로입니다. chcp가 바꾸는 건 콘솔 코드 페이지입니다. 5.1이 BOM 없는 .ps1을 읽을 때는 시스템 로캘의 ANSI 코드 페이지를 씁니다. 콘솔 화면의 한글이 깨지는 건 콘솔 출력 인코딩([Console]::OutputEncoding) 쪽의 별개 문제입니다. 제미나이 CLI 도구도 명령마다 앞에 [Console]::OutputEncoding = [System.Text.Encoding]::UTF8;를 붙여 실행하더군요. 이 블로그의 예약 알림 스크립트도 콘솔 첫 줄 한글은 깨져 보이지만 텔레그램 전송은 정상입니다.
BOM은 모든 파일에 붙이는 게 안전한가요?
아닙니다. 같은 Microsoft 문서가 일반적인 호환성을 위해서는 UTF-8 파일에 BOM을 쓰지 않는 쪽을 권하고, cat·sed·awk 같은 유닉스 계열 도구가 BOM을 처리하지 못한다고 적어 두었습니다. 5.1로 돌릴 한글 .ps1만 예외로 두는 셈입니다. 제 기록에서 BOM을 붙인 파일은 모두 .ps1이었고 제미나이 CLI에 넘길 프롬프트 파일은 일부러 BOM 없는 UTF-8로 저장했습니다. 파이썬에서 BOM이 있을지 모르는 파일을 읽을 때는 encoding="utf-8-sig"로 열면 맨 앞 3바이트가 있을 때 건너뜁니다.