[Claude Code] 2.1.296, UTF-8이 아닌 파일은 Edit가 거부해요

[Claude Code] 2.1.296, UTF-8이 아닌 파일은 Edit가 거부해요

Claude Code 2.1.296이 한국 시간 10월 10일 새벽(오전 4시 30분경)에 배포됐어요. 이번 버전에서 눈여겨볼 건 UTF-8이 아닌 파일을 고칠 때의 동작이에요. 지금까지는 이런 파일을 Edit로 고치면 파일 속 비ASCII 글자가 전부 바뀔 수 있었는데, 이제는 편집 자체를 거부해요.

01. 지금까지는 비ASCII 글자가 통째로 바뀌었어요

changelog에 적힌 버그는 이래요. 유효한 UTF-8이 아닌 파일을 Edit나 NotebookEdit로 고치면, 수정한 줄만이 아니라 파일 안의 모든 non-ASCII 문자가 바뀌었다고 해요.

예시로 든 인코딩은 Windows-1252, Shift-JIS, GBK예요. 무엇으로 바뀌었는지까지는 changelog에 나와 있지 않아요.

한 줄만 고쳐달라고 했는데 파일 전체가 바뀌는 거라, diff를 보기 전에는 알아채기 어려워요.

02. 이제는 고치지 않고 거부해요

2.1.296부터는 이런 파일의 편집 요청이 거부돼요. 파일이 망가지는 대신 작업이 멈추는 쪽으로 바뀐 거예요.

레거시 파일에서 Edit가 갑자기 실패하면 인코딩부터 확인해보세요. 인코딩 확인과 UTF-8 변환은 macOS 기본 도구로 할 수 있어요.

file -I legacy.txt
iconv -f CP949 -t UTF-8 legacy.txt > legacy.utf8.txt

참고로 file -I는 EUC-KR·CP949 파일을 charset=iso-8859-1처럼 엉뚱하게 표시하는 경우가 많아요. UTF-8이 아니라는 것만 확인하는 용도로 보고, 한글 파일이라면 CP949로 변환해본 뒤 한글이 정상인지 보는 게 확실해요.

다만 변환은 원본 인코딩을 유지해야 하는 프로젝트라면 함부로 하면 안 돼요. 빌드나 배포가 특정 인코딩을 전제로 하는 경우가 있어서, 팀 규칙부터 확인하는 게 안전해요.

03. EUC-KR 파일도 해당될 가능성이 커요

changelog 예시에 EUC-KR이나 CP949는 없어요. 하지만 조건이 "유효한 UTF-8이 아닌 파일"이라, 한글 레거시 파일도 같은 범위에 들어갈 것으로 보여요.

오래된 Java 프로젝트의 properties 파일이나 옛 CSV처럼 EUC-KR로 남아 있는 경우가 있어요. 이전 버전에서 이런 파일을 Claude Code로 고친 적이 있다면, 한글이 멀쩡한지 한번 확인해볼 만해요.

04. 같이 들어간 변경도 있어요

• Read 도구에 allow_large 옵션이 생겼어요. 파일 전체가 필요하고 context에 여유가 있으면, 크기 제한을 넘는 텍스트 파일도 한 번에 읽을 수 있다고 해요.
• BASH_ARGV0 셸 변수에 값을 넣고 쓰는 일부 명령이 승인 없이 통과되던 문제가 고쳐졌다고 해요. 이제는 승인을 물어요.
• 처음에 함께 보내는 MCP 도구 설명과 MCP 서버 instructions의 기본 길이 제한이 2,048자에서 4,096자로 늘었다고 해요.

업데이트는 claude update로 받을 수 있고, claude --version으로 2.1.296인지 확인하면 돼요.

출처: Claude Code CHANGELOG (GitHub), v2.1.296 릴리즈

이 글은 공식 발표 내용을 정리한 것이고, Anthropic으로부터 어떤 형식의 협찬도 받지 않았습니다.