ARTICLE · INTELLIGENCE

战地情报 · 详情页

来自尧图项目组的一线实战观察与深度解析

Repomix Claude Code 插件实战指南:MCP 服务器、斜杠命令与 AI 驱动的仓库探索

Repomix Claude Code 插件实战指南:MCP 服务器、斜杠命令与 AI 驱动的仓库探索 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与 MCP 服务器源码完整讲解三个官方插件的安装、功能、使用示例与底层实现原理。读完本文你将掌握如何在 Claude Code 中一键打包本地/远程仓库、用斜杠命令压缩输出并通过 AI 探索器对陌生代码库进行结构化分析。插件体系概览Repomix 的 Claude Code 插件共三个分工明确、可组合使用插件类型核心能力repomix-mcpMCP 服务器插件提供 AI 驱动的代码库分析基础能力是推荐的基础底座repomix-commands斜杠命令插件提供便捷的/repomix-commands:*斜杠命令支持自然语言参数repomix-explorerAI 分析代理插件智能探索代码库结构自动管理上下文适合大型仓库三者可以独立安装但官方建议全部启用以获得最完整的使用体验repomix-mcp作为地基提供打包与检索能力repomix-commands把常用操作封装成快捷命令repomix-explorer在二者之上叠加 AI 分析智能。安装步骤1. 添加 Repomix 插件市场在 Claude Code 中执行/plugin marketplace add yamadashy/repomix2. 安装插件按需执行以下命令可一次全部安装# 安装 MCP 服务器插件推荐的基础 /plugin install repomix-mcprepomix # 安装命令插件扩展功能 /plugin install repomix-commandsrepomix # 安装仓库探索插件AI 驱动分析 /plugin install repomix-explorerrepomix3. 交互式安装备选也可以直接输入/plugin打开交互式安装界面浏览并选择可用插件/plugin该命令会打开一个可浏览、可搜索的插件选择界面无需记忆插件名。插件详解1. repomix-mcpMCP 服务器插件这是整个插件体系的基础通过 MCPModel Context Protocol服务器集成向 Claude 暴露代码库分析工具。其功能包括打包本地与远程仓库在打包输出中执行搜索读取生成的输出文件自动 Tree-sitter 压缩约可减少 70% 的 token 消耗从源码看MCP 服务器在 src/mcp/mcpServer.ts 中创建核心工具注册逻辑位于第 65–84 行pack_codebase、read_repomix_output、grep_repomix_output始终可用非沙箱模式下还会注册pack_remote_repository、generate_skill、attach_packed_output等工具。服务器通过StdioServerTransport与 Claude Code 通信并监听SIGINT/SIGTERM优雅退出。pack_codebase打包本地代码库该工具在 src/mcp/tools/packCodebaseTool.ts 中定义输入参数第 41–75 行包括directory要打包的目录compress布尔值默认false启用 Tree-sitter 压缩以提取代码签名与结构、移除实现细节可减少约 70% tokenincludePatternsfast-glob 包含模式可逗号分隔多个如**/*.{js,ts}、src/**,docs/**ignorePatterns附加排除模式与.gitignore和内置排除互补style输出格式枚举xml默认/markdown/json/plaintopFilesLength指标汇总中展示的最大文件数量默认 10工具底层调用runCli执行 Repomix CLI输出写入临时工作区并返回outputId、totalFiles、totalTokens等结构化指标。grep_repomix_output在打包输出中搜索定义于 src/mcp/tools/grepRepomixOutputTool.ts输入第 17–35 行包括outputId目标输出文件 IDpatternJavaScript RegExp 正则模式contextLines匹配行前后上下文行数默认 0beforeLines/afterLines分别控制匹配前/后的上下文行数优先级高于contextLinesignoreCase是否忽略大小写默认false返回matches行号、行内容、匹配文本、formattedOutputgrep 风格输出与totalMatches。其实现按行拆分内容后统一执行正则匹配与上下文格式化避免对 3–5MB 的大文件重复拆分。read_repomix_output读取输出文件定义于 src/mcp/tools/readRepomixOutputTool.ts支持startLine/endLine行区间读取1 起始、含端点便于对大文件分段消费也支持校验非法行号并返回totalLines、linesRead等元信息。pack_remote_repository打包远程仓库定义于 src/mcp/tools/packRemoteRepositoryTool.tsremote参数支持三种形式owner/repo、https://github.com/user/repo、https://github.com/user/repo/tree/branch。工具自动克隆远程仓库、执行打包并在返回前用redactUrl对回显的仓库地址做脱敏处理第 125–130 行避免带凭据的 URL 残留在会话记录中。2. repomix-commands斜杠命令插件提供两个便捷斜杠命令支持自然语言描述参数/repomix-commands:pack-local打包本地代码库可携带多种选项/repomix-commands:pack-remote打包并分析远程 GitHub 仓库3. repomix-explorerAI 分析代理插件这是一个由 AI 驱动的仓库分析代理基于 Repomix CLI 智能探索代码库提供自然语言的代码库探索与分析智能模式发现与代码结构理解基于 grep 和定向文件读取的增量分析针对大型仓库的自动上下文管理其工作流程为执行npx repomixlatest打包仓库使用 Grep 与 Read 工具高效检索打包输出在不消耗过多上下文的前提下给出完整分析提供两个命令/repomix-explorer:explore-local在 AI 辅助下分析本地代码库/repomix-explorer:explore-remote在 AI 辅助下分析远程 GitHub 仓库仓库中自带的 Skill 定义 skills/repomix-explorer/SKILL.md 详细描述了该代理的完整运行准则包括意图识别示例、命令决策、工作流与最佳实践。例如它规定远程仓库统一输出到/tmp避免污染当前项目目录超过 10 万行的仓库必须启用--compress分析顺序遵循先 grep 后读文件的增量策略推荐默认使用 XML 格式输出。使用示例打包本地代码库使用/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解释项目结构error boundary 在哪里定义相关资源MCP 服务器文档了解底层 MCP 服务器的更多细节配置指南自定义 Repomix 行为安全指南了解安全特性命令行选项可用的 CLI 选项安全政策 与 贡献指南参与社区共建插件所依赖的核心 CLI 能力分布在仓库的 src/core文件收集、输出生成、Tree-sitter 解析与 src/cli命令解析与执行中MCP 层的全部工具注册代码位于 src/mcp/tools读者可沿这些路径深入源码继续研究。【免费下载链接】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),仅供参考
RELATED READING

延伸阅读

更多一线实战笔记与深度复盘,助您持续精进