Repomix Claude Code 插件完全指南MCP 集成、斜杠命令与 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 提供了官方插件体系将「整个仓库打包成单文件、喂给大模型」的核心能力无缝嵌入 AI 驱动的开发环境。本文完整讲解三个官方插件的安装、能力边界与工作原理并结合仓库源码MCP 服务器实现与打包工具链说明底层机制读完你可以在 Claude Code 中直接用自然语言完成本地/远程仓库的打包、检索与智能分析。插件体系概览三个插件各司其职Repomix 为 Claude Code 提供的插件共三个分别覆盖「基础打包能力」「便捷斜杠命令」「AI 驱动的探索分析」三个层次插件类型核心定位推荐度repomix-mcpMCP 服务器插件通过 MCP 协议提供 AI 驱动的代码库分析基础能力基础必备repomix-commands斜杠命令插件提供支持自然语言的快捷打包命令扩展repomix-explorerAI 分析代理插件用 AI 智能探索代码库结构、发现模式进阶三者可以独立安装但官方推荐将repomix-mcp作为基础同时使用三者以获得最完整的体验。从仓库结构看插件的实际分析能力由位于 src/mcp 下的 MCP 服务器实现提供斜杠命令与探索器插件则是围绕它构建的更高层封装。安装步骤1. 添加 Repomix 插件市场在 Claude Code 中输入/plugin marketplace add yamadashy/repomix2. 安装插件# 安装 MCP 服务器插件推荐基础 /plugin install repomix-mcprepomix # 安装命令插件扩展功能 /plugin install repomix-commandsrepomix # 安装仓库探索器插件AI 驱动分析 /plugin install repomix-explorerrepomix替代方案交互式安装直接输入/plugin打开交互式安装界面浏览并安装可用插件。repomix-mcpMCP 服务器插件基础这是整个插件体系的地基通过 Model Context Protocol 服务器集成提供 AI 驱动的代码库分析能力其功能包括打包本地和远程仓库把目录或 GitHub 仓库合并为单个结构化文件搜索打包输出在生成的文件中进行 grep 式检索读取生成的输出文件按行范围增量读取避免一次载入全部内容自动 Tree-sitter 压缩抽取代码签名与结构、去除实现细节可减少约 70% 的 token 消耗底层实现MCP 服务器与工具注册MCP 服务器的核心实现在 src/mcp/mcpServer.ts。createMcpServer函数创建名为repomix-mcp-server的服务器实例并通过registerPackCodebaseTool、registerReadRepomixOutputTool、registerGrepRepomixOutputTool注册三个始终可用的只读工具src/mcp/mcpServer.ts非沙箱模式下还会额外注册远程打包、Skill 生成与附加输出等工具src/mcp/mcpServer.ts。对外暴露的核心工具如下工具名作用实现文件pack_codebase打包本地目录输出指标、文件树与格式化代码src/mcp/tools/packCodebaseTool.tspack_remote_repository克隆并打包远程 GitHub 仓库src/mcp/tools/packRemoteRepositoryTool.tsread_repomix_output按行号区间读取打包输出文件src/mcp/tools/readRepomixOutputTool.tsgrep_repomix_output用 JavaScript 正则搜索输出文件支持上下文行src/mcp/tools/grepRepomixOutputTool.tsfile_system_read_file/file_system_read_directory直接读取工作区文件/目录仅沙箱模式src/mcp/tools/fileSystemReadFileTool.ts 等pack_codebase的输入参数见 src/mcp/tools/packCodebaseTool.ts与 CLI 打包选项一一对应是理解打包能力的关键directory要打包的目录沙箱模式下需为相对工作区根目录的路径非沙箱模式下可用绝对路径compress是否启用 Tree-sitter 压缩默认false源码注释说明它「抽取关键代码签名与结构、移除实现细节token 减少约 70%」由于grep_repomix_output支持增量检索一般仅在确需大仓库全量内容时开启includePatterns/ignorePatternsfast-glob 模式字符串多个模式可用逗号分隔如**/*.{js,ts}、src/**,docs/**ignore在.gitignore与内置排除规则之上追加style输出格式xml默认结构化标签、markdown人类可读、json机器可读、plain简单分隔文本topFilesLength指标摘要中展示的最大文件数量默认 10沙箱模式的安全边界MCP 服务器支持--sandbox模式详见 website/client/src/zh-cn/guide/mcp-server.md此时所有路径相对于工作区根目录解析绝对路径、~、..、Windows 驱动器/UNC 路径及符号链接越界路径均被拒绝仅注册pack_codebase、read_repomix_output、grep_repomix_output与两个file_system_*工具远程打包、Skill 生成、附加外部输出被禁用。代码层面沙箱模式会启用skipLocalConfig、skipGlobalConfig、confineToBaseDir与gitSortByChanges: false等隔离选项src/mcp/tools/packCodebaseTool.ts防止工作区配置文件外泄、限制搜索范围并禁用会读取不受信任.git/config的 git 排序。read_repomix_output与grep_repomix_output在服务内容前还会对来源不可信的输出文件执行 secretlint 扫描命中即拒绝返回src/mcp/tools/readRepomixOutputTool.ts。repomix-commands斜杠命令插件提供两个支持自然语言指令的快捷命令/repomix-commands:pack-local使用各种选项打包本地代码库/repomix-commands:pack-remote打包并分析远程 GitHub 仓库其能力本质上是把 src/mcp/tools/packCodebaseTool.ts 与 src/mcp/tools/packRemoteRepositoryTool.ts 中pack_codebase/pack_remote_repository工具的参数空间compress、includePatterns、style等封装为对话式命令让用户无需记忆参数名称直接用自然语言描述打包需求。repomix-explorerAI 分析代理插件AI 驱动的仓库分析代理使用 Repomix CLI 智能探索代码库定位是「理解不熟悉或大型仓库的整体情况」而非定向编辑。功能特性自然语言代码库探索与分析智能模式发现与代码结构理解使用 grep 和定向文件读取进行增量分析大型仓库的自动上下文管理可用命令/repomix-explorer:explore-localAI 辅助分析本地代码库/repomix-explorer:explore-remoteAI 辅助分析远程 GitHub 仓库工作原理三步流程运行npx repomixlatest打包仓库使用 Grep 和 Read 工具高效搜索输出提供全面分析而不消耗过多上下文仓库中 skills/repomix-explorer/SKILL.md 完整定义了该代理的行为协议其分析工作流包括先运行npx repomixlatest --remote repo --output /tmp/name.xml或npx repomixlatest [directory]打包再用grep -iE对输出文件做模式检索如函数/类、认证、API 端点、数据库模型、错误处理等最后基于文件树、指标与检索结果给出结构描述、发现与下一步建议。SKILL.md 还强调了几条最佳实践超过约 10 万行的大型仓库始终使用--compress先 grep 后整读远程仓库输出统一放到/tmp避免污染当前项目目录。值得注意的是repomix-explorer同时以「Claude Code 插件」与「Agent Skills」两种形态提供——后者可脱离 Claude Code通过npx skills add yamadashy/repomix --skill repomix-explorer安装到 Codex、Cursor、OpenClaw 等支持 Agent Skills 的助手详见 website/client/src/zh-cn/guide/repomix-explorer-skill.md。使用示例打包本地代码库使用/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 文件底层pack_remote_repository工具接受user/repo、完整仓库 URL 或带分支的 URL如https://github.com/user/repo/tree/branch三种格式会自动克隆仓库、分析结构并生成报告。其他示例压缩打包 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解释项目结构错误边界在哪里定义从插件到 CLI完整的打包链路插件的所有打包动作最终都汇聚到 Repomix 核心 CLI。以pack_codebase为例其实现通过runCli([.], targetDirectory, cliOptions)调用打包主流程src/mcp/tools/packCodebaseTool.ts随后用formatPackToolResponse将打包结果packResult连同总文件数、总 token 数、目录结构等指标组装为工具响应并生成outputId供后续read_repomix_output/grep_repomix_output引用。这意味着插件并未另起炉灶而是复用了 src/cli/actions/defaultAction.ts 的完整打包管线文件收集、Tree-sitter 解析、token 统计、输出样式生成保证 CLI 与插件行为一致。因此如果你需要更精细的控制如--include、--compress、--output、--remote-branch等全部 CLI 选项可随时退回命令行使用npx repomixlatest插件与 CLI 的选项空间是互通的。相关资源MCP 服务器文档了解底层 MCP 服务器与沙箱模式配置自定义 Repomix 行为安全性了解安全功能如 secretlint 扫描命令行选项可用的 CLI 选项Repomix Explorer Skill面向多 Agent 的独立 skill 形态skills/repomix-explorer/SKILL.md探索器插件的完整代理协议定义遇到问题或对 Claude Code 插件有建议时可在 Repomix 仓库提交 issue 或参与社区讨论。【免费下载链接】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），仅供参考