조사가 사라진 클로드 한국어, 출력 스타일 하나로 되돌리기

클로드가 내놓은 한국어를 두 번 읽어야 뜻이 잡힌 적 있으신가요.

기분 탓이 아닙니다. 조사와 어미가 빠진 채 명사만 늘어선 문장, 평소 쓰던 말 대신 엉뚱한 비유로 바뀐 단어. 클로드 코드에서 특히 자주 튀어나옵니다.

클로드 한국어가 어색한 건 출력 스타일을 바꿔서 고칠 수 있습니다. 이 글에서는 GitHub에 공개된 fluent-korean 플러그인을 설치하는 방법과, 플러그인을 못 쓰는 환경에서 지침 텍스트만으로 같은 효과를 내는 방법을 순서대로 다룹니다.

fluent-korean은 클로드 코드의 한국어 출력 스타일을 바꾸는 플러그인입니다. snflkd가 GitHub에 MIT 라이선스로 공개했고, 플러그인 설치가 어려우면 같은 지침 텍스트를 클로드 웹·앱의 개인 지침 칸에 붙여 넣어도 동작합니다.

무엇이 달라지나

저장소가 스스로 밝힌 목표는 "명확한 의미 전달"입니다. 유려한 문장이 아니라요.

고치는 대상은 세 가지로 못 박혀 있습니다. 빠진 조사와 어미, 전보문처럼 끊어 붙인 명사 나열, 그리고 원래 단어 대신 들어온 엉뚱한 비유.

셋 다 "틀린 정보"는 아닙니다. 그래서 더 성가십니다. 내용은 맞는데 읽는 사람이 매번 문장을 복원해야 하니까요.

적용하면 문장이 길어집니다. 조사와 어미가 돌아오니 당연한 결과입니다.

대신 한 번에 읽힙니다. 개인적으로는 이게 코딩 에이전트에서 가장 큰 소득이라고 봅니다. 에이전트가 방금 무슨 파일을 왜 고쳤는지 헷갈리면 검토 자체가 느려지니까요.

왜 한국어만 유독 어색해질까

뼈대가 다르기 때문입니다.

영어는 어순이 뼈대입니다. 단어를 좀 덜어내도 자리가 뜻을 지탱해 줍니다.

한국어는 조사와 어미가 뼈대입니다. 그것들이 빠지면 자리만 남고 관계가 사라집니다.

문제는 AI 코딩 도구가 토큰을 아끼려고 간결하게 답하도록 맞춰져 있다는 점입니다. 그 "간결함"이 영어에선 요약이지만, 한국어에선 뼈대 제거가 됩니다.

저장소가 지목하는 세 가지 증상을 예로 들면 이렇습니다. 실제 출력을 측정한 기록이 아니라, 어떤 종류의 손상인지 보여주는 예시입니다.

[조사·어미 탈락]
어색: 인증 모듈 수정, 테스트 통과 확인
자연: 인증 모듈을 수정했고, 테스트가 통과하는 것까지 확인했습니다.

[명사 나열]
어색: 캐시 무효화 처리 로직 분리 작업 완료
자연: 캐시를 무효화하는 처리 로직을 따로 떼어 냈습니다.

[엉뚱한 비유로 바뀐 단어]
어색: 이 함수는 다른 함수들의 지휘자 역할을 합니다
자연: 이 함수가 다른 함수들의 호출 순서를 정합니다.

세 번째가 특히 얄궂습니다. "지휘자"는 멋있게 들리지만, 정작 무엇을 하는 함수인지는 안 알려 줍니다.

국내 IT 매체 요즘IT가 이 도구를 소개하면서 짚은 지점도 여기입니다. 어색한 한국어는 표현 문제로 끝나지 않는다는 것.

제작자는 한발 더 나갑니다. 어색한 한국어로 생각을 굴리면 판단의 질 자체가 나빠질 수 있다고 봅니다. 모델이 뼈대가 무너진 문장으로 추론을 이어 가는 상황을 떠올리면 수긍이 가는 주장입니다.

다만 이건 제작자의 견해입니다. 벤치마크로 증명된 수치가 붙어 있는 주장은 아니라는 점은 구분해 두는 게 좋겠습니다.

---

준비물

거창한 게 없습니다. 둘 중 하나면 됩니다.

플러그인 방식이라면 클로드 코드가 설치돼 있고 슬래시 명령을 쓸 수 있는 상태여야 합니다.

지침 복사 방식이라면 클로드 웹이나 앱 계정만 있으면 충분합니다. 터미널을 열 필요조차 없습니다.

라이선스는 MIT입니다. 개인 프로젝트든 회사 업무든 쓰는 데 걸림돌이 없습니다.

되돌리는 것도 쉽습니다. 마음에 안 들면 플러그인을 지우거나 지침 문단을 삭제하면 그만입니다.

단계별로 적용하기

1단계. 클로드 코드에 플러그인 설치하기

클로드 코드를 켜고 명령 두 줄을 순서대로 칩니다.

/plugin marketplace add snflkd/fluent-korean
/plugin install fluent-korean@fluent-korean

첫 줄은 이 저장소를 플러그인 마켓플레이스로 등록하는 명령입니다. 둘째 줄이 실제 설치입니다.

