claudekit / tools / fluent-korean
[ Plugin · Claude Code Utilities ]

fluent-korean

Claude Code가 조사와 어미를 생략한 축약형 한국어 대신 의미가 분명한 문장을 출력하도록 지시하는 output-style 플러그인. 결과를 고치는 것이 아니라 시스템 프롬프트 층위에서 미리 규율합니다. 코딩 지침을 유지하는 판과 제거한 판 두 가지를 제공합니다.

snflkd/fluent-korean ·updated
$ /plugin marketplace add snflkd/fluent-korean copy

snflkd가 만든 오픈소스 플러그인(snflkd/fluent-korean).

왜 필요한가?

코딩 에이전트는 토큰 사용량을 낮추고 컨텍스트 제한에 대응하기 위해 짧게 말하도록 조정되어 있습니다. 그래서 한국어로 대화할 때 조사와 어미가 빠진 문장이 자주 나옵니다.

README가 드는 예시입니다.

이 결정은 이후 중요 정책이 갈리는 자리. 컨텍스트 압축 전 신중 반영한다.

읽는 사람이 의미를 짐작해야 하고, 잘못 짐작하면 그대로 작업에 반영됩니다. 저자는 이 문제가 세 방향으로 번진다고 정리합니다. 보고를 이해하는 데 노력이 들고 한국어 결과물의 완성도가 낮아지는 것, 사고(추론) 기능이 켜져 있을 때 저품질 문장이 추론 과정 자체에 영향을 주는 것, 그리고 여러 에이전트가 한국어로 프롬프트와 자료를 주고받는 환경에서 의미 손실이 단계마다 쌓이는 것입니다.

fluent-korean은 이 문장이 나온 뒤에 고치는 것이 아니라, 나오기 전에 막습니다. output-style은 Claude Code의 시스템 프롬프트 층위에 들어가는 지침이라 처음부터 다른 문장이 출력됩니다.

무엇을 할 수 있나

output-style 문서가 실제로 지시하는 내용입니다.

  • 생략된 문장 성분 복원 — 의미를 담은 성분을 빼지 않도록 지시합니다. “그러면 경고가 붙습니다”를 “그러면 이미 작업 중인 파일에도 경고 표지가 추가됩니다”처럼 맥락과 정보를 채워 씁니다
  • 완성된 문장으로 끝맺기 — 명사구, 부사구, 연결어미로 문장을 끊지 않고 서술어와 종결어미로 맺습니다. 헤더와 목록에는 강제하지 않습니다
  • 조사, 어미 복원 — “이 결정은 이후 중요 정책이 갈리는 자리. 컨텍스트 압축 전 신중 반영한다”를 “이 결정은 이후 중요한 정책에 지속적으로 영향을 주기 때문에, 컨텍스트가 압축되기 전에 신중히 반영합니다”로 씁니다
  • 비유적 어휘 대체 — “분석의 흐름”을 “분석의 방향성”으로, “코드로 박는 자리”를 “코드에 명시하는 상황”으로 바꿉니다
  • 엠대시 자제 — 앞뒤 관계를 지나치게 함축하는 엠대시(—) 대신 콜론이나 접속사를 씁니다
  • 코드 영역 제외 — 변수명, 주석, 커밋 메시지, 로그 문자열은 프로젝트의 기존 관례를 따르며 지침을 적용하지 않습니다. 인용과 코드 블록도 대상이 아닙니다
  • 서브에이전트에도 적용 — 한국어로 서브에이전트 프롬프트를 작성했다면 호출 전에 지침 준수를 점검하고, 서브에이전트 결과를 사용자에게 전달할 때도 같은 지침을 적용합니다

근거: snflkd/fluent-korean README, output-styles/fluent-korean.md.

핵심 기능

  • output-style 두 가지

    fluent-korean은 Claude Code의 코딩 지침을 유지하므로 코딩 작업에 씁니다. fluent-korean-not-coding은 코딩 지침을 제거한 판으로, Claude가 직접 코드를 변경하지 않는 작업에 씁니다.

  • 사후 교정이 아니라 사전 규율

    시스템 프롬프트에 지침이 들어가므로 출력 전에 규율합니다. 이미 작성된 글을 고치는 도구가 아닙니다.

  • 세부 동작 블록

    README에 지침 끝에 덧붙일 수 있는 텍스트 블록이 정리되어 있습니다. 초보 개발자가 이해할 수 있게 서술하기, 사용자에게 높임말 쓰기, 통용되지 않는 저빈도 어휘 자제하기, 보고뿐 아니라 한국어로 출력되는 모든 결과물에 지침 적용하기 등을 골라서 붙입니다.

  • Claude Code 밖에서도 재사용

    지침이 마크다운 텍스트라 파일 본문을 Claude 웹이나 데스크톱 앱의 개인별 지침, 프로젝트 지침에 넣어도 동작합니다. 다른 AI 환경에도 글쓰기 지침으로 넣을 수 있습니다.

  • 번역이 아니라 한국어 품질

    외국어 문장이나 어휘를 한국어로 바꾸라는 지시가 아닙니다. 고유명사와 기술 용어는 정착된 번역어나 음차가 있으면 그것을 쓰고, 없으면 원어를 유지합니다.

사용 방법

Claude Code에서 마켓플레이스를 추가하고 플러그인을 설치합니다.

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

