郑育江
231 lines
3.5 KiB
Markdown
231 lines
3.5 KiB
Markdown
# 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 识别或触发。
|