i18n 런타임 라이브러리를 추가하고, Copilot이 이미 작성한 문자열을 변환하고, 새 문자열이 들어오지 않게 막으세요. 대부분의 팀이 마지막 단계에서 막혀요. 저장소 지침 파일이 Copilot이 코드를 쓰는 모든 기능에 닿지는 않기 때문이에요. 채팅과 코딩 에이전트는 지침을 읽지만 인라인 자동 완성은 읽지 않아요. globalize.now는 코드베이스를 한 번에 변환해서 i18n 라이브러리가 읽는 키와 로케일 파일을 만들어 주는 AI 기반 현지화 인프라예요.

지침 파일을 추가했는데도 Copilot이 문자열을 계속 하드코딩하는 이유는 뭔가요?

가장 빠른 경로에는 지침 파일이 연결되어 있지 않기 때문이에요. VS Code 문서에는 타이핑하는 동안 표시되는 인라인 제안에는 커스텀 지침이 반영되지 않는다고 분명히 적혀 있어요. 대부분의 사람이 하루 대부분을 보내는 모드가 바로 이 모드예요.

그러니 작성한 규칙은 제대로 동작하긴 해요. 채팅에서 Copilot에 질문하거나 코딩 에이전트에 작업을 맡길 때는 적용돼요. 하지만 JSX 태그를 입력하고 회색 완성 제안에서 Tab을 누를 때는 적용되지 않아요. 둘 다 커밋되는 코드를 만들지만, 규칙을 읽은 건 한쪽뿐이에요.

어떤 Copilot 기능이 지침을 읽나요?

저장소에 코드를 쓰는 기능은 세 가지인데, 동작 방식이 서로 달라요.

기능지침을 읽나요?결과물이 들어가는 곳
인라인 완성아니요편집 중인 파일에 바로 들어가요
채팅과 에이전트 모드네에디터에서 검토하는 수정 사항
코딩 에이전트네검토할 수 있는 초안 PR

이 문제에는 코딩 에이전트가 세 가지 중 가장 다루기 쉬워요. 이슈를 할당하면 백그라운드에서 작업하고 초안 PR을 열기 때문에, 결과물이 리뷰어가 이미 보고 있는 곳에 도착해요. 반면 인라인 완성은 아무 관문 없이 그대로 들어와요.

Copilot 프로젝트에서 i18n은 어떻게 설정하나요?

먼저 프레임워크에 맞는 런타임 라이브러리를 고르세요. Next.js App Router에는 next-intl, 그 외 React 앱에는 react-i18next, 컴파일 타임 추출과 PO 카탈로그가 필요하면 Lingui가 맞아요. 세 라이브러리는 next-intl vs react-i18next vs Lingui에서 비교했어요.

Copilot은 Lovable이나 Bolt처럼 특정 프레임워크에 묶여 있지 않아요. 스택은 열려 있고, 라이브러리 선택도 자유예요. 순서만은 정해져 있어요. 라이브러리를 설치하고, 이미 있는 문자열을 변환하고, 그다음에 재발 방지를 고민하세요. 코드베이스의 90%가 여전히 하드코딩된 영어인 상태에서 재발 방지 규칙을 써 봐야 측정할 게 없어요.

.github/copilot-instructions.md에는 무엇을 넣어야 하나요?

이 경로의 저장소 지침 파일은 자동으로 감지되어 워크스페이스의 채팅 요청에 적용돼요. GitHub의 가이드는 지침을 짧고 독립적으로 쓰고, 이유를 설명하고, 린터가 이미 검사하는 내용은 빼라는 거예요. 이 원칙을 따르면 i18n 섹션은 짧게 끝나요:

## User-facing text

- User-facing text belongs in the message catalog, never in a component literal.
- Use the translation function from our i18n library for every visible string.
- Reason: a literal cannot be translated and does not show up as a missing key,
  so it ships silently in one language.
- Add new English values to the source catalog only. Never hand-edit other locales.
- Not user-facing: test names, log lines, error codes, internal constants.

마지막 줄이 보기보다 중요해요. 규칙이 과하게 적용되면 무시당하고, 로그 메시지까지 감싸라는 규칙은 에이전트에게 이 섹션 전체가 노이즈라고 가르치게 돼요. 지침 파일이 아직 없다면 VS Code 채팅의 init 명령으로 코드베이스를 바탕으로 초안을 만들 수 있어요. 빈 파일에서 시작하는 것보다 나아요.

