Windows 系统 Claude Code ECC 插件离线完整安装教程（解决 GitHub 网络超时）

前言

本文解决国内 Windows 环境直连 GitHub、ghproxy 镜像均超时，无法在线拉取 ECC 插件仓库的问题，全程纯离线手动安装，适配Claude Code v2.1.178版本，无代理也能完成部署，可直接复制发布至 CSDN。

一、前置环境校验（必须提前装好）

1. 必备软件清单

Claude Code CLI 版本 ≥ 2.1.0 校验命令（Windows PowerShell）： powershell
复制代码
```
claude --version
```
Git Windows 版（系统环境变量已配置，cmd/powershell 可直接调用 git）
Node.js ≥ 18.x（自带 npm 包管理器，安装时勾选 Add to PATH）

2. 环境校验命令

打开 PowerShell 依次执行，无报错即环境正常

powershell

复制代码

git --version
node -v
npm -v

二、问题背景（踩坑记录）

国内宽带运营商屏蔽 GitHub 443 端口，在线执行以下命令全部超时失败：

plaintext

复制代码

/plugin marketplace add https://github.com/affaan-m/ECC
git clone https://mirror.ghproxy.com/xxx

报错核心：Failed to connect to mirror.ghproxy.com port 443 解决方案：浏览器离线下载源码压缩包，手动放入插件目录注册

三、离线安装完整步骤

步骤 1：浏览器下载 ECC 源码压缩包

复制以下加速链接到 Chrome/Edge 浏览器下载：

plaintext

复制代码

https://mirror.ghproxy.com/https://github.com/affaan-m/ECC/archive/refs/heads/main.zip

备用下载链接（前者打不开时使用）：

plaintext

复制代码

https://gitclone.com/github.com/affaan-m/ECC/archive/main.zip

下载完成得到文件：ECC-main.zip

步骤 2：定位 Claude 插件市场目录

文件资源管理器顶部地址栏直接粘贴路径跳转：

plaintext

复制代码

C:\Users\Lenovo\.claude\plugins\marketplaces

不存在marketplaces文件夹则手动新建该目录

步骤 3：解压并重命名（关键，目录结构不能错）

将ECC-main.zip解压至marketplaces文件夹内
解压生成的ECC-main文件夹重命名为 ECC ✅ 正确目录结构（打开 ECC 文件夹可直接看到 README.zh-CN.md）

plaintext

复制代码

C:\Users\Lenovo\.claude\plugins\marketplaces\ECC\README.zh-CN.md

❌ 错误结构（多层嵌套会识别失败）

plaintext

复制代码

marketplaces\ECC\ECC-main\文件

步骤 4：启动 Claude Code，注册本地插件市场

打开 PowerShell，启动程序 powershell
复制代码
```
claude code
```

在 Claude 交互输入框执行本地注册命令 plaintext

复制代码

/plugin marketplace add C:\Users\Lenovo\.claude\plugins\marketplaces\ECC

注册无报错后执行安装命令 plaintext
复制代码
```
/plugin install ecc@ecc
```

步骤 5：选择安装作用域

弹出 4 个选项，推荐选择第一项，光标默认停在该行直接回车 Enter：

Install for you (user scope)【推荐全局安装】所有项目、任意文件夹打开 Claude Code 均可使用插件
Install for all collaborators on this repository 多人协作仓库专用，单人无需选择
Install for you, in this repo only (local scope) 仅当前文件夹生效，切换项目插件失效
Open homepage / Back to plugin list 无需操作

步骤 6：重载插件使功能生效

安装完成后执行查看插件列表命令，确认状态：

plaintext

复制代码

/plugin list

输出内容示例（代表安装成功、已启用）：

plaintext

复制代码

Installed plugins:
• ecc@ecc (v2.0.0, user) √ enabled -- run /reload-plugins to apply

根据提示执行重载命令加载全部功能：

plaintext

复制代码

/reload-plugins

步骤 7：基础功能验证

重载完成后输入帮助命令，出现大量指令列表即部署完成

plaintext

复制代码

/ecc:help

