大家好，我是讯享网，很高兴认识大家。这里提供最前沿的Ai技术和互联网信息。



Codex CLI 是 OpenAI 推出的 AI 编程助手，可在终端中直接与 AI 对话，辅助代码编写、调试和解释。Superpowers 则是为 Codex 提供增强功能的技能集合，通过添加专业技能模块提升 Codex 的能力范围。

本文将详细介绍在 Windows 环境下为 Codex CLI 安装 Superpowers 的完整流程，按推荐度排序，确保步骤清晰专业。

安装 Node.js
推荐度：★★★★★

• 下载：访问 Node.js 官网 下载 LTS 版本（推荐 v18+ 或 v20+）
• 安装：运行安装程序，务必勾选 “Add to PATH” 选项（自动配置环境变量）
• 验证：

  node -v # 验证 Node.js 安装 npm -v # 验证 npm 包管理器 

推荐度：★★★★★
特点：官方推荐，稳定可靠，适合所有用户

步骤 1：安装 Codex CLI

npm install -g @openai/codex --registry=https://registry.npmmirror.com 

• 命令解析：
  • npm install -g：全局安装包，确保 codex 命令在任何位置可用
  • @openai/codex：OpenAI 官方 Codex CLI 包
  • --registry：使用国内镜像源，加速下载

codex --version # 验证安装成功 

步骤 2：安装 Superpowers

为什么需要创建技能目录并建立关联？
这是由 Codex CLI 的技能发现机制决定的：

• Codex 启动时会自动扫描 ~/.agents/skills/ 目录（Windows 下为 %USERPROFILE%.agentsskills）
• Superpowers 的技能文件存储在其仓库的 skills 目录中
• 使用 junction（目录链接）可以保持技能与原始仓库的关联，便于后续更新

1. 克隆 Superpowers 仓库：

   git clone https://github.com/obra/superpowers.git "$env:USERPROFILE.codexsuperpowers" 

   • 命令解析：
     • git clone：从 GitHub 克隆仓库到本地
     • https://github.com/obra/superpowers.git：Superpowers 项目官方地址
     • "$env:USERPROFILE.codexsuperpowers"：克隆目标路径
     • $env:USERPROFILE：PowerShell 环境变量，指向用户主目录
2. 创建技能目录并建立 junction：

   New-Item -ItemType Directory -Force -Path "$env:USERPROFILE.agentsskills" 

   • 命令解析：
     • New-Item：创建新目录
     • -ItemType Directory：指定创建类型为目录
     • -Force：强制创建，若目录已存在则不报错
     • -Path：指定目录路径

   cmd /c mklink /J "$env:USERPROFILE.agentsskillssuperpowers" "$env:USERPROFILE.codexsuperpowersskills" 

   • 命令解析：
     • cmd /c：在 PowerShell 中执行 cmd 命令
     • mklink /J：创建目录 junction（Windows 目录链接，类似符号链接）
     • 第一个路径：链接目标位置（Codex 技能扫描目录）
     • 第二个路径：源目录（Superpowers 技能目录）
3. 重启 Codex CLI：关闭并重新启动 Codex，使其发现新技能

推荐度：★★★★☆
特点：操作简单，适合新手用户

1. 启动 Codex CLI：

   codex 

2. 输入安装指令：

   Fetch and follow instructions from https://raw.githubusercontent.com/obra/superpowers/refs/heads/main/.codex/INSTALL.md 

   • 功能说明：让 Codex 自动获取并执行官方安装脚本

推荐度：★★★☆☆
特点：适合网络环境较差的用户

1. 安装 Node.js（步骤同前）
2. 使用 88code 镜像安装 Codex：

   npm i -g @88code/codex --registry=https://registry.npmmirror.com 

   • 命令解析：
     • npm i -g：全局安装
     • @88code/codex：88code 定制版 Codex
     • --registry：使用国内镜像源
3. 按照方法一的步骤安装 Superpowers

• Windows：%USERPROFILE%.codex
• Linux/macOS：~/.codex/

在 config.toml 文件中添加以下配置以启用多代理功能：

[features] multi_agent = true 

• 功能说明：启用 Codex 的多代理功能，支持 Superpowers 中的子代理技能

ls "$env:USERPROFILE.agentsskills" 

• 功能说明：列出技能目录内容，确认 superpowers 链接已正确创建
• 预期结果：应显示 superpowers 目录链接

重启 Codex：
关闭并重新启动 Codex CLI，使其发现新技能。

官方验证方法：

1. 检查 junction 创建状态：

   ls "$env:USERPROFILE.agentsskillssuperpowers" 

   • 功能说明：检查 Superpowers 技能链接是否正确创建
   • 预期结果：应显示 junction 链接指向 $env:USERPROFILE.codexsuperpowersskills
2. 在 Codex CLI 中验证：
   启动 Codex 并输入以下任一命令：
   

   Help me plan this feature 

   或

   Let's debug this issue 

   • 功能说明：测试 Superpowers 技能是否自动触发
   • 预期结果：Codex 应启动相应技能，开始提问澄清需求或系统性排查
   
   
   
3. 直接询问技能：

   do you have brainstorming? 

   • 功能说明：直接询问 Codex 是否具备 Superpowers 技能
   • 预期结果：Codex 应确认拥有 brainstorming 等 Superpowers 技能
