Humanize KR 사용법: 한글 AI 티 제거기 im-not-ai 설치와 활용 팁

작성 기준: 이 글은 2026년 6월 21일 GitHub 공개 저장소 epoko77-ai/im-not-ai의 README, INSTALL 문서, 최신 릴리스 정보를 확인해 정리했습니다. 기능과 설치 방법은 저장소 업데이트에 따라 달라질 수 있습니다.

AI로 초안을 빨리 쓰는 사람은 많아졌지만, 그대로 공개하면 어딘가 어색한 번역투와 기계적인 문장 구조가 남는 경우가 많습니다. 특히 한국어 글에서는 “~를 통해”, “~에 있어서”, “결론적으로”, “시사하는 바가 크다” 같은 표현이 반복되면 독자가 금방 AI 초안처럼 느낄 수 있습니다.

Humanize KR은 이런 한글 AI 문체를 줄이기 위해 만들어진 GitHub 공개 프로젝트입니다. 저장소 이름은 im-not-ai이고, 설명은 “AI가 쓴 글이 아닌 것처럼 윤문해주는 스킬”입니다. Claude Code, OpenAI Codex CLI, Gemini CLI 환경에서 한국어 글의 문체와 리듬을 자연스럽게 다듬는 것을 목표로 합니다.

핵심 요약

• Humanize KR은 한국어 AI 초안의 번역투, 기계적 구조, 과한 접속사, 피동태 남용 등을 줄이기 위한 윤문 도구입니다.
• GitHub 저장소명은 epoko77-ai/im-not-ai이며 MIT 라이선스로 공개되어 있습니다.
• Claude Code에서는 플러그인 마켓플레이스 설치를 지원하고, Codex CLI와 Gemini CLI는 주로 Fast 단일 호출 방식으로 사용할 수 있습니다.
• 프로젝트는 의미 보존, 근거 기반 수정, 장르 유지, 과윤문 금지를 중요한 원칙으로 둡니다.
• AI 탐지기 우회를 보장하는 도구가 아니라, 사람이 읽기 좋은 한국어 문장으로 다듬는 보조 도구로 보는 것이 안전합니다.

Humanize KR은 무엇을 해주는 도구인가요?

Humanize KR은 ChatGPT, Claude, Gemini 같은 AI가 작성한 한국어 문장을 더 자연스럽게 다듬는 데 초점을 둔 스킬 묶음입니다. 단순히 문장을 “예쁘게” 바꾸는 것보다, 한국어에서 AI 티가 나는 패턴을 먼저 찾고 그 부분만 수술적으로 고치는 접근을 내세웁니다.

README에 따르면 이 프로젝트는 번역투, 과도한 영어 병기, 기계적인 “첫째·둘째·셋째” 구조, 문두 접속사 남발, 이모지와 불릿 남용, 피동태 남용 같은 패턴을 분류해 탐지합니다. 이후 원문의 사실, 주장, 수치, 고유명사, 직접 인용은 보존하면서 문체와 리듬만 다듬는 방향으로 동작합니다.

2026년 6월 21일 확인 기준으로 저장소는 Python과 Shell 중심으로 구성되어 있고, GitHub에서 별 3,142개와 포크 316개를 기록하고 있습니다. 최신 릴리스는 v2.0.0입니다.

왜 한글 특화 도구가 필요한가요?

영어권에는 이미 humanizer나 paraphraser라는 이름의 문장 다듬기 도구가 많습니다. 하지만 한국어 글의 어색함은 영어권 글과 결이 다릅니다. 영어 문장 구조를 그대로 옮긴 듯한 번역투, “~할 수 있을 것으로 보인다”처럼 완곡 표현이 겹치는 문장, “그/그녀”를 반복하는 표현은 한국어 독자에게 특히 부자연스럽게 느껴집니다.