설치 후 /config에서 output-style 항목을 열어 fluent-korean 또는 fluent-korean-not-coding을 고릅니다. output-style은 새 세션에서 적용되므로, 고른 뒤에 새 세션을 시작하거나 /clear를 실행해야 반영됩니다.

매번 고르지 않고 기본값으로 두려면 settings.json 또는 settings.local.json의 outputStyle 값을 수정합니다.

세부 동작 블록을 붙이거나 지침을 직접 수정하려면 플러그인 대신 md 파일을 배치합니다. plugins/fluent-korean/output-styles/의 파일을 사용자 디렉터리 ~/.claude/output-styles/나 프로젝트 디렉터리 .claude/output-styles/에 두면 됩니다.

알아두면 좋은 점

  • 새 세션이 필요합니다 — output-style 특성상 /config에서 고른 직후에는 적용되지 않습니다. 새 세션이나 /clear 이후부터 반영됩니다
  • 세부 동작 블록은 덮어써질 수 있습니다 — 플러그인으로 설치한 상태에서 지침 파일을 직접 수정하면 업데이트 시 사라질 수 있습니다. 커스터마이즈가 목적이면 md 파일을 직접 배치하는 방식을 씁니다
  • 데스크톱 앱의 Claude Code는 경로가 다릅니다 — /config 메뉴에 output-style 항목이 없어서, CLAUDE.md나 settings.json, settings.local.json 중 상황에 맞는 곳에 적용해야 합니다
  • 역할 구분 — 이 도구는 의미가 손실되지 않는 명확한 한국어를 목표로 합니다. 번역투 교정, AI 표현 최소화, 맞춤법 오류 제거가 필요하면 README가 im-not-ai 같은 사후 교정 도구를 함께 안내합니다
  • 작성자 — README의 영문 소개에 따르면 국문학 전공자가 작성했고, README의 한국어 부분도 사람이 직접 쓴 글입니다
  • 라이선스 — MIT
§ 6

See also

same category · curated
[01]
[Tool] OpenViking · 에이전트의 메모리, 참고 자료, 스킬을 하나의 가상 파일시스템에 모아 두는 오픈소스 컨텍스트 데이터베이스. Claude Code에 플러그인으로 연결하면 세션이 끝나도 남는 장기 기억과 자료 검색이 생깁니다.
tool · claudekit.io / tools / openviking
[02]
[Tool] Herdr · Rust로 작성된 단일 바이너리의 터미널 네이티브 에이전트 멀티플렉서. tmux식 세션 유지와 패널 분할에 에이전트 상태 추적(idle, working, blocked, done)을 더해, Claude Code를 포함한 여러 CLI 에이전트를 한 화면에서 관리합니다. Herdr는 Claude Code를 자동 감지해 직접 통합(direct integration) 설치 프롬프트를 띄우고, 승인하면 풀 상태 감지, 로컬 소켓 API를 통한 시맨틱 상태 전달, 재시작 후 에이전트 세션 복원이 동작합니다.
tool · claudekit.io / tools / herdr
[03]
[Tool] CC Workflow Studio · 캔버스 위에서 AI 에이전트 워크플로를 시각적으로 설계해, Claude Code·Cursor·Copilot 등 에이전트가 바로 실행할 수 있는 Markdown(skills·commands·agents)으로 내보내는 VS Code 익스텐션. MCP 서버가 내장돼 'Edit with AI'로 자연어 수정도 가능.
tool · claudekit.io / tools / cc-wf-studio
§ 7

자주 묻는 질문

자주 묻는 질문
§ 7.1
fluent-korean은 무엇인가요?
Claude Code가 명확한 한국어를 출력하도록 지시하는 output-style 플러그인입니다. 수려한 문체보다 의미 전달을 목표로 하며, 조사와 어미가 빠진 축약형 문장이 나오는 것을 막습니다.
§ 7.2
어떻게 설치하나요?
Claude Code에서 `/plugin marketplace add snflkd/fluent-korean`과 `/plugin install fluent-korean@fluent-korean`을 실행합니다. 그다음 `/config`에서 output-style 항목을 열어 둘 중 하나를 고르고, 새 세션을 시작하거나 `/clear`를 해야 적용됩니다.
§ 7.3
두 가지 output-style은 무엇이 다른가요?
`fluent-korean`은 Claude Code의 코딩 지침을 유지하므로 코딩 작업에 씁니다. `fluent-korean-not-coding`은 코딩 지침이 제거되어 있어 Claude가 직접 코드를 변경하지 않는 작업에 씁니다.
§ 7.4
Claude Code가 아닌 환경에서도 쓸 수 있나요?
지침 자체가 마크다운 텍스트라 플러그인 없이도 쓸 수 있습니다. `plugins/fluent-korean/output-styles/`의 md 파일 본문을 Claude 웹이나 데스크톱 앱의 개인별 지침, 프로젝트 지침에 붙여 넣으면 됩니다.
§ 7.5
AI 티 제거나 번역투 교정도 해주나요?
아닙니다. 이 플러그인은 출력 전에 명확한 한국어를 쓰도록 규율하는 도구입니다. 이미 작성된 글의 번역투 교정, AI 표현 제거가 필요하다면 README가 안내하는 대로 [Humanize KR](/ko/tools/im-not-ai) 같은 사후 교정 도구를 씁니다.
§ 7.6
무료인가요? 라이선스는?
MIT 라이선스 오픈소스로 무료입니다. Claude Code 등 실행 환경의 사용료는 별도입니다.