FAQ 및 문제 해결
이 페이지는 Repomix 워크플로를 선택하고, 큰 출력을 줄이고, AI 어시스턴트에 전달할 코드베이스 컨텍스트를 준비할 때 자주 묻는 질문에 답합니다.
자주 묻는 질문
Repomix는 무엇에 사용하나요?
Repomix는 저장소를 하나의 AI 친화적 파일로 패키징합니다. ChatGPT, Claude, Gemini 같은 AI 어시스턴트에 전체 코드베이스 컨텍스트를 제공하여 코드 리뷰, 버그 조사, 리팩터링, 문서화, 온보딩에 활용할 수 있습니다.
비공개 저장소에도 사용할 수 있나요?
예. 로컬에서 접근 가능한 checkout 안에서 Repomix를 실행하세요.
repomix외부 AI 서비스에 공유하기 전에 생성된 파일을 직접 검토하세요.
공개 GitHub 저장소를 클론 없이 처리할 수 있나요?
예. --remote에 축약형이나 전체 URL을 지정합니다.
npx repomix --remote yamadashy/repomix
npx repomix --remote https://github.com/yamadashy/repomix어떤 출력 형식을 선택해야 하나요?
기본값인 XML부터 시작하세요. 읽기 쉬운 대화에는 Markdown, 자동화에는 JSON, 최대 호환성에는 plain text가 적합합니다.
repomix --style markdown
repomix --style json자세한 내용은 출력 형식을 참고하세요.
토큰 사용량 줄이기
생성된 파일이 너무 큽니다. 어떻게 해야 하나요?
대상 범위를 좁히세요.
repomix --include "src/**/*.ts,docs/**/*.md"
repomix --ignore "**/*.test.ts,dist/**"
repomix --compress
repomix --remove-comments큰 저장소에서는 include/ignore 패턴과 코드 압축을 함께 사용하는 것이 좋습니다.
--compress는 무엇을 하나요?
--compress는 import, export, class, function, interface 같은 중요한 구조를 유지하면서 많은 구현 세부 정보를 제거합니다. 모델이 전체 아키텍처를 이해해야 할 때 유용합니다.
보안 및 개인정보
CLI가 코드를 업로드하나요?
Repomix CLI는 로컬에서 실행되며 출력 파일을 내 컴퓨터에 씁니다. 웹사이트와 브라우저 확장은 다른 흐름을 가지므로 개인정보 처리방침을 확인하세요.
Secret 포함을 어떻게 방지하나요?
Repomix는 Secretlint 기반 안전 점검을 사용합니다. 하지만 보조 안전장치로 보고, 출력 파일은 항상 직접 검토하세요.
문제 해결
출력에 파일이 누락됩니다.
Repomix는 .gitignore, 기본 ignore 규칙, 사용자 지정 ignore 패턴을 따릅니다. repomix.config.json, --ignore, git ignore 설정을 확인하세요.
팀에서 같은 출력을 재현하려면?
공유 설정 파일을 만들고 커밋하세요.
repomix --init추가 자주 묻는 질문
Repomix는 C#, Python, Java, Go, Rust 같은 다른 언어 저장소에서도 동작하나요?
예. Repomix는 프로젝트 파일을 읽어 AI 도구에 맞게 포맷하므로 어떤 프로그래밍 언어로 작성된 저장소도 패킹할 수 있습니다. CLI를 실행하려면 Node.js 22 이상이 필요합니다. Tree-sitter 기반 코드 압축 같은 일부 고급 기능은 언어별 파서 지원 여부에 따라 달라질 수 있습니다.
Hermes Agent, OpenClaw 또는 다른 MCP 호환 에이전트와 Repomix를 사용할 수 있나요?
예. Repomix는 MCP 서버로 실행할 수 있습니다:
npx -y repomix --mcpHermes Agent에서는 ~/.hermes/config.yaml에 Repomix를 stdio MCP 서버로 추가합니다:
mcp_servers:
repomix:
command: "npx"
args: ["-y", "repomix", "--mcp"]OpenClaw 또는 다른 MCP 호환 에이전트에서는 외부 stdio MCP 서버를 설정하는 위치에 동일한 command와 args를 사용합니다. Assistant가 Agent Skills를 지원한다면 Repomix Explorer Skill도 사용할 수 있습니다.
AI 어시스턴트가 새 라이브러리나 프레임워크를 이해하도록 Repomix를 어떻게 사용하나요?
라이브러리 저장소나 문서를 패킹한 뒤, 그 출력을 AI 어시스턴트에게 참고 자료로 제공합니다:
npx repomix --remote owner/repo
npx repomix --remote owner/repo --include "docs/**,src/**"반복해서 사용할 경우 재사용 가능한 Agent Skills 디렉터리로 생성할 수도 있습니다:
npx repomix --remote owner/repo --skill-generate library-referenceCSS, 테스트, 빌드 출력 또는 노이즈가 많은 파일은 어떻게 제외하나요?
일회성 명령에는 --ignore를 사용합니다:
repomix --ignore "**/*.css,**/*.test.ts,dist/**,coverage/**"특정 소스나 문서 경로만 남기려면 --include를 사용합니다:
repomix --include "src/**/*.ts,docs/**/*.md"저장소 크기 제한이 있나요?
CLI에는 고정된 저장소 크기 제한이 없지만, 매우 큰 저장소는 메모리, 파일 크기, AI 도구의 업로드 및 컨텍스트 제한의 영향을 받을 수 있습니다. 큰 프로젝트에서는 대상 include 패턴으로 시작하고, 토큰이 큰 파일을 확인한 뒤 필요하면 출력을 분할하세요:
repomix --token-count-tree 1000
repomix --split-output 1mb--include를 사용해도 node_modules, 빌드 디렉터리 또는 무시된 경로의 파일이 포함되지 않는 이유는 무엇인가요?
--include는 Repomix가 패킹하려는 파일을 좁히지만, ignore 규칙은 계속 적용됩니다. 파일은 .gitignore, .ignore, .repomixignore, 내장 기본 패턴 또는 repomix.config.json에 의해 제외될 수 있습니다. 고급 경우에는 --no-gitignore 또는 --no-default-patterns를 사용할 수 있지만, 의존성, 빌드 산출물 또는 다른 노이즈 파일까지 포함될 수 있으므로 주의하세요.