四、配套规则文件安装（插件无法自动分发，必做）

ECC 的代码规范、约束规则需要手动复制到全局 rules 目录，否则 AI 不会加载项目规范。

Windows PowerShell 一键复制脚本

powershell

复制代码

# 1. 临时克隆仓库仅用于提取规则
git clone https://mirror.ghproxy.com/https://github.com/affaan-m/ECC.git $HOME/temp-ecc-rules
# 2. 创建全局规则目录
New-Item -ItemType Directory -Force -Path "$HOME\.claude\rules" | Out-Null
# 3. 复制通用基础规则（必装）
Copy-Item -Recurse "$HOME/temp-ecc-rules/rules/common" "$HOME\.claude\rules/"
# 4. 按需复制开发语言规则（前端/后端按需取消注释）
# Copy-Item -Recurse "$HOME/temp-ecc-rules/rules/typescript" "$HOME\.claude\rules/"
# Copy-Item -Recurse "$HOME/temp-ecc-rules/rules/python" "$HOME\.claude\rules/"
# Copy-Item -Recurse "$HOME/temp-ecc-rules/rules/golang" "$HOME\.claude\rules/"
# 5. 删除临时仓库文件
Remove-Item -Recurse "$HOME/temp-ecc-rules"

复制完成后再次执行/reload-plugins刷新规则。

五、可选扩展组件安装

1. 多智能体 multi 系列命令依赖

使用/multi-plan、/multi-execute等多任务编排命令前，PowerShell 执行：

powershell

复制代码

npx ccg-workflow

2. 安全审计工具 AgentShield

用于扫描项目密钥、MCP 配置漏洞，终端执行：

powershell

复制代码

# 快速安全扫描
npx ecc-agentshield scan
# 自动修复检测到的风险
npx ecc-agentshield scan --fix

Claude 内快捷调用：

plaintext

复制代码

/ecc:security-scan

六、常用基础配置（按需调整）

1. 设置默认包管理器

Claude 交互框执行（支持 npm/pnpm/yarn）

plaintext

复制代码

/ecc:setup-pm

2. 自定义钩子环境变量（PowerShell）

powershell

复制代码

# 临时禁用指定钩子
$env:ECC_DISABLED_HOOKS="pre:bash:tmux-reminder,post:edit:typecheck"
# 修改钩子严格校验等级 standard/strict/loose
$env:ECC_HOOK_PROFILE="standard"

七、完整安装校验清单（排查故障用）

插件校验：/plugin list 输出ecc@ecc (v2.0.0, user) √ enabled
目录校验：C:\Users\Lenovo\.claude\rules\common 存在规则文件
功能校验：/ecc:help 可正常输出指令列表
multi 命令校验：已执行npx ccg-workflow（需多智能体时）
冲突规避：禁止插件安装与一键 install.ps1 脚本混用，会造成钩子、规则重复加载报错

八、常见报错解决方案

报错 1：Marketplace "ecc" not found

原因：本地文件夹未注册、文件夹命名错误解决：

确认文件夹名为大写ECC，无多层嵌套
重新执行本地注册命令/plugin marketplace add C:\Users\Lenovo\.claude\plugins\marketplaces\ECC
完全关闭所有 Claude 终端，重启后重试安装

报错 2：git clone 连接 ghproxy 超时

原因：网络限制镜像站访问解决：改用浏览器手动下载 zip 离线解压方案，跳过 git 在线克隆

报错 3：/ecc:xxx 命令不存在

原因：未执行/reload-plugins重载插件解决：执行重载命令，重启 Claude Code 后重试

报错 4：规则不生效，AI 不遵循代码规范

原因：未复制 rules 目录到.claude/rules 解决：运行本文第四节规则复制脚本，再次重载插件

九、文末总结

国内 Windows 无代理环境优先使用离线 zip 解压方案，规避 GitHub 网络超时问题；
插件安装完成后必须手动复制 rules 规则目录，否则 ECC 核心规范功能失效；
全局 user 作用域安装是单人开发最优选择，一次安装永久生效；
所有配置修改后均需执行/reload-plugins刷新插件环境。