Fluent Korean

무엇인가

Claude Code의 시스템 프롬프트에 한국어 작성 지침을 추가하는 오픈소스 output-style 플러그인이다. 검토 시점에는 코딩 지침을 유지하는 fluent-korean과 이를 제외하는 fluent-korean-not-coding 두 변형을 MIT 라이선스로 제공한다.

목표는 수려한 문체보다 한국어 조사·보고서·결과물에서 의미가 명확하게 전달되도록 하는 데 있다. 조사와 어미 누락, 명사 나열, 잘못된 어휘 사용을 줄인다. 지침 텍스트 자체는 Claude Code 밖의 AI 환경에서도 일반적인 글쓰기 지침으로 활용할 수 있다.

적용

• Claude Code로 한국어 지시를 받아 코드를 수정할 때는 코딩 지침을 유지하는 변형을 고르고, 조사·설명처럼 코드를 직접 변경하지 않는 작업에는 non-coding 변형을 고른다.
• Fluent Korean은 생성 시점의 출력 지침으로 사용한다. 초안 작성 후 패턴 탐지, 로컬 교정, 변경률 게이트가 필요하면 Humanize KR와 비교한다.
• 여러 에이전트가 한국어 자료와 결과를 주고받는 워크플로에서는 단계별 표현 차이를 줄이도록 공통 출력 규칙으로 설정하는 방안을 검토한다.
• Cursor 같은 다른 AI 코딩 환경에서는 플러그인 자체가 아니라 지침 텍스트를 해당 환경의 프로젝트 규칙으로 이식해야 한다.

한계

• 한국어 품질이 얼마나 개선되는지와 추론 품질에 미치는 영향은 저장소 자체의 설명과 예시에 근거하며, 독립적인 평가는 확인되지 않았다.

• Claude Code 플러그인으로 설치된 파일을 직접 수정하면 업데이트 시 덮어써질 수 있다.

• 기능, 설치 방법, 유지관리 상태는 2026-08-19 GitHub 저장소 기준이다.

• Fluent Korean