Codex 작업 시 한글을 사용하면 토큰과 성능에 영향이 있다.

Codex 로 소프트웨어를 개발할 때 한글을 사용하면 토큰 사용량도 조금 더 많고 성능에도 영향이 있다. 한글 자체가 사용하는 바이트 수가 큰 것도 있겠지만 그것 보다는 영어로 번역하는데 발생하는 비용과 인코딩 이슈가 더 영향이 큰 것 같다. 체감이 될 정도라서 GPT에게 물어보니 아래처럼 답변을 받았다.

 

질문

너가 작성한 .md 파일들 보면 영어로 작성된 것들이 있는데 영어로 작성하면 한글로 작성할 때 보다 토큰 사용량이나 코딩 성능, 정확도 같은 것이 차이가 나? 다른 장점과 단점이 있어?

답변

네, 차이가 있습니다. 다만 “영어가 무조건 좋다 / 한글이 무조건 좋다”라기보다 문서 목적에 따라 다릅니다.

토큰 사용량

• 보통 영어가 더 적은 토큰으로 표현됩니다.
• 한글은 문장 자체는 짧아도 토크나이저 기준으로 더 잘게 쪼개지는 경우가 많아서, 같은 의미를 쓰면 영어보다 토큰이 더 들 수 있습니다.
• 특히 기술 문서에서 runtime config, storage_state, retry_after, fallback 같은 용어는 영어 그대로 쓰면 더 짧고 안정적입니다.

코딩 성능

• 코드 관련 지시, API 이름, 에러 메시지, 라이브러리 문서는 영어가 조금 유리합니다.
• 함수명/설정 키/로그 레벨/패키지명과 자연스럽게 맞아서 혼동이 적습니다.
• 예: message-level throttle, storage_state injection, HTTP 429 retry_after 같은 표현은 영어가 압축적입니다.

정확도

• 기술 개념 자체는 영어가 더 정확한 경우가 많습니다.
• 하지만 이 저장소는 운영자가 한국어로 읽고 판단하는 문서가 많으니, 운영 정책/주의사항/작업 규칙은 한글이 더 정확하게 전달될 수 있습니다.
• 특히 “무엇을 하면 안 되는지”, “언제 README를 갱신해야 하는지” 같은 규칙은 한글이 낫습니다.

영어 문서의 장점

• 토큰 효율이 좋음
• 코드/라이브러리/API 용어와 잘 맞음
• 검색 키워드와 에러 메시지 추적에 유리함
• 짧고 구조화된 기술 문서 작성에 유리함

영어 문서의 단점

• 사용자가 매번 해석해야 해서 운영 실수가 생길 수 있음
• 한국어로 된 기존 AGENTS/README와 톤이 섞임
• 정책 문서에서는 미묘한 의무/권장/금지 뉘앙스가 덜 직관적일 수 있음

한글 문서의 장점

• 이 저장소의 실제 사용자/운영자에게 바로 읽힘
• 정책, 보안 주의사항, 운영 절차 전달이 명확함
• 기존 README/AGENTS 스타일과 일관성이 좋음

한글 문서의 단점

• 토큰은 조금 더 쓸 수 있음
• 기술 용어 번역이 어색하면 오히려 정확도가 떨어짐
• 터미널 인코딩 문제가 있으면 확인 비용이 늘어남

제 추천은 혼합 원칙입니다.

• 제목/설명/정책 문장: 한글
• 설정 키, 함수명, API 이름, 에러 코드: 원문 영어 유지
• 커밋 메시지: 방금 정한 대로 한글
• 새 공통 정책 문서도 가능하면 한글 제목과 한글 본문으로 바꾸는 게 저장소 일관성에는 더 좋습니다.

이 저장소에는 더 잘 맞습니다.

결론적으로, Codex의 코딩 정확도만 보면 영어가 약간 유리한 부분이 있지만, 이 저장소의 운영 문서 품질과 사용자 이해도까지 보면 한글 중심 + 기술 키워드 영어 유지가 가장 좋습니다.

 

Visual Studio Code 의 Codex 플러그인 화면