企业官网建设流程全解析

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-mcp作为推荐的基础底座，repomix-commands提供便捷斜杠命令，repomix-explorer增加 AI 驱动的分析能力，三个全部使用可获得最完整的体验。

一、安装步骤

1. 添加 Repomix 插件市场

首先在 Claude Code 中添加 Repomix 插件市场：

/plugin marketplace add yamadashy/repomix

2. 安装插件

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

3. 交互式安装（替代方案）

也可以直接使用交互式插件安装器：

/plugin

该命令会打开一个交互式界面，可以浏览并安装可用的插件。

二、三个插件的功能详解

1. repomix-mcp（MCP Server 插件）

作为基础插件，它通过 MCP 服务器集成提供 AI 驱动的代码库分析能力。核心功能包括：

• 打包本地与远程仓库
• 在打包输出中搜索（grep）
• 读取生成的输出文件
• 自动 Tree-sitter 压缩（可将 token 数减少约 70%）

2. repomix-commands（斜杠命令插件）

提供带自然语言支持的便捷斜杠命令：

• /repomix-commands:pack-local—— 以各种选项打包本地代码库
• /repomix-commands:pack-remote—— 打包并分析远程 GitHub 仓库

3. repomix-explorer（AI 分析 Agent 插件）

使用 Repomix CLI 智能探索代码库的 AI 驱动仓库分析代理，功能包括：

• 自然语言代码库探索与分析
• 智能模式发现与代码结构理解
• 使用 grep 与针对性文件读取进行增量分析
• 大型仓库的自动上下文管理

可用命令：

• /repomix-explorer:explore-local—— 在 AI 辅助下分析本地代码库
• /repomix-explorer:explore-remote—— 在 AI 辅助下分析远程 GitHub 仓库

工作方式：

1. 执行npx repomix@latest打包仓库
2. 使用 Grep 和 Read 工具高效检索输出
3. 在不消耗过多上下文的前提下提供全面分析

三、源码视角：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 中定义，与斜杠命令支持的自然语言选项一一对应：

远程打包则由pack_remote_repository工具承担（见 src/mcp/tools/packRemoteRepositoryTool.ts），remote参数支持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 → 增量读取"的运行方式一致，可直接作为使用参考：

1. 打包阶段：远程仓库固定输出到/tmp避免污染当前项目，本地仓库使用npx repomix@latest [目录] [选项]；默认推荐--style xml，超 10 万行的仓库启用--compress。
2. 检索阶段：优先用 grep 定位模式，而不是整体读取文件。常见检索模式包括函数/类（export.*function|export.*class）、导入依赖（import.*from|require\(）、API 端点（router|route|endpoint|api）等。
3. 读取阶段：对命中的区块用带 offset/limit 的方式分段读取，避免一次性加载大文件。
4. 收尾：记录输出文件位置，超大文件分析后及时清理。

此外，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