Windows/macOS/Linux全平台支持:everything-claude-code跨平台配置完整指南
【免费下载链接】everything-claude-codeClaude Code toolkit - agents, commands, skills, rules, and hooks for productive AI-assisted development项目地址: https://gitcode.com/GitHub_Trending/eve/everything-claude-code
everything-claude-code 是一套生产级 Claude Code 配置工具包(agents、commands、skills、rules、hooks 全家桶),现已全面支持 Windows、macOS 和 Linux。本文将手把手带你完成三平台上的安装与配置,并搞懂它「一套配置跑三端」的底层原理——全程只需 Node.js,不需要任何 Bash 环境。
为什么这套工具包能跨平台运行?
⚠️ 很多 Claude Code 插件的 hooks 都依赖 Bash 脚本(sed、find、which),在 Windows 上直接水土不服。
everything-claude-code 的做法很干脆:把所有 hooks 和脚本用 Node.js 重写。Node.js 在三大平台上的行为一致,因此同一份配置在 🪟 Windows、🍎 macOS、🐧 Linux 上都能正常工作。
关键实现就在跨平台工具库中:
- 平台检测:通过
process.platform判断当前是win32、darwin还是linux,见 scripts/lib/utils.js - 命令检测:Windows 上自动改用
where命令,其他平台用which,见 scripts/lib/utils.js - 系统命令替代:内置
findFiles()替代find、replaceInFile()替代sed,无需任何外部依赖
💡 唯一的前置条件:你的系统上安装了Node.js(建议 18+)。
一键安装:插件方式(推荐,三平台通用)
在 Claude Code 中直接执行,Windows 与 macOS/Linux 完全相同:
# 1. 将本仓库添加为插件市场 /plugin marketplace add affaan-m/everything-claude-code # 2. 安装插件 /plugin install everything-claude-code@everything-claude-code或者直接把插件配置写入~/.claude/settings.json(Windows 下该目录位于C:\Users\<你>\.claude),完整配置示例见 README.md。
安装后即可使用全部命令、agents、skills 与 hooks,零额外配置。
手动安装:macOS/Linux 与 Windows 的命令差异
如果你希望精细控制安装哪些组件,可以手动复制。
第 1 步:克隆仓库
git clone https://gitcode.com/GitHub_Trending/eve/everything-claude-code第 2 步:复制组件到 Claude 配置目录
macOS / Linux(Bash):
cp everything-claude-code/agents/*.md ~/.claude/agents/ cp everything-claude-code/rules/*.md ~/.claude/rules/ cp everything-claude-code/commands/*.md ~/.claude/commands/ cp -r everything-claude-code/skills/* ~/.claude/skills/Windows(PowerShell):把cp换成Copy-Item,~换成$HOME:
Copy-Item everything-claude-code\agents\*.md $HOME\.claude\agents\ -Recurse Copy-Item everything-claude-code\rules\*.md $HOME\.claude\rules\ -Recurse Copy-Item everything-claude-code\commands\*.md $HOME\.claude\commands\ -Recurse Copy-Item everything-claude-code\skills\* $HOME\.claude\skills\ -Recurse第 3 步:注册 hooks 与 MCP
- 把 hooks/hooks.json 中的 hooks 配置合并到你的
~/.claude/settings.json - 从 mcp-configs/mcp-servers.json 挑选需要的 MCP 服务器复制到
~/.claude.json,并将YOUR_*_HERE占位符替换为你的真实 API Key
📌避坑提示:不要一次性启用全部 MCP。官方建议每个项目启用不超过 10 个、活跃工具不超过 80 个,否则 200k 上下文窗口可能缩水到 70k。
包管理器自动检测:6 级优先级的聪明设计
跨平台不仅是「能跑」,还包括自动适配你习惯的包管理器(npm / pnpm / yarn / bun)。检测逻辑实现在 scripts/lib/package-manager.js,优先级从高到低:
| 优先级 | 检测来源 | 配置位置 |
|---|---|---|
| 1 | 环境变量 | CLAUDE_PACKAGE_MANAGER |
| 2 | 项目级配置 | .claude/package-manager.json |
| 3 | package.json | packageManager字段 |
| 4 | 锁文件 | package-lock.json/yarn.lock/pnpm-lock.yaml/bun.lockb |
| 5 | 全局配置 | ~/.claude/package-manager.json |
| 6 | 兜底 | 按 pnpm > bun > yarn > npm 取第一个已安装的 |
三种配置方式
方式一:环境变量(三平台语法不同,注意区分)
# macOS / Linux export CLAUDE_PACKAGE_MANAGER=pnpm # Windows (PowerShell) $env:CLAUDE_PACKAGE_MANAGER = "pnpm"方式二:命令行工具设置全局或项目偏好
# 设置全局偏好 node scripts/setup-package-manager.js --global pnpm # 设置当前项目偏好 node scripts/setup-package-manager.js --project bun方式三:在 Claude Code 中直接用/setup-pm命令,用法详解见 commands/setup-pm.md。
验证跨平台配置是否生效:2 分钟自检清单
✅第 1 步:运行内置测试套件(纯 Node.js,三平台一致):
node tests/run-all.js测试覆盖跨平台工具函数与包管理器检测逻辑,入口见 tests/run-all.js,核心用例包括 tests/lib/utils.test.js 和 tests/lib/package-manager.test.js。
✅第 2 步:查看当前检测到的包管理器:
node scripts/setup-package-manager.js --detect输出会显示当前选中的包管理器、检测来源(环境变量 / 锁文件 / 全局配置等)以及各包管理器的安装状态。
✅第 3 步:新开一个 Claude Code 会话,SessionStarthook 会自动加载历史上下文并检测包管理器(见 hooks/hooks.json),SessionEnd时自动持久化会话状态——这就是记忆持久化 hooks 在跨平台环境下正常工作的信号。
跨平台核心文件速查表
| 文件路径 | 作用 |
|---|---|
| scripts/lib/utils.js | 跨平台工具库:路径、文件、系统命令统一封装 |
| scripts/lib/package-manager.js | 包管理器 6 级检测与选择逻辑 |
| scripts/setup-package-manager.js | 交互式包管理器配置脚本 |
| scripts/hooks/session-start.js | 会话开始时加载上下文(替代原 shell 脚本) |
| scripts/hooks/session-end.js | 会话结束时持久化状态 |
| hooks/hooks.json | 全部 hooks 配置(PreToolUse/SessionStart/SessionEnd 等) |
| tests/run-all.js | 一键运行全量测试 |
常见问题 FAQ
Q1:Windows 上还需要 Git Bash / WSL 吗?不需要。所有 hook 脚本均为 Node.js 实现(scripts/hooks/目录),只要有 Node.js 即可运行。
Q2:三台电脑(Win + Mac + Linux)如何保持配置一致?推荐插件方式安装,或把同一份~/.claude/配置目录纳入 dotfiles 仓库管理;全局包管理器偏好写入~/.claude/package-manager.json即可三端生效。
Q3:锁文件检测的优先级是?pnpm > bun > yarn > npm,详见 scripts/lib/package-manager.js。
Q4:hook 不触发怎么排查?先确认~/.claude/settings.json中已合并 hooks 配置,再运行node tests/run-all.js验证脚本本身可执行。
总结:everything-claude-code 用「Node.js 重写 + 6 级包管理器检测」解决了 Claude Code 生态最大的跨平台痛点。无论你是 🪟 Windows、🍎 macOS 还是 🐧 Linux,10 分钟内即可拥有一套完整、行为一致的 AI 辅助开发工作流。
【免费下载链接】everything-claude-codeClaude Code toolkit - agents, commands, skills, rules, and hooks for productive AI-assisted development项目地址: https://gitcode.com/GitHub_Trending/eve/everything-claude-code
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考