Claude Code 【npm安装】如何接入国内大模型？

官方之前的安装方法原生安装、 npm 安装。今天使用npm方式安装哦原生安装 vs npm 安装对比特性原生安装npm 安装需要 Node.js❌ 不需要✅ 需要安装速度⚡ 快单二进制文件 慢下载依赖官方支持✅ 官方推荐❌ 已废弃自动更新✅ 内置检查❌ 手动更新系统兼容性✅ 更好⚠️ 可能遇到平台错误PATH 配置macOS/Linux 自动Win 手动需手动配置 npm 全局路径一、npm 安装 Claude Code1.1 前提条件确保已安装 Node.js建议 v18node --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-Switch2.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.comqwen3.5-plus / qwen3.5-maxDeepSeekhttps://platform.deepseek.comdeepseek-chat / deepseek-reasonerSiliconFlowhttps://siliconflow.cn多模型聚合2.3 CC-Switch 配置步骤Step 1打开 CC-Switch 应用Step 2添加供应商API Key从大模型的开发后台获取如下图1. 点击左侧「供应商」选项卡 2. 点击右上角「」按钮 3. 选择预设模板如「DashScope/百炼」 4. 填入 API Keysk-xxxxx 5. 确认 API Endpointhttps://dashscope.aliyuncs.com/api/v2/apps/claude-code-proxy 6. 点击「保存」Step 3配置模型映射Claude 角色映射到国产模型Main Modelqwen3.5-plus 或 deepseek-chatReasoning Modelqwen3.5-max 或 deepseek-reasonerStep 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 或 ~/.bashrcexport ANTHROPIC_BASE_URLhttps://dashscope.aliyuncs.com/api/v2/apps/claude-code-proxy export ANTHROPIC_API_KEYsk-your-api-keyWindowsPowerShell 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_URLnpm 版本与 CC-Switch 不兼容官方已废弃 npm 安装建议改用原生安装方式六、推荐方案由于 Anthropic 官方已废弃 npm 安装建议表格场景推荐安装方式长期使用原生安装curl | bash或irm | iex临时测试npx 运行npx anthropic-ai/claude-code必须使用 npm社区维护版本或旧版锁定原生安装 CC-Switch 是目前最稳定的组合。