Claude Code에 일본어로 요청한 작업을 영어로 어떻게 말하는지 보여주는 mod를 만들었습니다

저는 영어를 배우고 싶습니다. 해외의 콘텐츠나 1차 소스에 직접 접할 수 있게 되고, 언젠가 해외에서 일해보고 싶다는 마음도 있습니다.

그렇게 되면 업무 처리 과정도 영어로 진행됩니다. 지금은 Claude Code에게 매일 일본어로 업무를 요청하고 있습니다. 예를 들어 '어제 배포 이후 오류가 늘고 있으니, 원인과 영향 범위를 조사해 줘'와 같은 문장입니다. 만약 영어권 팀이라면, 이것을 어떻게 말할까요?

교재의 예문을 외우는 것보다, 이렇게 제가 실제로 하는 업무 문장을 영어로 말할 수 있게 되는 것이 더 도움이 될 것 같습니다. 그래서 보내는 프롬프트를 영어로 어떻게 표현하는지 보여주는 mod를 만들었습니다.

모양새 (見た目)

다음과 같은 프롬프트를 보냈다고 가정해 보겠습니다.

어제 배포 이후 오류가 늘고 있으니, 원인과 영향 범위를 조사해 줘

에이전트가 작업하는 동안 입력란 위에 다음과 같이 표시됩니다.

in English: "Errors have spiked since yesterday's deploy. Can you investigate the root cause and blast radius?" [Save] [Hide]
key: 영향 범위 → blast radius

첫 번째 줄은 영어권 동료라면 이렇게 말할 것이라는 표현입니다. 두 번째 줄에는 그 문장에서 가장 기억할 가치가 있는 표현을 하나만 보여줍니다. '영향 범위'를 직역해도, blast radius라는 단어에 도달하기 어렵습니다. 이런 업무상의 표현들을 하나씩 익혀나가는 것이 목표입니다.

Save 버튼을 누르면, ~/.nit/phrasebook.md 파일에 다음과 같은 한 줄이 추가됩니다.

- 2026-10-07 · 영향 범위 → blast radius · "Errors have spiked since yesterday's deploy. Can you investigate the root cause and blast radius?"

계속 누적하면, 자신의 업무에서 실제로 사용하는 표현들로만 이루어진 구문집을 만들 수 있습니다. 참고로, 영어로 작성한 프롬프트나 슬래시 커맨드, 코드, 아주 짧은 프롬프트에는 아무것도 표시되지 않습니다.

mod란

mods는 Claude Code 2.1.287 이후에서 사용할 수 있는 기능입니다. 플러그인에 TypeScript의 함수 후크(function hook)를 작성하면, Claude Code의 이벤트에 반응하거나 화면에 컴포넌트를 삽입할 수 있습니다. 코드를 수정하면 실행 중인 세션에 바로 반영됩니다.

nit-band가 사용한 후크는 프롬프트가 전송될 때의 prompt.submit과 입력란 위에 그릴 때의 ui.render (AbovePrompt) 두 가지뿐입니다.

원리 (仕組み)

코드는 전체적으로 약 100줄 정도입니다. 핵심이 되는 부분은 다음과 같습니다.

on('prompt.submit', ($, e, next) => {
const mine = ++generation
void (async () => {
...

프롬프트에서 코드 블록과 인라인 코드를 제거하고 Haiku에 단 한 번만 보냅니다. 돌아온 영어 번역과 핵심 표현은 상태(state)에 저장해 두고, AbovePrompt의 렌더링 시 읽어옵니다.

Haiku 호출은 await를 사용하지 않고 바로 next(e)를 반환합니다. 영어 번역이 늦거나 실패하더라도 프롬프트 전송을 기다리게 하지 않습니다. 또한, 영어 번역은 입력란 위에 보여주기만 하고 대화 로그에는 남기지 않습니다. 따라서 에이전트의 문맥이나 답변은 변함없이 유지됩니다.

계속 두 번 보내면, 1차 결과가 나중에 돌아오는 경우가 있습니다. 그래서 보낼 때마다 숫자를 증가시키고, 최신 번호와 일치하는 결과만 표시하도록 했습니다.

처음에는 영어로 작성한 프롬프트를 수정하는 기능도 넣었습니다. 하지만 저는 평소에 일본어로 프롬프트를 작성하기 때문에 거의 사용하지 않습니다. 영어를 고치는 역할은 직접 만든 skill인 nit에게 맡기고, nit-band에서는 제외했습니다.

일본어 외 언어

초기 설정은 일본어 → 영어입니다. /config로 평소에 프롬프트를 쓰는 언어(Language you work in)와 표시할 언어(Language you are learning)를 변경할 수 있습니다.

선택 가능한 언어는 English, Japanese, Chinese, Korean, Spanish, French, German, Portuguese, Vietnamese, Hindi의 10개입니다. 예를 들어 일본 팀과 함께 일하는 해외 엔지니어라면 English→Japanese로 설정합니다. 그러면 영어로 작성한 프롬프트가 일본 직장에서 사용하는 표현으로 출력됩니다.

설치

Claude Code 2.1.287 이상이 필요합니다.

/plugin marketplace add 6igtree/nit-band
/plugin install nit-band@nit-band

프롬프트를 보낼 때마다, 자신의 Claude Code 세션과 인증을 통해 Haiku를 한 번 호출합니다. 그 외의 다른 곳에는 아무것도 보내지 않습니다.

맺음말

프롬프트는 매일 수십 번씩 작성하기 때문에, 그때마다 영어 표현이 눈에 들어오게 됩니다. 단어장을 열지 않아도, 일하는 김에 조금씩 배울 수 있기를 바라는 마음으로 만들었습니다.

Discussion