Claude Code를 사용한 i18n Django 자동화

Claude Code와 GStack으로 Django i18n 자동화하기

Claude Code와 GStack 스킬 패키지를 결합하면 Django 프로젝트에서 번역 생성과 업데이트를 자동화할 수 있습니다. 이 도구는 파일을 스캔해 하드코딩된 문자열을 찾아내고, i18n 키를 생성하며 메시지를 컴파일합니다. 수작업으로 몇 시간 걸리던 과정이 몇 분 만에 끝나며, 오류와 토큰 사용량을 대폭 줄입니다.

환경 설정

Claude Code와 GStack 패키지를 각 지침에 따라 설치하세요. 현지화 작업을 위해 /qa 스킬을 활성화합니다. settings.py에서 USE_I18N = True와 LANGUAGE_CODE를 설정하세요.

새 언어를 추가할 때는 LANGUAGES에 등록합니다:

LANGUAGES = [
    ('ko', '한국어'),
    ('en', 'English'),
]

실제 사례: 업데이트 번역

랜딩 페이지에 텍스트를 추가할 때, 변경된 파일을 프롬프트에서 /qa 스킬에 지정하세요. 예시 프롬프트:

templates/landing.html의 모든 변경 사항을 한국어로 번역하세요. i18n 키 생성, .po 파일 업데이트, compilemessages 실행.

AI가 코드를 분석해 계획을 제안합니다:

• 파일에서 정적 문자열 스캔.
• gettext 키 생성 (예: msgid "환영합니다" → msgctxt "landing.welcome").
• django.po에 번역 채우기.
• python manage.py compilemessages로 컴파일.

계획을 승인하면 자동 실행됩니다.

구현 세부 사항

스킬이 템플릿과 뷰에서 _('text')나 일반 문자열을 자동으로 찾아냅니다. 여러 파일의 경우 목록이나 디렉토리를 지정하세요. 정확한 파일 경로 지정으로 토큰을 절약합니다.

주요 이점:

• 자동 키 생성: 중복과 충돌 방지.
• 맥락 인식 번역: 문자열 주변 환경 고려로 정확도 ↑.
• makemessages 완벽 통합: 수동 실행 불필요.
• 확장성: 수십 개 언어 프로젝트에도 적합.

테스트 케이스에서 처리 시간 5분, 약 10K 토큰. 결과: 수동 수정 없이 바로 쓸 수 있는 locale/ko/LC_MESSAGES/django.mo 파일.

워크플로 최적화

접근 방식 비교

| 방법 | 시간 | 토큰 | 품질 |

|--------|------|--------|---------|

| 수동 makemessages + poedit | 30-60분 | 0 | 보통 (인간 오류) |

| Claude Code /qa | 5분 | 10K | 높음 (맥락 분석) |

| 전체 AI (경로 미지정) | 7분 | 15K | 높음 |

사이드 프로젝트나 엄격한 번역 검토가 필요한 프로덕션에 이상적입니다.

모범 사례

• 소스 언어 명확히 지정: 러시아어에서 한국어로.
• 승인 전 계획 검토.
• CI/CD 통합: Claude API 호출 스크립트.
• 까다로운 구문에 맥락 추가: 랜딩 페이지 인사말 번역.
• 렌더링 테스트: {% load i18n %} {{ _('key') }}.

주요 요약

• 자동화로 일상 작업 90% 감소, 코딩 집중.
• /qa 스킬이 Django 명령어 독자적 실행.
• 중고급 개발자 번역 비용 절감.
• 대규모 다국어 프로젝트 확장 가능.
• 뉘앙스(속어, 서식)는 여전히 검토 필요.

— Editorial Team