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/repomix导读本文围绕 Repomix 仓库提供的官方 Claude Code 插件repomix-mcp、repomix-commands、repomix-explorer展开介绍如何在 Claude Code 中通过自然语言命令直接完成本地/远程代码库的分析与打包。读完本文你将掌握插件市场与三个插件的完整安装流程、每个插件的功能定位与可用命令以及配合源码理解其背后由 MCP Server 提供的能力边界与推荐实践。插件体系概览三个插件如何协同Repomix 为 Claude Code 提供了三个官方插件各司其职又互相配合插件类型定位repomix-mcpMCP Server 插件基础底座通过 MCP 协议提供 AI 驱动的代码库分析能力repomix-commands斜杠命令插件提供便捷的/repomix-commands:pack-local、/repomix-commands:pack-remote命令repomix-explorerAI 分析 Agent 插件使用 Repomix CLI 智能探索代码库的 AI 分析代理三者可以独立安装但文档明确建议repomix-mcp作为推荐的基础底座repomix-commands提供便捷斜杠命令repomix-explorer增加 AI 驱动的分析能力三个全部使用可获得最完整的体验。一、安装步骤1. 添加 Repomix 插件市场首先在 Claude Code 中添加 Repomix 插件市场/plugin marketplace add yamadashy/repomix2. 安装插件# 安装 MCP Server 插件推荐的基础底座 /plugin install repomix-mcprepomix # 安装命令插件功能扩展 /plugin install repomix-commandsrepomix # 安装仓库探索器插件AI 驱动分析 /plugin install repomix-explorerrepomix3. 交互式安装替代方案也可以直接使用交互式插件安装器/plugin该命令会打开一个交互式界面可以浏览并安装可用的插件。二、三个插件的功能详解1. repomix-mcpMCP Server 插件作为基础插件它通过 MCP 服务器集成提供 AI 驱动的代码库分析能力。核心功能包括打包本地与远程仓库在打包输出中搜索grep读取生成的输出文件自动 Tree-sitter 压缩可将 token 数减少约 70%2. repomix-commands斜杠命令插件提供带自然语言支持的便捷斜杠命令/repomix-commands:pack-local—— 以各种选项打包本地代码库/repomix-commands:pack-remote—— 打包并分析远程 GitHub 仓库3. repomix-explorerAI 分析 Agent 插件使用 Repomix CLI 智能探索代码库的 AI 驱动仓库分析代理功能包括自然语言代码库探索与分析智能模式发现与代码结构理解使用 grep 与针对性文件读取进行增量分析大型仓库的自动上下文管理可用命令/repomix-explorer:explore-local—— 在 AI 辅助下分析本地代码库/repomix-explorer:explore-remote—— 在 AI 辅助下分析远程 GitHub 仓库工作方式执行npx repomixlatest打包仓库使用 Grep 和 Read 工具高效检索输出在不消耗过多上下文的前提下提供全面分析三、源码视角MCP Server 为插件提供的能力插件的核心能力来自 Repomix 自身的 MCP Server 实现。在 src/mcp/mcpServer.ts 中服务器通过createMcpServer注册了一系列工具始终可用的只读工具pack_codebase、read_repomix_output、grep_repomix_output非沙箱模式下额外注册pack_remote_repository、generate_skill、attach_packed_output沙箱模式下额外注册file_system_read_file、file_system_read_directory以pack_codebase工具为例其输入参数在 src/mcp/tools/packCodebaseTool.ts 中定义与斜杠命令支持的自然语言选项一一对应参数默认值说明directory—要打包的目录非沙箱模式下为绝对路径compressfalse启用 Tree-sitter 压缩仅提取代码签名与结构token 减少约 70%includePatterns—fast-glob 包含模式逗号分隔如**/*.{js,ts}ignorePatterns—额外的排除模式补充.gitignore与内置排除规则stylexml输出格式xml、markdown、json、plaintopFilesLength10指标摘要中显示的最大文件数量远程打包则由pack_remote_repository工具承担见 src/mcp/tools/packRemoteRepositoryTool.tsremote参数支持user/repo、https://github.com/user/repo以及带分支的 URL 三种格式。read_repomix_output与grep_repomix_output两个工具分别见 readRepomixOutputTool.ts 和 grepRepomixOutputTool.ts配合实现了打包后增量分析的关键机制前者支持按行区间读取大型输出文件后者支持 JavaScript RegExp 语法并可通过contextLines、beforeLines、afterLines控制上下文行数。这正是 repomix-explorer 插件使用 Grep 和 Read 工具高效检索输出、不消耗过多上下文的底层实现。命令行层面--mcp与--sandbox选项在 src/cli/cliRun.ts 中定义repomix --mcp以 MCP 服务器模式运行--sandbox [dir]则将文件工具限定在指定工作区目录内见 mcpAction.ts此时远程打包、技能生成、附加外部输出等能力会被禁用适合面向不受信任的客户端场景。四、使用示例打包本地代码库配合自然语言指令使用/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解释项目结构错误边界在哪里定义五、探索器插件的最佳实践仓库中 skills/repomix-explorer/SKILL.md 给出了 repomix-explorer 的完整运行规范其核心工作流与插件打包 → grep → 增量读取的运行方式一致可直接作为使用参考打包阶段远程仓库固定输出到/tmp避免污染当前项目本地仓库使用npx repomixlatest [目录] [选项]默认推荐--style xml超 10 万行的仓库启用--compress。检索阶段优先用 grep 定位模式而不是整体读取文件。常见检索模式包括函数/类export.*function|export.*class、导入依赖import.*from|require\(、API 端点router|route|endpoint|api等。读取阶段对命中的区块用带 offset/limit 的方式分段读取避免一次性加载大文件。收尾记录输出文件位置超大文件分析后及时清理。此外SKILL.md 还强调 Repomix 会自动执行安全检查、排除敏感文件这一行为对应源码中securityCheck默认开启的配置见 packCodebaseTool.ts。六、延伸阅读以下仓库内文档可帮助进一步理解插件的底层能力MCP Server 文档 —— 学习插件依赖的 MCP 服务器本身包括--sandbox沙箱模式与各类 IDE 的配置方式配置 —— 自定义 Repomix 行为安全 —— 了解安全特性命令行选项 —— 可用的 CLI 选项Repomix 探索器技能 —— 探索器插件的技能文档如果你希望绕过插件、直接在 Claude Code 中手动接入 MCP Server可参考 mcp-server.md 中的命令claude mcp add repomix -- npx -y repomix --mcp七、问题反馈如果遇到 Claude Code 插件相关问题或有改进建议可以在当前仓库的 Issues 区域提交问题、查看现有讨论或通过仓库根目录的 CONTRIBUTING.md 了解贡献方式。插件实现细节可参考仓库内对应源码MCP 服务器入口、MCP 工具目录 以及 探索器技能定义。【免费下载链接】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），仅供参考