Files
mars-ai/ai-coding-tools-install-guide.md
2026-06-06 15:26:34 +08:00

3.5 KiB
Raw Permalink Blame History

AI 编程工具安装说明

只保留安装和验证步骤。建议顺序:先装 Codex / Claude Code,再装 cc-switch,最后装 SuperpowersUI/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 识别或触发。