Windows/macOS/Linux全平台支持:everything-claude-code跨平台配置完整指南
2026/9/17 3:51:10 网站建设 项目流程

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 脚本(sedfindwhich),在 Windows 上直接水土不服。

everything-claude-code 的做法很干脆:把所有 hooks 和脚本用 Node.js 重写。Node.js 在三大平台上的行为一致,因此同一份配置在 🪟 Windows、🍎 macOS、🐧 Linux 上都能正常工作。

关键实现就在跨平台工具库中:

  • 平台检测:通过process.platform判断当前是win32darwin还是linux,见 scripts/lib/utils.js
  • 命令检测:Windows 上自动改用where命令,其他平台用which,见 scripts/lib/utils.js
  • 系统命令替代:内置findFiles()替代findreplaceInFile()替代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

  1. 把 hooks/hooks.json 中的 hooks 配置合并到你的~/.claude/settings.json
  2. 从 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
3package.jsonpackageManager字段
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),仅供参考

需要专业的网站建设服务?

联系我们获取免费的网站建设咨询和方案报价,让我们帮助您实现业务目标

立即咨询