4. 测试具体技能：

   use brainstorming to generate ideas for a new project 

   • 功能说明：直接使用 Superpowers 的头脑风暴技能
   • 预期结果：Codex 应启动头脑风暴技能，开始询问项目相关问题

cd "$env:USERPROFILE.codexsuperpowers" && git pull 

• 命令解析：
  • cd：切换到 Superpowers 目录
  • git pull：从 GitHub 拉取最新代码
• 优势：由于使用了 junction 链接，更新后技能会自动同步

Remove-Item "$env:USERPROFILE.agentsskillssuperpowers" # 可选：删除克隆的仓库 Remove-Item -Recurse -Force "$env:USERPROFILE.codexsuperpowers" 

• 症状：安装时提示 “权限不足” 或 “access denied”
• 解决方案：以管理员身份运行 PowerShell

• 症状：运行 codex 时提示 “不是内部或外部命令”
• 解决方案：
  1. 检查 npm 全局安装路径：npm config get prefix
  2. 确保该路径已添加到系统 PATH 环境变量
  3. 重新安装 Node.js 并确保勾选 “Add to PATH”

• 症状：Codex 无法发现 Superpowers 技能
• 解决方案：
  1. 检查 junction 是否正确创建
  2. 重启 Codex CLI
  3. 确认 ~/.agents/skills/superpowers 目录存在

Superpowers 是一个模块化技能系统，为 Codex CLI 提供扩展功能，包括：

• 头脑风暴（brainstorming）
• 代码审查（code-review）
• 测试生成（test-generation）
• 子代理驱动开发（subagent-driven-development）

Codex 启动时会扫描 ~/.agents/skills/ 目录，自动发现并加载技能。每个技能通过 SKILL.md 文件定义，包含：

• 技能名称和描述
• 触发条件
• 使用方法和示例

在 Windows 环境下，使用 mklink /J 创建目录 junction（目录链接），实现类似 Linux 符号链接的功能，使 Codex 能够通过标准路径访问 Superpowers 技能文件。

此安装方法来自 Superpowers 项目的官方文档（.codex/INSTALL.md），由项目维护者 obra 制定，是官方推荐的标准安装方式。

Superpowers 提供了丰富的技能，帮助开发者遵循**实践：

1. 自动触发（推荐）

Superpowers 设计为自动触发模式，AI 会根据上下文自动调用合适的技能：

2. 手动触发

你也可以通过 use 命令手动触发特定技能：

use brainstorming to generate ideas for a new project 

use test-driven-development to implement a user authentication system 

3. 技能工作流程

Superpowers 技能通常遵循以下工作流程：

1. 澄清需求：技能会询问关键问题，确保理解需求
2. 生成方案：基于需求生成详细的设计或计划
3. 执行实施：按照方案执行，如编写测试、实现代码
4. 质量检查：进行代码审查、测试验证
5. 完成交付：总结工作成果，提供最终方案

示例 1：开发新功能

我想给电商网站添加购物车功能 

• 预期流程：
  1. brainstorming 技能自动触发，询问功能细节
  2. 生成设计方案后，writing-plans 技能生成实施计划
  3. test-driven-development 技能按 TDD 方式实现
  4. requesting-code-review 技能进行代码审查

示例 2：修复 bug

用户登录后无法访问个人中心，总是跳转到首页 

• 预期流程：
  1. systematic-debugging 技能自动触发
  2. 分析问题根因，提出解决方案
  3. test-driven-development 技能修复并验证

1. 主动沟通：与技能保持互动，及时回答问题
2. 明确需求：尽可能详细描述需求，减少误解
3. 遵循流程：信任技能的工作流程，不要跳过步骤
4. 定期更新：定期更新 Superpowers 以获得最新功能
5. 反馈问题：遇到问题时，通过 GitHub 提交 issue

• 新手用户：通过方法二（Codex 自动安装）快速上手
• 专业用户：使用方法一（官方 GitHub 安装）获得完整控制
• 网络受限用户：使用方法三（第三方镜像）解决网络问题

1. 技能发现：确保 junction 链接正确创建，Codex 才能发现技能
2. 重启必要：安装后需要重启 Codex 才能加载技能
3. 自然语言：使用自然语言描述需求，Superpowers 会自动识别并调用合适技能
4. 循序渐进：技能会分步骤执行，耐心跟随工作流程
5. 质量保证：Superpowers 会强制遵循**实践，确保代码质量

通过本文介绍的方法，你可以在 Windows 环境下成功为 Codex CLI 安装 Superpowers，获得更强大的 AI 编程助手能力。官方 GitHub 安装法是最推荐的方式，提供最稳定可靠的体验。

Superpowers 扩展了 Codex 的能力边界，使其不仅是代码生成工具，更是一个完整的开发助手生态系统。合理使用这些技能，将显著提升你的编程效率和代码质量。

• Superpowers GitHub 仓库
• Codex CLI 官方文档
• Node.js 官网

---

更新时间：2026 年 4 月 14 日

注意：本文基于最新官方文档编写，确保方法的有效性和可靠性。若后续版本更新，可能需要相应调整安装步骤。