경로별 지침 파일을 쓰면 더 낫나요?

네, 다른 에디터의 규칙 파일에는 없는 Copilot만의 수단이에요. .github/instructions 아래에 두는 .instructions.md 파일은 frontmatter에 applyTo glob을 지정할 수 있고, 에이전트가 일치하는 파일을 다룰 때만 로드돼요.

---
name: 'UI strings'
description: 'String handling rules for components'
applyTo: '**/*.{jsx,tsx}'
---
Every visible string in this file must come from the catalog.
Key format is feature.element.state, lowerCamelCase.
If you add a key here, add its English value to the source catalog in the same change.

규칙의 범위를 컴포넌트 파일로 좁혀야 신뢰할 수 있어요. 사용자에게 보이는 텍스트가 있는 곳에서만 작동하고, API 라우트나 마이그레이션 스크립트에서는 조용해요. 저장소 루트에 AGENTS.md나 CLAUDE.md가 이미 있다면 Copilot이 상시 지침으로 함께 읽어요. 여러 에이전트를 쓰는 팀도 도구마다 파일을 따로 둘 필요가 없어요.

지침이 놓친 문자열은 무엇이 잡나요?

CI의 린트 규칙이에요. 이 스택에서 빌드를 실패시키는 유일한 계층이거든요. 지침은 확률을 바꾸고, 실패하는 검사는 결과를 바꿔요. 이 강제 계층은 AI 에이전트가 하드코딩 문자열을 계속 추가하는 이유에서 자세히 다뤘고, 설정은 Copilot 저장소에도 그대로 적용돼요.

Copilot에 특화된 부분은 PR이에요. 저장소 지침은 채팅뿐 아니라 Copilot 코드 리뷰에도 적용돼요. 코드 생성에 영향을 주는 바로 그 파일이 코딩 에이전트가 올린 초안 PR의 리뷰 코멘트에도 영향을 줘요. 인라인 자동 완성이 피해 갈 수 없는 관문이 하나 생기는 셈이고, 이 글 첫머리의 빈틈을 메우는 가장 현실적인 방법이에요.

이것만으로 저장소에 이미 쌓인 부채가 사라지지는 않고, 로케일 파일이 채워지지도 않아요. 리뷰에서 리터럴을 잡아내면 문자열이 빠졌다는 사실은 알 수 있어요. 하지만 키를 만들고, 번역하고, 나머지 로케일이 동기화에서 어긋나지 않도록 관리하는 일은 여전히 누군가의 몫이에요.

globalize.now는 어디에 들어가나요?

카탈로그를 만드는 계층이에요. i18n 라이브러리도, 지침 파일도 하지 않는 부분이죠. 앱에서 저장소를 연결하면 코드베이스를 한 번 변환해요. 하드코딩된 문자열을 키로 바꾸고 로케일 파일을 생성해요. 이 최초 변환이 끝나면, 이후 커밋에서 생긴 새 카탈로그 항목은 푸시 작업이 번역해요.

출력은 JSON 또는 PO라서, 카탈로그가 런타임 라이브러리가 이미 읽는 형태로 들어가요. 다른 에이전트형 에디터도 같은 방식으로 다뤄요. Claude Code와 Cursor도 다른 방향에서 같은 벽에 부딪혀요. Next.js 코드베이스에 대한 단계별 가이드는 AI로 만든 Next.js 앱에 i18n 추가하기에 있어요. 변환 과정은 개발자 문서에, 요금제는 요금 페이지에 자세히 나와 있어요.

요약

지침 파일을 작성하고, 컴포넌트 파일에 한정한 경로별 규칙을 추가하고, CI에 린트 규칙을 넣으세요. 그러면 Copilot이 지시받은 내용과 실제로 쓴 코드 사이의 간극이 영어 문자열 배포가 아니라 빨간 빌드로 드러나요. 그다음 밀린 문자열을 한 번에 변환해서, 규칙이 지킬 일관된 기반을 만드세요.

globalize.now는 하드코딩된 앱 문구를 번역할 수 있는 로케일 파일로 바꾸고, 배포할 때마다 최신 상태로 유지해요.

globalize.now 무료로 시작하기