Repomix Claude Code 插件实战指南用自然语言在 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 为 Anthropic 的 Claude Code 提供了官方插件体系让你无需记忆任何 CLI 参数就能在 AI 驱动的开发环境中用自然语言直接完成代码库打包、远程仓库分析与智能探索。本文将以官方文档为主线结合 Repomix 仓库内 MCP Server 的真实源码mcpServer.ts 与 tools/ 目录下的工具实现以及 repomix-explorer Skill 的定义完整讲解三个插件的安装、能力边界与底层工作原理读完即可在你的 Claude Code 中一键部署这套工作流。插件体系总览三个插件如何分工Repomix 官方 Claude Code 插件共有三个分别承担底层能力、快捷操作和智能分析三个层次与底层 MCP Server 的能力一一对应插件类型核心职责repomix-mcpMCP Server 插件提供打包、搜索、读取输出等基础工具是推荐的基础层repomix-commandsSlash 命令插件提供/repomix-commands:pack-local、/repomix-commands:pack-remote两个快捷命令repomix-explorerAI 分析 Agent 插件通过 Repomix CLI 打包后用 Grep/Read 工具逐步分析大型代码库三者可以独立安装但官方建议将repomix-mcp作为基础搭配另外两个插件以获得最完整的体验——从源码结构看这正是 Repomix MCP Server 面向 AI 助手的核心设计意图先打包成单文件再增量检索从而在有限上下文窗口内理解大型代码库详见 mcpServer.ts 中定义的服务器指令。安装两步完成插件部署1. 添加 Repomix 插件市场在 Claude Code 中执行/plugin marketplace add yamadashy/repomix2. 安装插件# 安装 MCP Server 插件推荐的基础层 /plugin install repomix-mcprepomix # 安装命令插件扩展功能 /plugin install repomix-commandsrepomix # 安装仓库探索插件AI 分析能力 /plugin install repomix-explorerrepomix备选交互式安装在 Claude Code 中输入/plugin即可打开交互式界面浏览并安装可用插件。插件一repomix-mcp —— MCP Server 基础插件这是整个插件体系的底座。它通过 Model Context ProtocolMCP把 Repomix 的打包与分析能力暴露给 AI 助手。从 createMcpServer 的实现可以看到该 Server 注册了以下核心工具pack_codebase打包本地目录实现见 packCodebaseTool.tspack_remote_repository克隆并打包远程 GitHub 仓库实现见 packRemoteRepositoryTool.tsgrep_repomix_output对已打包输出做正则检索实现见 grepRepomixOutputTool.tsread_repomix_output按行区间读取打包输出实现见 readRepomixOutputTool.ts打包工具支持的参数以pack_codebase为例其输入参数直接映射到 Repomix CLI 的核心选项见 packCodebaseInputSchemastyle输出格式取值为xml默认结构化标签、markdown、json、plaincompress启用 Tree-sitter 压缩提取代码签名与结构、移除实现细节可减少约70%的 token 消耗includePatternsfast-glob 包含模式可用逗号分隔多个例如**/*.{js,ts}、src/**,docs/**ignorePatterns额外排除模式例如test/**,*.spec.js、node_modules/**,dist/**与.gitignore及内置排除规则叠加生效topFilesLength指标摘要中展示的体积最大文件数量默认 10增量检索机制为什么能省 token打包完成后AI 并不需要一次性读取整个输出文件。grep_repomix_output支持 JavaScript RegExp 语法并提供contextLines、beforeLines、afterLines、ignoreCase参数见 grepRepomixOutputInputSchema返回带行号、匹配文本和 grep 风格格式化输出的结果read_repomix_output则支持startLine/endLine按 1 起始行号分段读取见 readRepomixOutputInputSchema。这种先打包、后按需检索的模式正是大型仓库分析时控制上下文消耗的关键。安全边界Sandbox 模式MCP Server 还提供--sandbox模式默认情况下工具可读取进程可访问的任何路径而沙箱模式将所有路径限制在单一 workspace 根目录内拒绝绝对路径、~、..及 Windows 驱动器/UNC 路径并且只注册受限的只读工具pack_codebase、read_repomix_output、grep_repomix_output、file_system_read_file、file_system_read_directory同时禁用远程打包、Skill 生成与外部输出挂载见 mcpServer.ts 的注册逻辑。这是应用层纵深防御官方文档亦提醒托管给不可信客户端时仍应叠加容器或独立用户等 OS 级隔离。Claude Code 场景下你也可以用claude mcp add repomix -- npx -y repomix --mcp直接配置基础 MCP Server相关配置方式详见 MCP Server 文档。插件二repomix-commands —— Slash 命令插件提供两个高频操作命令配合自然语言指令即可打包代码库命令作用/repomix-commands:pack-local以多种选项打包本地代码库/repomix-commands:pack-remote打包并分析远程 GitHub 仓库例如/repomix-commands:pack-local Kemas proyek ini dalam format Markdown dengan kompresi更多示例指令只打包src目录、带行号打包 TypeScript 文件、生成 JSON 格式输出远程场景下则支持指定 branch、只包含文档文件、打包特定目录等描述。这些自然语言指令在底层都会被转换为上节所述的pack_codebase/pack_remote_repository工具调用参数。插件三repomix-explorer —— AI 分析 Agent 插件这是能力最强的插件一个仓库分析专家 Agent。它在仓库中以 Skill 形式定义完整行为规范见 SKILL.md核心工作流为打包仓库对远程仓库执行npx repomixlatest --remote repo --output /tmp/repo-analysis.xml强制输出到/tmp以避免污染用户项目目录对本地目录执行npx repomixlatest [directory] [options]高效检索用 Grep 工具对输出做模式搜索函数/类、导入依赖、配置、鉴权、API 端点、数据库模型、错误处理等常见模式均有推荐正则再用 Read 工具带 offset/limit 读取具体片段给出结论汇报文件数、token 数、目录结构、关键发现并引用文件路径与行号该 Skill 同时明确了不应触发的场景编辑重构当前项目代码、已知路径的单点查询、Git 操作、运行测试构建等避免 Agent 被误用于无关任务见 SKILL.md。智能分析策略大型仓库超 10 万行始终建议--compress约可减少 70% token优先用 grep 模式搜索再决定是否读取整段内容避免一次性吞入巨量上下文多仓库分析时使用自定义--output路径防止相互覆盖输出格式上 XML 是默认且推荐的选择文件边界清晰Plain 更易 grepMarkdown 适合人读JSON 适合程序化处理实战示例从打包到智能探索打包本地代码库/repomix-commands:pack-local Kemas proyek ini dalam format Markdown dengan kompresi其他可用指令Kemas hanya direktori src、Kemas file TypeScript dengan nomor baris、Buat output dalam format JSON。打包远程仓库/repomix-commands:pack-remote yamadashy/repomix Kemas hanya file TypeScript dari repositori yamadashy/repomix其他可用指令Kemas branch main dengan kompresi、Sertakan hanya file dokumentasi、Kemas direktori tertentu。AI 探索本地代码库/repomix-explorer:explore-local ./src Temukan semua kode terkait autentikasi其他可用指令Analisis struktur proyek ini、Tunjukkan komponen utama、Temukan semua endpoint API。AI 探索远程仓库/repomix-explorer:explore-remote facebook/react Tunjukkan arsitektur komponen utama其他可用指令Temukan semua React hooks di repositori、Jelaskan struktur proyek、Di mana error boundaries didefinisikan?。插件与 Repomix 生态的对接底层 MCP Server 的完整能力说明、--mcp/--sandbox运行方式及 VS Code、Cline、Cursor、Claude Desktop、Docker 等场景的配置见 MCP Server 文档打包行为默认忽略规则、输出样式、指令文件等的自定义见 配置文档打包过程中的密钥检测、不可信文件过滤等安全机制见 安全文档插件在自然语言之外可用的全部 CLI 选项见 命令行选项文档结语Repomix 的三个 Claude Code 插件以 MCP Server 为底座、以 Slash 命令和 AI Agent 为交互层把代码库打包-检索-分析的完整链路搬进了自然语言对话。无论你是想快速把本地项目喂给大模型还是想在不撑爆上下文的前提下摸清facebook/react这类大型远程仓库的结构这套插件都提供了开箱即用的方案。【免费下载链接】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），仅供参考