문제는 '보이지 않는 문자'에서 시작됐다
어느 날 오후, 드림팀의 소규모 팀이 운영하는 비즈니스 데이터 파일이 맥미니에서 생성되고, 이를 윈도우 디바이스의 자동화 봇으로 전달하려고 했다. "쉬운 작업이겠지"라고 생각했다.
그런데 윈도우에서 파일을 열었을 때, 다국어 텍스트(한글, 영문 섞임)가 깨져 보였다. 특수문자와 여백도 엉망이었다.
같은 파일이 맥에선 깔끔한데, 윈도우에서는 「???」로 표시된다는 게 문제였다.
Claude Code가 발견한 진짜 범인
Claude Code에 상황을 설명하고, 파일 인코딩을 점검해달라고 요청했다.
응답:
「맥미니는 기본으로 UTF-8 인코딩을 사용하지만, 윈도우 환경에서는 UTF-16이나 로컬 인코딩(한국 시스템의 경우 EUC-KR)으로 읽으려고 시도한다. 변환 과정에서 일부 바이트가 손실되고 있다.」
해결 방법 (비개발자도 가능)
1단계: Python 스크립트로 재인코딩
import pandas as pd
# 맥미니에서 생성된 UTF-8 파일을 읽기
df = pd.read_csv('data_from_mac.csv', encoding='utf-8')
# 윈도우가 안정적으로 읽을 수 있도록 UTF-8 BOM 추가
df.to_csv('data_for_windows.csv', encoding='utf-8-sig', index=False)
핵심: `utf-8-sig`는 파일 시작에 BOM(Byte Order Mark)을 붙여서 윈도우가 자동으로 인식하게 한다.
2단계: Google Sheets 경유로 동기화
CSV 대신 구글 시트를 중간 지점으로 활용했다.
• 맥미니의 자동화가 구글 시트에 데이터 입력
• 윈도우 디바이스의 봇이 시트 API로 데이터 수신
• 인코딩 걱정 없음 (구글이 다 처리)
3단계: 윈도우 디바이스 설정 확인
윈도우 문자열 입력 방식을 UTF-8로 명시:
# PowerShell (관리자 권한)
Set-ItemProperty -Path 'HKLM:\SYSTEM\CurrentControlSet\Control\Nls\CodePage' -Name ACP -Value 65001
(재부팅 필요)
배운 점
비개발자 입장에서는 "같은 데이터인데 왜 다르게 보여?"라고 답답했지만, 배경에는 OS별 문자 인코딩의 역사적 차이가 있었다. 맥(UNIX 기반)과 윈도우는 기본값이 완전히 다르다.
데이터 이동이 많은 팀이라면, 중간 매개체(구글 시트, 클라우드 DB)를 쓰는 게 가장 안전하다.
드림팀은 이제 CSV 파일 직전달 대신 구글 시트 + API 조합을 표준으로 정했다. 작은 변화지만, 자동화가 더 견고해졌다.