repomix 2026:一条命令把整个代码库打包成 LLM 可用的单文件
repomix(前身 repopack)将 Git 仓库整体打包为结构化纯文本,适配 Claude、ChatGPT、Gemini 的上下文窗口。14k+ Star,零配置,npx 秒跑。
- ⭐ 14200
- Node.js
- TypeScript
- CLI
- MIT
- 更新于 2026-06-09

当你让 Claude 或 ChatGPT 调试跨文件 bug 时,一段一段粘贴代码很快就会失去上下文。repomix 的解决方案是:把整个代码库打包成一个结构化文件,几秒内放入任意 LLM 的上下文窗口。
repomix 做了什么 #
repomix 扫描仓库,排除 .gitignore 中的文件,输出包含以下内容的单一文本:
- 仓库摘要 — 文件数、token 估算、语言分布
- 目录树 — 完整文件夹结构
- 所有源文件 — 每个文件前加路径标题和可选行号
输出结果可直接用于 Claude、ChatGPT、Gemini、Cursor,或任何接受文件上传的 LLM。
零配置快速开始 #
# 无需安装,用 npx 直接运行
npx repomix
# 全局安装
npm install -g repomix
# 打包指定目录
repomix ./src
# 直接打包远程 GitHub 仓库(无需 git clone)
npx repomix --remote https://github.com/user/repo
输出格式 #
| 格式 | 参数 | 最适合 |
|---|---|---|
| 纯文本 | --style plain(默认) | ChatGPT、通用 LLM |
| XML | --style xml | Claude(原生 XML)、结构化解析 |
| Markdown | --style markdown | Copilot、文档工作流 |
过滤输出(大项目用) #
# 只包含 src/ 下的 TypeScript 文件
repomix --include "src/**/*.ts"
# 排除测试和构建产物
repomix --ignore "**/*.test.ts,dist/**"
# 显示行号(方便 LLM 给出精确编辑位置)
repomix --output-show-line-numbers
典型工作流 #
# 全仓库 code review
repomix --style xml --output review.xml
# → 上传到 Claude Project
# → "请帮我审查这段代码的安全问题和架构设计"
# 远程仓库分析(无需 clone)
npx repomix --remote https://github.com/some-org/some-project
# → "总结这个项目的架构,用了哪些设计模式?"
安全提示:.repomixignore #
repomix 默认遵守 .gitignore,但未被 gitignore 的敏感文件(如本地 .env)可能进入输出。在项目根目录创建 .repomixignore 显式排除:
.env
.env.local
config/credentials.json
需要服务器来构建 AI 开发工具? DigitalOcean 新用户享 $200 免费额度,足够运行开发服务器或部署 AI 辅助代码库。
GitHub: yamadashy/repomix · 14.2k ⭐ · MIT
💬 留言讨论