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/repomix

Repomix 为 Claude Code）与 MCP 服务器源码，完整讲解三个官方插件的安装、功能、使用示例与底层实现原理。读完本文，你将掌握如何在 Claude Code 中一键打包本地/远程仓库、用斜杠命令压缩输出，并通过 AI 探索器对陌生代码库进行结构化分析。

插件体系概览

Repomix 的 Claude Code 插件共三个，分工明确、可组合使用：

插件	类型	核心能力
`repomix-mcp`	MCP 服务器插件	提供 AI 驱动的代码库分析基础能力，是推荐的基础底座
`repomix-commands`	斜杠命令插件	提供便捷的`/repomix-commands:*`斜杠命令，支持自然语言参数
`repomix-explorer`	AI 分析代理插件	智能探索代码库结构，自动管理上下文，适合大型仓库

三者可以独立安装，但官方建议全部启用以获得最完整的使用体验：repomix-mcp作为地基提供打包与检索能力，repomix-commands把常用操作封装成快捷命令，repomix-explorer在二者之上叠加 AI 分析智能。

安装步骤

1. 添加 Repomix 插件市场

在 Claude Code 中执行：

/plugin marketplace add yamadashy/repomix

2. 安装插件

按需执行以下命令（可一次全部安装）：

# 安装 MCP 服务器插件（推荐的基础） /plugin install repomix-mcp@repomix # 安装命令插件（扩展功能） /plugin install repomix-commands@repomix # 安装仓库探索插件（AI 驱动分析） /plugin install repomix-explorer@repomix

3. 交互式安装（备选）

也可以直接输入/plugin打开交互式安装界面，浏览并选择可用插件：

/plugin

该命令会打开一个可浏览、可搜索的插件选择界面，无需记忆插件名。

插件详解

1. repomix-mcp：MCP 服务器插件

这是整个插件体系的基础，通过 MCP（Model 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% token
includePatterns：fast-glob 包含模式，可逗号分隔多个（如"**/*.{js,ts}"、"src/**,docs/**"）
ignorePatterns：附加排除模式，与.gitignore和内置排除互补
style：输出格式，枚举xml（默认）/markdown/json/plain
topFilesLength：指标汇总中展示的最大文件数量，默认 10

工具底层调用runCli执行 Repomix CLI，输出写入临时工作区，并返回outputId、totalFiles、totalTokens等结构化指标。

grep_repomix_output：在打包输出中搜索

定义于 src/mcp/tools/grepRepomixOutputTool.ts，输入（第 17–35 行）包括：

outputId：目标输出文件 ID
pattern：JavaScript RegExp 正则模式
contextLines：匹配行前后上下文行数，默认 0
beforeLines/afterLines：分别控制匹配前/后的上下文行数，优先级高于contextLines
ignoreCase：是否忽略大小写，默认false

返回matches（行号、行内容、匹配文本）、formattedOutput（grep 风格输出）与totalMatches。其实现按行拆分内容后统一执行正则匹配与上下文格式化，避免对 3–5MB 的大文件重复拆分。

read_repomix_output：读取输出文件

定义于 src/mcp/tools/readRepomixOutputTool.ts，支持startLine/endLine行区间读取（1 起始、含端点），便于对大文件分段消费；也支持校验非法行号并返回totalLines、linesRead等元信息。

pack_remote_repository：打包远程仓库

定义于 src/mcp/tools/packRemoteRepositoryTool.ts，remote参数支持三种形式：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-explorer：AI 分析代理插件

这是一个由 AI 驱动的仓库分析代理，基于 Repomix CLI 智能探索代码库，提供：

自然语言的代码库探索与分析
智能模式发现与代码结构理解
基于 grep 和定向文件读取的增量分析
针对大型仓库的自动上下文管理

其工作流程为：

执行npx repomix@latest打包仓库
使用 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 在哪里定义？"

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