
Repomix 官方 Claude Code 插件指南MCP 服务器、Slash 命令与 AI 仓库探索【免费下载链接】repomix Repomix is a powerful tool that packs your entire repository into a single, AI-friendly file. Perfect for when you need to feed your codebase to Large Language Models (LLMs) or other AI tools like Claude, ChatGPT, DeepSeek, Perplexity, Gemini, Gemma, Llama, Grok, and more.项目地址: https://gitcode.com/GitHub_Trending/rep/repomixRepomix 为 Claude Code 提供了三个官方插件repomix-mcp、repomix-commands、repomix-explorer让你可以直接在 AI 驱动的开发环境中用自然语言完成代码库的分析与打包。本文以 website/client/src/es/guide/claude-code-plugins.md 为骨架结合仓库内 MCP 服务器与各工具的实际源码实现完整讲解插件的安装、插件间的协作关系、每个插件的命令与工作原理以及本地/远程仓库打包和 AI 探索的实战用法。插件总览三个插件如何协同工作Repomix 的 Claude Code 插件体系由三个职责互补的插件组成插件类型核心职责repomix-mcpMCP 服务器插件基础通过 MCP 服务器提供 AI 驱动的代码库分析能力repomix-commandsSlash 命令插件扩展提供便捷的斜杠命令支持自然语言操作repomix-explorerAI 分析 Agent 插件使用 Repomix CLI 智能探索代码库并输出综合分析三者之间的关系是repomix-mcp是推荐的基础底座提供打包、搜索、读取输出文件等核心能力repomix-commands在易用性上做扩展把常用操作封装成 slash 命令repomix-explorer则叠加 AI 分析能力自动决定如何打包、在哪里 grep、读哪些片段。三者可以独立安装但组合使用才能获得最完整的体验。从源码看MCP 插件的能力由 src/mcp/mcpServer.ts 中注册的repomix-mcp-server提供其工具集包括pack_codebase、pack_remote_repository、read_repomix_output、grep_repomix_output、generate_skill、attach_packed_output以及在沙箱模式下启用的file_system_read_file、file_system_read_directory。服务器内置的指令文本明确描述了典型用法先用pack_codebase或pack_remote_repository把代码整合为单个 XML 文件再用read_repomix_output和grep_repomix_output进行分析。安装插件1. 添加 Repomix 插件市场首先把 Repomix 的插件市场注册到 Claude Code/plugin marketplace add yamadashy/repomix2. 安装具体插件市场注册成功后按需安装插件# 安装 MCP 服务器插件推荐的基础组件 /plugin install repomix-mcprepomix # 安装命令插件扩展功能 /plugin install repomix-commandsrepomix # 安装仓库探索器插件AI 驱动的分析 /plugin install repomix-explorerrepomix[!TIP]repomix-mcp插件被推荐作为基础组件。repomix-commands提供便捷的 slash 命令repomix-explorer增加 AI 驱动的分析能力。虽然可以独立安装但三者一起使用体验最完整。3. 交互式安装也可以直接使用 Claude Code 的交互式插件安装器/plugin这会打开一个交互界面可以在其中浏览并安装可用的插件。三个插件的详细能力1. repomix-mcpMCP 服务器插件这是基础插件通过 MCP 服务器集成提供 AI 驱动的代码库分析。核心特性打包本地与远程仓库将目录或 GitHub 仓库整合为单个文件供 AI 分析搜索打包输出在生成的输出文件中执行正则搜索读取生成的输出文件支持按行区间分段读取适配大文件Tree-sitter 自动压缩提取代码签名与结构约减少 70% 的 token 消耗底层实现中打包工具由 src/mcp/tools/packCodebaseTool.ts 的pack_codebase提供。它支持的输入参数包括参数说明directory要打包的目录。非沙箱模式接受绝对路径沙箱模式下必须是相对工作区根目录的路径如.或srccompress是否启用 Tree-sitter 压缩默认false。启用后约减少 70% token 消耗includePatternsfast-glob 包含模式多个模式可用逗号分隔如**/*.{js,ts}、src/**,docs/**ignorePatterns额外的排除模式补充在.gitignore与内置排除规则之上如node_modules/**,dist/**outputPatterns输出文件结构模式topFilesLength指标摘要中展示的最大文件数量默认 10style输出格式xml默认结构化标签、markdown人类可读、json机器可读、plain带分隔符的纯文本远程仓库打包由 src/mcp/tools/packRemoteRepositoryTool.ts 的pack_remote_repository提供其remote参数支持user/repo、https://github.com/user/repo以及https://github.com/user/repo/tree/branch等 GitHub URL 格式内部会自动克隆并打包。在沙箱模式下--sandboxsrc/mcp/mcpServer.ts 会做严格约束远程打包、技能生成、外部文件附加等工具被禁用所有路径必须限制在工作区根目录内且 include/ignore 模式不允许出现绝对路径、..、~等逃逸写法。2. repomix-commandsSlash 命令插件提供便捷的斜杠命令支持自然语言指令/repomix-commands:pack-local— 以多种选项打包本地代码库/repomix-commands:pack-remote— 打包并分析远程 GitHub 仓库这些命令内部会调用与 MCP 插件相同的打包管线runCli因此天然继承--compress、--include、--style等 CLI 能力。3. repomix-explorerAI 分析 Agent 插件AI 驱动的仓库分析 Agent使用 Repomix CLI 智能探索代码库。核心特性自然语言代码库探索与分析直接描述意图无需记忆具体命令智能模式发现与代码结构理解自动定位关键组件、接口与依赖关系增量式分析先用 grep 定位再有针对性地读取具体文件避免一次性吞入整个输出大仓库自动上下文管理对超大型仓库自动启用压缩与分段读取控制上下文消耗可用命令/repomix-explorer:explore-local— 在 AI 辅助下分析本地代码库/repomix-explorer:explore-remote— 在 AI 辅助下分析远程 GitHub 仓库工作原理仓库内 skills/repomix-explorer/SKILL.md 有完整定义运行npx repomixlatest打包仓库远程仓库建议输出到/tmp避免污染当前项目目录使用 Grep 与 Read 工具在输出文件中高效检索先grep -iE定位模式再按 offset/limit 分段读取在不过度消耗上下文的前提下给出综合分析文件数、token 数、目录树、关键发现与后续建议SKILL.md 中还给出了一系列实用建议大于 10 万行代码的仓库务必使用--compress优先用 grep 而非整文件读取多个仓库分析时使用--output自定义路径避免覆盖常用 grep 模式包括函数与类export.*function|export.*class、导入依赖import.*from、API 端点router|route|endpoint|api等。实战用法示例打包本地代码库使用/repomix-commands:pack-local加自然语言指令/repomix-commands:pack-local 把这个项目打包成 Markdown 格式并启用压缩更多示例只打包 src 目录打包 TypeScript 文件并带上行号生成 JSON 格式的输出打包远程仓库使用/repomix-commands:pack-remote分析 GitHub 仓库/repomix-commands:pack-remote yamadashy/repomix 只打包 yamadashy/repomix 仓库中的 TypeScript 文件更多示例打包 main 分支并启用压缩只包含文档文件打包指定目录用 AI 探索本地代码库使用/repomix-explorer:explore-local进行 AI 驱动的分析/repomix-explorer:explore-local ./src 找出所有与认证相关的代码更多示例分析这个项目的结构告诉我主要的组件有哪些找出所有 API 端点用 AI 探索远程仓库使用/repomix-explorer:explore-remote分析 GitHub 仓库/repomix-explorer:explore-remote facebook/react 展示主要的组件架构更多示例找出仓库中所有的 React hooks解释项目的目录结构错误边界定义在哪里输出文件的检索与读取机制无论通过哪种方式打包产物都会被登记为带唯一outputId的输出文件之后即可用两个 MCP 工具做增量分析这正是不消耗过多上下文的技术基础grep_repomix_output按 src/mcp/tools/grepRepomixOutputTool.ts 的实现支持patternJavaScript RegExp 语法、contextLines、beforeLines/afterLines类似grep -B/-A优先级高于contextLines与ignoreCase。结果返回匹配行号、行内容、匹配文本以及格式化输出方便 Agent 精确引用行号。read_repomix_output按 src/mcp/tools/readRepomixOutputTool.ts 的实现支持startLine/endLine按 1 起始的行区间分段读取返回totalLines、linesRead等元信息对 startLine endLine、起始行超出文件总行数等非法输入都会返回明确的错误信息。值得注意的安全细节对于从不可信路径附加的输出文件这两个工具在返回内容前都会先执行 secretlint 扫描见requiresSecretScan与runSecretLint的调用命中已知密钥格式时直接拒绝返回防止敏感信息进入模型上下文。打包过程同样默认开启securityCheck: true自动过滤已知的敏感文件格式。深入MCP 服务器如何被插件复用插件与 MCP 服务器共享同一套打包引擎。观察 src/mcp/tools/packCodebaseTool.ts 可以看到pack_codebase工具内部就是构造CliOptions并调用runCli完成的——包括compress、include、ignore、style、topFilesLen、securityCheck等参数与 CLI 的命令行选项一一对应。这意味着你通过/repomix-commands:pack-local输入的自然语言选项、通过/repomix-explorer:explore-local触发的智能打包以及通过pack_codebaseMCP 工具发起的调用最终都收敛到同一条经过充分测试的打包管线。沙箱模式下src/mcp/mcpServer.ts 还会额外注入一套约束指令所有路径必须相对工作区根目录如src/index.ts.表示整个工作区拒绝绝对路径、/、~/、../、盘符与..段pack_codebase同时禁用本地与全局配置文件读取、限制搜索范围并关闭基于 git 的排序避免不可信仓库的.git/config成为命令执行向量。相关资源MCP 服务器文档 — 了解底层 MCP 服务器的完整能力配置文档 — 自定义 Repomix 行为安全文档 — 理解安全特性命令行选项文档 — 可用的 CLI 选项插件源码位置插件的源码均维护在 Repomix 仓库中插件市场目录为.claude-pluginMCP 插件、命令插件与仓库探索器插件分别位于.claude/plugins/repomix-mcp、.claude/plugins/repomix-commands与.claude/plugins/repomix-explorer。仓库内src/mcp/下的服务器与工具实现mcpServer.ts、packCodebaseTool.ts、packRemoteRepositoryTool.ts、grepRepomixOutputTool.ts、readRepomixOutputTool.ts以及 skills/repomix-explorer/SKILL.md 中的完整 Agent 工作流是理解插件行为的最佳参考资料对应测试见 tests/mcp/tools/ 下的packCodebaseTool.test.ts、grepRepomixOutputTool.test.ts等用例。【免费下载链接】repomix Repomix is a powerful tool that packs your entire repository into a single, AI-friendly file. Perfect for when you need to feed your codebase to Large Language Models (LLMs) or other AI tools like Claude, ChatGPT, DeepSeek, Perplexity, Gemini, Gemma, Llama, Grok, and more.项目地址: https://gitcode.com/GitHub_Trending/rep/repomix创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考