Claude Code 【npm安装】如何接入国内大模型？
官方之前的安装方法：原生安装、 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.app2.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 claude3.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_KEY3.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_URL4.2 启动 Claude Code
# 进入项目目录 cd ~/your-project # 启动（npm 安装版本） claude # 或使用 npx npx @anthropic-ai/claude-code4.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 是目前最稳定的组合。