官方之前的安装方法：原生安装、 npm 安装。今天使用npm方式安装哦！！！

原生安装 vs npm 安装对比

特性	原生安装	npm 安装
需要 Node.js	❌ 不需要	✅ 需要
安装速度	⚡ 快（单二进制文件）	🐢 慢（下载依赖）
官方支持	✅ 官方推荐	❌ 已废弃
自动更新	✅ 内置检查	❌ 手动更新
系统兼容性	✅ 更好	⚠️ 可能遇到平台错误
PATH 配置	macOS/Linux 自动，Win 手动	需手动配置 npm 全局路径

一、npm 安装 Claude Code

1.1 前提条件

确保已安装 Node.js（建议 v18+）：

node --version  # v18.0.0 或更高
npm --version   # v8.0.0 或更高

1.2 全局安装 Claude Code

# 官方 npm 包（注意：官方已废弃，但部分环境仍可用）
npm install -g @anthropic-ai/claude-code

# 或使用 npx 直接运行（无需全局安装）
npx @anthropic-ai/claude-code

⚠️ 重要提示：Anthropic 官方已废弃 npm 安装方式，推荐使用原生安装。但如果你的环境必须使用 npm，可以尝试社区维护版本或旧版安装 。

1.3 验证安装

claude --version
# 预期输出：Claude Code v0.2.x 或类似版本号

二、安装并配置 CC-Switch

2.1 下载 CC-Switch

# 前往 GitHub 下载对应版本
# 地址：https://github.com/farion1231/cc-switch/releases

# macOS 示例
curl -L -o cc-switch.zip https://github.com/farion1231/cc-switch/releases/download/v1.x.x/cc-switch-macOS.zip
unzip cc-switch.zip -d ~/Applications/
open ~/Applications/cc-switch.app

2.2 获取国内大模型 API Key

平台	获取地址	推荐模型
阿里云百炼	https://bailian.console.aliyun.com	qwen3.5-plus / qwen3.5-max
DeepSeek	https://platform.deepseek.com	deepseek-chat / deepseek-reasoner
SiliconFlow	https://siliconflow.cn	多模型聚合

2.3 CC-Switch 配置步骤

Step 1：打开 CC-Switch 应用

Step 2：添加供应商

API Key从大模型的开发后台获取，如下图：

1. 点击左侧「供应商」选项卡
2. 点击右上角「+」按钮
3. 选择预设模板（如「DashScope/百炼」）
4. 填入 API Key：sk-xxxxx
5. 确认 API Endpoint：https://dashscope.aliyuncs.com/api/v2/apps/claude-code-proxy
6. 点击「保存」

Step 3：配置模型映射

Claude 角色	映射到国产模型
Main Model	qwen3.5-plus 或 deepseek-chat
Reasoning Model	qwen3.5-max 或 deepseek-reasoner

Step 4：启用并测试

1. 点击供应商卡片
2. 点击右上角「切换/Enable」按钮
3. 点击「Test」发送测试消息
4. 看到正常响应后，重启终端

三、npm 环境下的特殊配置

3.1 检查 npm 全局安装路径

# 查看 npm 全局安装位置
npm root -g

# 查看 claude 命令位置
which claude
# 或 Windows: where claude

3.2 确保环境变量生效

CC-Switch 通过注入环境变量实现切换，npm 安装的 Claude Code 同样需要这些变量：

# 检查环境变量（macOS/Linux）
echo $ANTHROPIC_BASE_URL
echo $ANTHROPIC_API_KEY

# 检查环境变量（Windows PowerShell）
$env:ANTHROPIC_BASE_URL
$env:ANTHROPIC_API_KEY

3.3 手动配置环境变量（备用方案）

如果 CC-Switch 自动注入失效，可手动配置：

macOS/Linux（~/.zshrc 或 ~/.bashrc）：

export ANTHROPIC_BASE_URL="https://dashscope.aliyuncs.com/api/v2/apps/claude-code-proxy"
export ANTHROPIC_API_KEY="sk-your-api-key"

Windows（PowerShell profile）：

# 打开 profile 文件
notepad $PROFILE

# 添加内容
$env:ANTHROPIC_BASE_URL = "https://dashscope.aliyuncs.com/api/v2/apps/claude-code-proxy"
$env:ANTHROPIC_API_KEY = "sk-your-api-key"

四、启动验证

4.1 重启终端

# 重新加载配置
source ~/.zshrc  # 或 ~/.bashrc

# 验证环境变量
echo $ANTHROPIC_BASE_URL

4.2 启动 Claude Code

# 进入项目目录
cd ~/your-project

# 启动（npm 安装版本）
claude

# 或使用 npx
npx @anthropic-ai/claude-code

4.3 验证当前模型

# 在 Claude Code 交互界面中
/model

# 或
/status

五、常见问题

问题	原因	解决方案
npm install -g 失败	权限不足	sudo npm install -g 或修复 npm 权限
claude: command not found	全局路径未加入 PATH	添加 $(npm root -g)/../bin 到 PATH
仍提示登录 Anthropic	环境变量未生效	重启终端，检查 ANTHROPIC_BASE_URL
npm 版本与 CC-Switch 不兼容	官方已废弃 npm 安装	建议改用原生安装方式

六、推荐方案

由于 Anthropic 官方已废弃 npm 安装，建议：

表格

场景	推荐安装方式
长期使用	原生安装（curl | bash 或 irm | iex）
临时测试	npx 运行（npx @anthropic-ai/claude-code）
必须使用 npm	社区维护版本或旧版锁定

原生安装 + CC-Switch 是目前最稳定的组合。