Shift-JIS 파일을 Claude Code로 수정하자 일본어가 모두 깨지고 복구할 수 없게 되었습니다

요약

Claude Code 2.1.296 버전부터 유효한 UTF-8이 아닌 파일의 비-ASCII 문자를 대체하는 Edit 기능이 추가되면서, Shift-JIS와 같은 인코딩 파일을 수정할 경우 일본어 등 모든 비-ASCII 문자가 손상되는 문제가 발생했습니다. 이로 인해 개발 과정에서 문자열 처리에 주의가 필요하며, 셸(Shell)을 이용한 방식이 더 안정적임을 보여줍니다.

핵심 포인트

• Claude Code 2.1.296부터 Non-UTF-8 파일 수정 시 비-ASCII 문자가 대체됨.
• Shift-JIS 등 인코딩 파일을 Edit으로 수정하면 일본어 등이 손상될 위험이 높음.
• 셸(PowerShell, Bash)을 사용한 처리가 문자열 유지 및 줄 바꿈 처리 측면에서 더 안정적임.
• Claude는 파일 손상을 인지하지 못하고 '변경 완료'로만 응답하는 경향이 있음.