이름이 두 번 나오는 게 오타처럼 보이지만 맞습니다. 앞은 플러그인 이름, 뒤는 마켓플레이스 이름이라 우연히 같을 뿐입니다.

안 될 때 먼저 볼 것 — /plugin 명령 자체가 인식되지 않으면 클로드 코드 버전이 낮은 경우입니다. 저장소 이름의 대소문자와 슬래시 위치도 한 글자씩 확인해 보세요.

2단계. 플러그인 없이 지침만 가져다 쓰기

회사 노트북이라 설치가 막혀 있거나, 애초에 클로드 코드를 안 쓰는 경우가 더 많을 겁니다.

그럴 땐 지침 파일의 본문 텍스트만 복사하면 됩니다. 저장소가 이 방식을 공식으로 안내합니다.

붙여 넣을 자리는 세 군데입니다.

• 클로드 웹·앱: 프로필 또는 일반 탭의 개인 지침 칸
• 코워크: 협업 탭의 지침 칸
• 클로드 코드: md 파일을 사용자 디렉터리나 프로젝트 디렉터리에 두기

셋째 방식이 재밌습니다. 프로젝트 폴더에 넣으면 그 프로젝트에서만 적용되니까요. 영문 문서를 쓰는 저장소와 한국어 보고서를 쓰는 저장소를 따로 굴릴 수 있습니다.

안 될 때 먼저 볼 것 — 지침 칸에는 글자 수 제한이 있습니다. 다른 지침이 이미 길게 들어차 있으면 뒷부분이 잘려 나갑니다. 기존 지침을 먼저 정리하고 붙여 넣으세요.

반응형

3단계. 제대로 걸렸는지 확인하기

확인은 짧게 끝납니다. 평소 쓰던 요청을 하나 던져 보면 됩니다.

"방금 고친 내용을 한국어로 요약해 줘" 정도가 무난합니다. 코딩 에이전트라면 작업 요약에서 증상이 가장 잘 드러나거든요.

답변에 조사와 어미가 살아 있으면 걸린 겁니다. 여전히 "모듈 수정, 테스트 통과" 같은 전보문이 나오면 안 걸린 겁니다.

안 될 때 먼저 볼 것 — 출력 스타일은 대개 새 대화부터 반영됩니다. 이미 길게 이어 온 대화창에서 시험하지 말고, 창을 새로 열어 다시 물어보세요.

---

자주 막히는 부분

가장 흔한 오해는 "번역 품질이 좋아지는 도구"라고 생각하는 것입니다. 아닙니다.

이건 출력 스타일입니다. 모델이 한국어를 만들 때의 문장 규칙을 바꾸는 것이지, 없던 지식을 채워 주지 않습니다.

두 번째는 문체 취향 문제입니다. 문장이 또박또박해지는 대신 답변이 길어집니다. 짧은 답을 선호한다면 오히려 답답하게 느껴질 수 있습니다.

세 번째는 코드와의 충돌입니다. 코드 블록이나 명령어까지 풀어 쓰는 일은 없어야 정상입니다. 만약 명령어에 조사가 붙어 나온다면 지침이 과하게 적용된 것이니, 해당 요청에서만 잠시 꺼 두는 편이 낫습니다.

공짜는 아닙니다 — 토큰을 더 씁니다

저장소가 트레이드오프를 숨기지 않고 적어 뒀습니다. 토큰을 조금 더 씁니다.

이유는 단순합니다. 생략됐던 문장 성분과 형태소를 되살리니 같은 내용도 글자가 늘어납니다.

늘어난 글자는 그대로 메시지 토큰이 되고, 대화가 길어질수록 컨텍스트도 함께 무거워집니다.

그래서 판단은 용도별로 갈립니다. 사람이 읽고 검토해야 하는 작업 요약과 설명이라면 붙일 값어치가 있습니다. 반대로 대량 배치 처리처럼 사람이 안 읽고 넘기는 출력이라면 굳이 켤 이유가 없습니다.

"정확히 몇 퍼센트 늘어나는가"에 대한 공식 수치는 저장소에 나와 있지 않습니다. 궁금하면 같은 요청을 켠 상태와 끈 상태로 한 번씩 돌려 직접 재 보는 게 빠릅니다.

더 해 볼 것

지침을 통째로 쓰는 게 부담스럽다면 필요한 규칙만 골라 옮겨도 됩니다. MIT 라이선스라 그렇게 써도 문제가 없습니다.

비슷한 목적의 도구로는 im-not-ai와 korean-skills가 함께 거론됩니다. 취향이 갈리니 하나씩 붙여 보고 남길 것만 남기면 됩니다.

회사에서 쓴다면 프로젝트 디렉터리에 두는 방식을 권합니다. 팀원마다 개인 설정을 맞추라고 요구하지 않아도 되니까요.

오늘 할 일은 셋 중 하나입니다. 클로드 코드 사용자라면 명령 두 줄 실행하기, 웹·앱만 쓴다면 지침 텍스트를 개인 지침 칸에 붙여 넣기, 그것도 번거롭다면 평소 요청 하나를 골라 적용 전 답변부터 캡처해 두기.

셋 다 오늘 안에 끝납니다.