mars-ai/ai-coding-tools-install-guide.md

AI 编程工具安装说明

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

1. 基础准备

macOS 先确认基础环境：

node --version
npm --version
git --version
brew --version

缺少 Homebrew：

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

缺少 Node.js：

brew install node

2. Codex

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

macOS / Linux：

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

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

更新：

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

验证：

codex --version

3. Claude Code

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

macOS / Linux / WSL 推荐：

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

macOS Homebrew：

brew install --cask claude-code
claude

Windows：

winget install Anthropic.ClaudeCode
claude

npm 方式：

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

验证：

claude --version
claude doctor

4. cc-switch

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

macOS 推荐：

brew install --cask cc-switch

更新：

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：

/plugin install superpowers@claude-plugins-official

或：

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

Codex App：

Plugins -> Coding -> Superpowers -> +

Codex CLI：

/plugins

搜索 superpowers，选择 Install Plugin。

Cursor：

/add-plugin superpowers

6. UI/UX Pro Max

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

安装 CLI：

npm install -g uipro-cli

在项目目录安装：

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

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

uipro init --ai all

更新：

uipro update

卸载：

uipro uninstall

7. 最短安装路径

Codex 用户：

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 用户：

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. 最后验证

codex --version
claude --version
claude doctor

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

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