fluent-korean

fluent-korean은 Claude Code가 명확한 한국어를 구사하게 만드는 output-style 플러그인입니다.

GitHub 현황 (2026년 8월 기준)

• 스타 432 · 포크 29
• 라이선스 MIT · 저장소 snflkd/fluent-korean
• 생성 2026-07-10 · 마지막 push 2026-08-21

만든 지 한 달 반이고 오늘도 push가 있었습니다. 활발히 손보는 중인 프로젝트입니다.

에이전트의 한국어가 어색한 이유

모델은 영어 중심으로 학습돼 있어 한국어로 답할 때 영어 문장 구조가 남습니다. “~을 통해”, “~에 있어서”, “확인해 주시기 바랍니다” 같은 표현이 반복되고, 불릿마다 길이가 똑같이 맞아떨어집니다.

읽는 데 지장은 없지만 계속 보면 피로합니다. 특히 코딩 에이전트는 하루 종일 대화하므로 말투의 영향이 큽니다.

output-style이라는 접근

프롬프트에 매번 “자연스러운 한국어로 써줘”를 붙이는 대신, 말투 규칙을 설정 층에 고정합니다. 대화마다 다시 지시할 필요가 없고 팀이 같은 설정을 공유할 수 있습니다.

기능을 더하는 게 아니라 기본값을 바꾸는 종류의 도구입니다.

취향의 영역이라는 점도 봐야 합니다. 어떤 문체가 “명확한 한국어”인지는 사람마다 다릅니다. 만든 사람의 기준이 내 기준과 다르면 오히려 어색해질 수 있으니, 규칙을 읽어보고 고쳐 쓰는 편이 낫습니다.

함께 볼 한국어 AI 에이전트 스킬, 말투와 비용을 다루는 계열 (2편):

• im-not-ai (★4,546): 번역투·기계적 대구 등 72가지 “AI 티” 제거
• cjk-token-reducer (★53): CJK 사용 시 토큰 35~50% 절감

이 카테고리에 23편이 모여 있고 20편은 다른 계열입니다. 문서 생성·정보 조사·글쓰기 교정처럼 겨냥하는 지점이 다릅니다. 전체 목록은 AI에이전트스킬 카테고리에 있습니다.

fluent-korean은 이 중 유일하게 “말투”를 다룹니다. 나머지가 무엇을 할 수 있는지를 늘린다면, 이쪽은 같은 일을 어떻게 말하는지를 바꿉니다. 기능이 아니라 기본값을 손대는 자리입니다.

이런 분께 맞아요

• Claude Code를 한국어로 쓰는 개발자
• 에이전트 답변의 번역투가 거슬리던 사람
• 팀에 일관된 문서 말투가 필요한 조직
• output-style 설정을 배우려는 사용자