# AI 编程工具安装说明

只保留安装和验证步骤。建议顺序：先装 `Codex` / `Claude Code`，再装 `cc-switch`，最后装 `Superpowers` 和 `UI/UX Pro Max`。

## 1. 基础准备

macOS 先确认基础环境：

```bash
node --version
npm --version
git --version
brew --version
```

缺少 Homebrew：

```bash
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
```

缺少 Node.js：

```bash
brew install node
```

## 2. Codex

官方文档：<https://developers.openai.com/codex/cli>  
安装脚本：<https://chatgpt.com/codex/install.sh>

macOS / Linux：

```bash
curl -fsSL https://chatgpt.com/codex/install.sh | sh
codex
```

首次运行会提示登录，可用 ChatGPT 账号或 API Key。

更新：

```bash
curl -fsSL https://chatgpt.com/codex/install.sh | sh
```

验证：

```bash
codex --version
```

## 3. Claude Code

Claude 下载页：<https://claude.com/download>  
Claude Code 文档：<https://code.claude.com/docs/en/getting-started>

macOS / Linux / WSL 推荐：

```bash
curl -fsSL https://claude.ai/install.sh | bash
claude
```

macOS Homebrew：

```bash
brew install --cask claude-code
claude
```

Windows：

```powershell
winget install Anthropic.ClaudeCode
claude
```

npm 方式：

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

验证：

```bash
claude --version
claude doctor
```

## 4. cc-switch

官方仓库：<https://github.com/farion1231/cc-switch>  
下载页：<https://github.com/farion1231/cc-switch/releases/latest>

macOS 推荐：

```bash
brew install --cask cc-switch
```

更新：

```bash
brew upgrade --cask cc-switch
```

Windows / Linux：从 Releases 下载对应安装包。

安装后配置顺序：

1. 添加供应商。
2. 填入 API Key 或团队代理地址。
3. 选择 Codex / Claude Code 等目标工具。
4. 启用供应商。
5. 重启终端后验证 CLI 是否正常请求。

## 5. Superpowers

官方仓库：<https://github.com/obra/superpowers>

Claude Code：

```bash
/plugin install superpowers@claude-plugins-official
```

或：

```bash
/plugin marketplace add obra/superpowers-marketplace
/plugin install superpowers@superpowers-marketplace
```

Codex App：

```text
Plugins -> Coding -> Superpowers -> +
```

Codex CLI：

```bash
/plugins
```

搜索 `superpowers`，选择 `Install Plugin`。

Cursor：

```text
/add-plugin superpowers
```

## 6. UI/UX Pro Max

官方仓库：<https://github.com/nextlevelbuilder/ui-ux-pro-max-skill>

安装 CLI：

```bash
npm install -g uipro-cli
```

在项目目录安装：

```bash
cd /path/to/project
uipro init --ai codex
uipro init --ai claude
uipro init --ai cursor
```

按需一次性安装到所有支持工具：

```bash
uipro init --ai all
```

更新：

```bash
uipro update
```

卸载：

```bash
uipro uninstall
```

## 7. 最短安装路径

Codex 用户：

```bash
curl -fsSL https://chatgpt.com/codex/install.sh | sh
brew install --cask cc-switch
npm install -g uipro-cli
uipro init --ai codex
```

Claude Code 用户：

```bash
curl -fsSL https://claude.ai/install.sh | bash
brew install --cask cc-switch
/plugin install superpowers@claude-plugins-official
npm install -g uipro-cli
uipro init --ai claude
```

## 8. 最后验证

```bash
codex --version
claude --version
claude doctor
```

再分别打开 Codex / Claude Code，确认：

1. 可以登录。
2. 可以读取当前项目。
3. 可以正常发起模型请求。
4. `cc-switch` 切换供应商后 CLI 生效。
5. `Superpowers` / `UI/UX Pro Max` 能被 Agent 识别或触发。