Windows/macOS/Linux全平台支持：everything-claude-code跨平台配置完整指南
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-codeeverything-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-codeeverything-claude-code或者直接把插件配置写入~/.claude/settings.jsonWindows 下该目录位于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 / LinuxBashcp 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/WindowsPowerShell把cp换成Copy-Item~换成$HOMECopy-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_MANAGER2项目级配置.claude/package-manager.json3package.jsonpackageManager字段4锁文件package-lock.json/yarn.lock/pnpm-lock.yaml/bun.lockb5全局配置~/.claude/package-manager.json6兜底按 pnpm bun yarn npm 取第一个已安装的三种配置方式方式一环境变量三平台语法不同注意区分# macOS / Linux export CLAUDE_PACKAGE_MANAGERpnpm # 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.jsonSessionEnd时自动持久化会话状态——这就是记忆持久化 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一键运行全量测试常见问题 FAQQ1Windows 上还需要 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。Q4hook 不触发怎么排查先确认~/.claude/settings.json中已合并 hooks 配置再运行node tests/run-all.js验证脚本本身可执行。总结everything-claude-code 用「Node.js 重写 6 级包管理器检测」解决了 Claude Code 生态最大的跨平台痛点。无论你是 Windows、 macOS 还是 Linux10 分钟内即可拥有一套完整、行为一致的 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），仅供参考