테마 전환
Repomix (번역일자: 2026-11-13)
저장소 전체를, AI가 한 번에 읽을 수 있는 단 한 장의 파일로.
Repomix는 프로젝트 폴더나 GitHub 저장소 전체를 훑어 디렉터리 구조와 파일 내용을 하나의 파일로 합쳐 주는 무료 오픈소스 CLI 도구입니다.
생성된 파일(repomix-output.xml)을 ChatGPT, Claude, Gemini 같은 AI 서비스에 그대로 붙여 넣으세요. AI가 파일을 하나씩 열어보며 탐색할 필요 없이, 코드베이스 전체의 맥락을 한 번에 파악해 훨씬 정확하고 깊이 있는 분석을 제공합니다. .gitignore 규칙을 준수하며, 파일별·전체 토큰 수 계산, Secretlint를 통한 민감 정보 탐지 기능을 갖췄으며, XML·Markdown·JSON·평문 등 다양한 출력 포맷을 지원합니다.
이 가이드는 yamadashy/repomix 공식 문서와 README를 바탕으로, 한국어 사용자가 핵심 기능을 빠르게 파악하고 바로 실무에 적용할 수 있도록 재구성한 13편의 시리즈입니다. (npm v1.19.0 기준)
핵심 요약
저장소 전체를 AI 친화적인 단일 파일로 변환하는 도구입니다. 구독형 AI 모델에 코드베이스 전체 맥락을 한 번에 전달하고 싶을 때 최적이며, 토큰 계산과 보안 검사 기능까지 한 번에 해결합니다.
라이선스 및 개인정보 보호
본 도구는 MIT License 하에 배포되며, 상업적 사용, 재배포, 개작이 자유롭습니다. (원저작자: Kazuki Yamada)
주의사항: CLI는 완전히 오프라인으로 동작하며 텔레메트리를 수집하지 않습니다. 다만, repomix.com 웹 서비스는 Google Analytics와 Cloudflare Turnstile을 사용하며, 업로드된 파일은 처리 즉시 삭제됩니다. 사내 비공개 저장소의 경우 가급적 CLI 사용을 권장합니다.
권리 관계: 출력된 파일의 저작권은 원본 코드의 소유자에게 그대로 귀속됩니다. 도구의 라이선스가 출력물에 영향을 주지 않습니다.
마인드맵으로 둘러보기
Repomix의 소개와 동작 원리, 설치와 명령줄 사용법, 출력 포맷·토큰·보안·MCP 연동 메뉴얼, 실전 프롬프트 예제로 이어지는 전체 학습 흐름을 살펴보세요. 각 노드를 펼치면 세부 목차를 확인할 수 있습니다.
노드를 눌러 가지를 펼치거나 접을 수 있습니다. ↗는 글로, 마지막 단계의 목차는 해당 절로 이동합니다. 넓은 지도는 좌우·상하로 스크롤하세요.
전체 글 한눈에 보기
소개·개념(2편), 사용법(6편), 메뉴얼(4편), 예제(1편)를 학습 순서대로 구성했습니다. 글 제목을 클릭하면 본문으로, 세부 목차의 항목을 클릭하면 해당 절로 바로 이동합니다.
소개 · 개념
Repomix 소개: 저장소 전체를 AI가 읽는 한 장의 파일로
Repomix가 어떤 도구인지, 왜 저장소 전체를 한 파일로 묶는지, CLI·웹·확장 중 어느 경로로 시작할 수 있는지 한눈에 읽습니다.
Repomix 동작 원리와 출력 파일의 네 블록
파일 검색에서 출력 생성까지의 처리 순서와, 만들어지는 파일의 네 블록·바이너리 처리·깃 정렬 규칙을 구조로 이해합니다.
사용법
Repomix 설치와 첫 실행
Node 요구 조건부터 npx·전역 설치·Docker 실행, 브라우저·VSCode 확장, 설치 확인과 설정 파일 초기화까지 실행 경로를 정리합니다.
Repomix 명령줄 옵션 정리
CLI 옵션 전체를 목적별로 표로 정리하고, 설정 파일과의 우선순위, 스크립트에서 바로 쓰는 조합 예제까지 가져갑니다.
Repomix 설정 파일과 무시 규칙
설정 파일 형식 선택과 우선순위, 포함·무시 규칙의 실제 판정 순서, 용량 제한과 파일 프로세서의 신뢰 경계까지 팀 표준을 만드는 기준을 담습니다.
Repomix 출력 포맷 고르기: XML·Markdown·JSON·평문
네 포맷의 실제 출력 모양과 생성 예제, XML 기본값의 근거, jq로 파일 목록·내용·메타데이터를 뽑는 명령, 모델별 권장을 한 편에 담습니다.
Repomix로 원격 GitHub 저장소 묶기
원격 저장소 지정 문법과 우선 처리 규칙, 리비전 고정, Docker·출력 제어, 설정 파일 신뢰 플래그까지 외부 코드 리뷰에 필요한 절차를 담습니다.
Repomix 워치 모드와 자동 재패킹
계속 갱신되는 스냅샷을 AI에게 넘기는 워크플로, 변경 감지와 디바운스 동작, 함께 쓸 수 없는 옵션과 그 이유를 한 편에 정리합니다.
메뉴얼
Repomix 토큰 줄이기: 진단, 필터, 압축, 분할
큰 저장소를 모델 컨텍스트에 맞추는 실무 순서 — 어디에서 토큰이 새는지 찾는 방법부터 필터, 주석 제거, 압축, 파일별 수준 지정, 분할과 예산까지 단계별로 담습니다.
Repomix 보안 검사와 프라이버시, 설정 파일 신뢰 모델
비밀정보 자동 검출의 범위와 한계, 설정 파일이 실행 코드인 이유, 원격 설정 신뢰의 확인 절차와 기억 장치, 서비스별 개인정보 처리 방침까지 안전 운영의 기준을 담습니다.
Repomix MCP 서버로 코딩 에이전트 연결하기
MCP 서버 실행과 클라이언트별 등록 설정, pack·read·grep 도구 계열의 파라미터 표, 증분 탐색으로 압축을 생략하는 근거, 샌드박스가 그어 주는 경계를 다룹니다.
Repomix를 팀에 고정시키기: Claude Code 플러그인, 에이전트 스킬, GitHub Actions
플러그인 3종과 슬래시 명령, 스킬 생성 옵션과 생성되는 다섯 개 파일, 문서 전용 스킬, Actions 입력표와 아티팩트 예제까지 Repomix를 상시 인프라로 만드는 절차를 담습니다.
예제
Repomix 실전 예제: 프롬프트, 활용 사례, 라이브러리 API
바로 복붙할 프롬프트 템플릿 아홉 종, 실전 활용 사례와 프롬프트, 모델별 권장, runCli와 핵심 API 코드, 그리고 저자의 AI 협업 원칙을 한 편에 모은 예제집입니다.