本文档将指导你完成 Claude Code（核心AI编程助手）、Superpowers（工程化插件）和 OpenSpec（规范先行开发框架）的安装与配置。

📊 工具概览

工具	核心定位	推荐安装方式	安装后关键验证命令
Claude Code	核心AI编程助手	npm install -g @anthropic-ai/claude-code	claude --version
Superpowers	Claude Code的工程化插件	在Claude Code对话中执行：/plugin install superpowers@superpowers-marketplace	执行任意 /superpowers: 开头的命令
OpenSpec	规范先行开发框架	npm install -g openspec-cn/openspec	openspec --version

---

1️⃣ 安装核心助手：Claude Code

Claude Code 是整个工具链的基础，另外两个工具均依赖它运行。

前置要求

• Node.js v18.0 或更高版本 （下载地址 https://nodejs.org/zh-cn/download）
• 检查node的版本安装如下：

  node -v
  npm -v
  

安装步骤

1. 执行安装命令

   npm install -g @anthropic-ai/claude-code
   

2. 安装完成显示

   added 2 packages in 40s
   npm notice
   npm notice New minor version of npm available! 11.12.1 -> 11.13.0
   npm notice Changelog: https://github.com/npm/cli/releases/tag/v11.13.0
   npm notice To update run: npm install -g npm@11.13.0
   npm notice
   

   Windows 用户建议：在 Git Bash 或 WSL 中执行上述命令。

3. 验证安装

   claude --version
   

   正确显示版本号即表示安装成功。

4. 启动与配置

   claude
   

   • 首次启动需要完成账户配置
   • 如果使用非官方 API（如国内大模型或代理），需提前配置环境变量：
     • ANTHROPIC_BASE_URL
     • ANTHROPIC_AUTH_TOKEN

---

2️⃣ 安装工程化插件：Superpowers

Superpowers 为 Claude Code 注入标准化开发流程，强制遵循“先测试、后代码、再审查”的工程规范，可有效减少错误和返工。

安装步骤

1. 启动 Claude Code

   claude
   

2. 在 Claude Code 对话中输入以下命令并回车

   /plugin install superpowers@superpowers-marketplace
   

验证安装

在 Claude Code 对话框中输入 /，查看是否出现 /superpowers: 开头的命令。

测试命令：

/superpowers:brainstorm "为我的项目设计一个用户登录功能"

如果返回关于需求分析的提问，说明安装成功。

---

3️⃣ 安装规范框架：OpenSpec

OpenSpec 提供“规范先行”的开发模式，要求在做任何代码变更前先编写规范文档，适合对代码质量和可维护性有高要求的项目。

前置要求

• Node.js v20.19.0 或更高版本

安装步骤

1. 执行安装命令

   npm install -g openspec-cn/openspec
   

2. 在项目中初始化
   进入你的项目根目录，运行：

   openspec init
   

   根据提示选择你使用的 AI 工具（如 Claude Code），完成集成。

验证安装

• 检查项目根目录下是否生成了 openspec 文件夹
• 在支持的 AI 助手中输入 /opsx:new，应该可以开始创建新的功能规范

---

🔗 三者关系总结

这三者形成了一套完整的 AI 开发工作流：

Claude Code (核心助手)
    ├── Superpowers (工程化技能插件)
    └── OpenSpec (规范先行框架)

层级	工具	作用
底层	Claude Code	AI 编程能力核心
中层	Superpowers	强制工程规范流程
上层	OpenSpec	需求与设计规范管理

建议：三者可以同时使用，互不冲突。以 Claude Code 为基础，根据需要叠加 Superpowers 和 OpenSpec 的能力。

---

⚠️ 常见问题

Q1: npm install -g 提示权限错误？

解决方案（二选一）：

• 使用管理员权限运行终端
• 或修改 npm 全局目录：npm config set prefix ~/.npm-global

Q2: Windows 上 claude 命令无法识别？

解决方案：

• 确保已勾选“Add to PATH”重新安装 Node.js
• 或使用 Git Bash / WSL 运行命令

Q3: Superpowers 安装后看不到 /superpowers: 命令？

解决方案：

• 重启 Claude Code
• 重新执行安装命令

Q4: OpenSpec 初始化失败？

解决方案：

• 检查 Node.js 版本是否 >= v20.19.0：node -v
• 确保在项目根目录下执行 openspec init

---

✅ 安装检查清单

完成所有安装后，请逐项确认：

• claude --version 能正常显示版本号
• 在 Claude Code 中能看到 /superpowers: 相关命令
• openspec --version 能正常显示版本号
• 项目根目录下存在 openspec 文件夹

---

📚 扩展资源

• Claude Code 官方文档
• Superpowers 插件市场
• OpenSpec GitHub 仓库