前置依赖：Node.js 18+ LTS

所有这三款 CLI 都基于 npm，必须先装 Node。

方案1：Homebrew 安装（最简单）

brew install node
# 验证版本
node -v
npm -v

方案2：nvm 多版本管理（推荐开发）

# 安装nvm
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash

# 根据你的shell执行下面对应一条
# zsh（macOS新版默认）
source ~/.zshrc
# bash
source ~/.bash_profile

# 安装长期支持版Node
nvm install --lts
nvm use lts
# 设置默认
nvm alias default lts

一、安装三款主流AI编程CLI（任选，常用 Claude Code）

打开终端直接执行：

1. Claude Code（搭配 CC-Switch 最适配）

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

校验：

claude --version

2. OpenAI Codex CLI

npm install -g @openai/codex

校验：

codex --version

3. Google Gemini CLI

npm install -g @google/gemini-cli

校验：

gemini --version

二、权限报错解决（mac常见）

出现 EACCES: permission denied 不要用 sudo，改npm全局目录：

mkdir -p ~/.npm-global
npm config set prefix '~/.npm-global'
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.zshrc
source ~/.zshrc

再重新执行安装命令即可。

三、和 CC-Switch 配合使用要点

1. CLI 安装完成后重启 CC-Switch，软件会自动识别 claude/codex/gemini；
2. 在 CC-Switch 内添加 DeepSeek 等服务商并启用；
3. 完全关闭终端再重开，执行 claude status 查看当前模型与接口地址。

四、卸载命令（备用）

# 卸载claude code
npm uninstall -g @anthropic-ai/claude-code
# 卸载codex
npm uninstall -g @openai/codex
# 卸载gemini cli
npm uninstall -g @google/gemini-cli