예를 들어 “AI 기술을 통해 효율을 높일 수 있다”는 문장은 틀린 문장은 아니지만, 글 전체에 이런 구조가 반복되면 기계적으로 보입니다. 상황에 따라 “AI로 효율을 높인다”처럼 줄이는 편이 더 자연스러울 수 있습니다. Humanize KR은 이런 한국어 특유의 어색함을 패턴으로 관리한다는 점이 차별점입니다.

지원 환경과 설치 방법

저장소의 INSTALL 문서 기준으로 Humanize KR은 Claude Code, OpenAI Codex CLI, Gemini CLI를 지원합니다. 다만 도구별로 가능한 모드가 다릅니다.

Claude Code에서 설치

Claude Code를 사용한다면 플러그인 마켓플레이스 설치가 가장 간단합니다.

/plugin marketplace add epoko77-ai/im-not-ai
/plugin install humanize-korean@im-not-ai

설치 후 새 세션에서 /humanize-korean, /humanize, /humanize-redo 같은 명령을 쓰거나 “이 글 AI 티 없애줘”처럼 자연어로 요청할 수 있습니다.

클론 후 설치

저장소를 직접 받아 설치하는 방법도 제공됩니다.

git clone https://github.com/epoko77-ai/im-not-ai.git
cd im-not-ai
./install.sh

한쪽 환경만 설치하려면 --claude-only, --codex-only, --gemini-only 옵션을 사용할 수 있습니다. 스크립트 설치 방식에서는 ./update.sh로 업데이트를 확인하고 반영할 수 있습니다.

Fast 모드와 Strict 모드 차이

README는 사용 흐름을 크게 Fast 모드와 Strict 모드로 나눕니다.

• Fast 모드: 짧은 글이나 빠른 윤문에 적합한 단일 호출 방식입니다. 탐지, 윤문, 자체 검증을 한 번에 처리하는 흐름입니다.
• Strict 모드: 긴 글이나 의미 보존이 중요한 글에 적합한 다단계 파이프라인입니다. AI 티 탐지, 문체 수정, 내용 감사, 자연스러움 검증을 분리해 진행합니다.

INSTALL 문서에 따르면 Codex CLI와 Gemini CLI는 주로 Fast 단일 호출 방식이고, Claude Code에서 정밀한 strict 파이프라인 사용이 가능합니다. 중요한 보고서, 대외 발행 글, 브랜드 문서라면 빠른 윤문보다 Strict 모드로 검토하는 편이 안전합니다.

사용할 때 좋은 글과 피해야 할 글

Humanize KR은 “초안은 있는데 문장이 너무 AI 같다”는 상황에 잘 맞습니다. 블로그 초안, 뉴스레터, 제품 소개문, 사내 공지, 자기소개서 초안처럼 내용의 뼈대는 이미 정해져 있고 문체만 자연스럽게 만들고 싶을 때 유용합니다.

반대로 사실 확인이 필요한 글을 그대로 맡겨서는 안 됩니다. 윤문 도구는 문장을 다듬는 도구이지, 자료 조사나 검증을 대신하는 도구가 아닙니다. 수치, 법률, 세금, 건강, 투자 정보가 들어간 글은 윤문 전후로 출처를 다시 확인해야 합니다.

사용 전 주의할 점

1. AI 탐지기 우회를 보장한다고 보면 안 됩니다

프로젝트 이름과 기능 때문에 “AI 탐지기를 속이는 도구”로 오해하기 쉽지만, 실무에서는 그렇게 접근하지 않는 편이 안전합니다. AI 탐지기는 기준이 불투명하고 결과도 흔들릴 수 있습니다. 이 도구는 탐지기 우회보다 독자가 읽기 좋은 자연스러운 한국어를 만드는 보조 도구로 쓰는 것이 적절합니다.

2. 의미가 바뀌지 않았는지 반드시 확인하세요

Humanize KR은 의미 보존을 중요한 원칙으로 내세우지만, 어떤 윤문 도구든 결과 검토는 필요합니다. 특히 고유명사, 숫자, 인용문, 계약 조건, 의료·법률 표현은 수정 후 원문과 대조하세요.

3. 개인정보와 내부 문서는 조심해서 다루세요

CLI 도구에 입력하는 글에도 개인정보, 고객 정보, 회사 내부 정보가 포함될 수 있습니다. 외부 AI 모델을 호출하는 환경이라면 조직의 보안 정책을 먼저 확인하고, 필요한 경우 민감한 정보를 제거한 뒤 테스트하는 것이 좋습니다.

5분 테스트 체크리스트

1. Claude Code, Codex CLI, Gemini CLI 중 본인이 사용할 환경을 정합니다.
2. 공식 저장소의 INSTALL.md를 열어 설치 방식을 확인합니다.
3. 처음에는 짧은 테스트 문단으로 Fast 모드를 실행합니다.
4. 윤문 전후 문장을 비교해 사실, 숫자, 고유명사가 바뀌지 않았는지 봅니다.
5. 긴 글이나 대외 발행 글은 Claude Code의 strict 흐름처럼 검증 단계가 있는 방식으로 처리합니다.

누구에게 추천할 만한가요?

• AI로 초안을 쓰지만 최종 문장은 직접 다듬고 싶은 블로거
• 한국어 뉴스레터나 공지문을 자주 쓰는 1인 사업자
• 번역투가 섞인 제품 소개문을 자연스럽게 바꾸고 싶은 마케터
• Claude Code나 Codex CLI를 이미 쓰고 있어 스킬 기반 워크플로를 실험해보고 싶은 개발자

FAQ

Humanize KR은 무료인가요?

저장소는 MIT 라이선스로 공개되어 있습니다. 다만 Claude Code, Codex CLI, Gemini CLI 등 실제 실행 환경에서 사용하는 AI 모델 비용이나 구독 비용은 별도로 확인해야 합니다.

ChatGPT 웹사이트에서 바로 쓰는 도구인가요?

아닙니다. 이 프로젝트는 Claude Code, Codex CLI, Gemini CLI 같은 개발자용 CLI 환경에서 쓰는 스킬과 에이전트 구성을 제공합니다. 일반 웹 챗봇에 붙여 넣는 프롬프트 모음과는 성격이 다릅니다.

한국어가 아닌 영어 글에도 쓸 수 있나요?

프로젝트의 핵심은 한글 AI 문체와 번역투 탐지입니다. 영어 글을 다듬는 범용 humanizer를 찾는다면 다른 도구가 더 맞을 수 있습니다.

블로그 글에 바로 적용해도 되나요?

가능하지만 최종 검수는 직접 해야 합니다. 특히 정보성 글은 윤문보다 사실 확인이 더 중요합니다. 출처가 필요한 문장은 링크를 유지하고, 변경 후 의미가 달라지지 않았는지 확인하세요.

직접 실행해 본 설치 화면

아래는 저장소를 실제로 클론한 뒤 install.sh를 --dry-run으로 실행해 Claude Code에 어떤 스킬과 에이전트 파일이 설치되는지 확인한 화면입니다. 처음에는 dry-run으로 경로를 확인한 다음 실제 설치를 진행하는 편이 안전합니다.

실행 방법 요약

git clone https://github.com/epoko77-ai/im-not-ai.git
cd im-not-ai
./install.sh --dry-run --claude-only
./install.sh --claude-only

# 새 Claude Code 세션에서
/humanize-korean
# 또는
/humanize

Codex CLI나 Gemini CLI를 쓰는 경우에는 --codex-only, --gemini-only 옵션을 확인합니다. 윤문 결과는 반드시 원문과 대조해 숫자, 고유명사, 인용, 사실관계가 바뀌지 않았는지 확인해야 합니다.

출처

• epoko77-ai/im-not-ai GitHub 저장소
• Humanize KR README
• Humanize KR 설치 가이드
• v2.0.0 릴리스
• MIT 라이선스