Claude Code 国内环境实战：安装、第三方 Provider 配置与多模型切换（Windows/macOS）

January 23, 2026·Claude CN Team·开发指南·Claude Code, 安装, 第三方 Provider, 环境变量, settings.json, Windows, macOS, VS Code

Claude Code “看起来很快上手”，但在国内网络与工具链环境下，真正劝退人的往往不是提示词，而是两件事：

装不起来（Node/npm 权限、网络、registry）
连不上（Key/Base URL/Token 配错、终端没加载配置、IDE/CLI 配置不一致）

这篇文章把流程压缩成一条主线：先把 CLI 正常启动 → 再把 Provider 配通 → 最后把切换与 IDE 集成做成可复用的“开关”。

说明：下文“第三方 Provider”指提供 Anthropic 兼容接口 的服务（能接受 ANTHROPIC_BASE_URL + ANTHROPIC_API_KEY/ANTHROPIC_AUTH_TOKEN）。请自行确保账号、Key 与使用方式合规；不要通过修改内部状态文件去“绕过登录/引导”。

1) 安装：把 Claude Code CLI 跑起来

1.1 安装 Node.js（建议 18+）

Claude Code 的 CLI 通过 npm 安装。先确认 Node/npm 可用：

node --version
npm --version

常见坑：

macOS 直接用系统 Node + 全局安装，容易遇到权限问题：更稳妥的方式是用 nvm 管理 Node 版本。
Windows PowerShell 执行策略/权限问题：遇到安装失败先看报错，再决定是否需要管理员权限。

1.2 安装 Claude Code

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

如果 claude -v 能输出版本号，说明 CLI 已就绪。

（更多基础使用见：基础使用）

2) 配置：用官方 / 第三方 Provider 启动

Claude Code 的配置入口主要有两类：

环境变量：适合临时切换、脚本化
~/.claude/settings.json：适合持久化（扩展与 CLI 共享）

推荐先把配置写到 settings.json，再用脚本做“多套配置切换”。

2.1 `settings.json`（推荐）

在 ~/.claude/settings.json 写入（示例）：

{
  "env": {
    "ANTHROPIC_API_KEY": "YOUR_API_KEY",
    "ANTHROPIC_BASE_URL": "https://your-provider.example.com/anthropic"
  }
}

更多字段与权限规则语法见：配置参考。

2.2 环境变量（适合临时试错）

macOS/Linux（zsh/bash）：

export ANTHROPIC_API_KEY="YOUR_API_KEY"
export ANTHROPIC_BASE_URL="https://your-provider.example.com/anthropic"
claude

Windows PowerShell：

$env:ANTHROPIC_API_KEY="YOUR_API_KEY"
$env:ANTHROPIC_BASE_URL="https://your-provider.example.com/anthropic"
claude

2.3 两个最容易配错的点

终端“没加载”你刚改的配置：改完 settings.json/环境变量后，建议新开一个终端窗口再试一次。
Key 与 Base URL 混用：有的 Provider 用 ANTHROPIC_API_KEY，有的更偏向 ANTHROPIC_AUTH_TOKEN；如果鉴权失败，优先按 Provider 文档选其一，不要同时乱填。

3) 多模型/多 Provider 一键切换（把“开关”写成脚本）

目标：你不需要每次都手动复制粘贴一堆环境变量；而是执行一个函数就切换。

3.1 macOS/Linux：写到 `~/.zshrc`（示例）

claude-provider-a() {
  export ANTHROPIC_BASE_URL="https://provider-a.example.com/anthropic"
  export ANTHROPIC_API_KEY="YOUR_KEY_A"
  export ANTHROPIC_MODEL="model-a"
  claude
}

claude-provider-b() {
  export ANTHROPIC_BASE_URL="https://provider-b.example.com/anthropic"
  export ANTHROPIC_API_KEY="YOUR_KEY_B"
  export ANTHROPIC_MODEL="model-b"
  claude
}

你可以把 Key 放到更安全的位置（例如系统 Keychain、1Password CLI、企业密钥管理），脚本里只负责“加载”。

3.2 Windows：写到 PowerShell `$PROFILE`（示例）

function claude-provider-a {
  $env:ANTHROPIC_BASE_URL = "https://provider-a.example.com/anthropic"
  $env:ANTHROPIC_API_KEY = "YOUR_KEY_A"
  $env:ANTHROPIC_MODEL = "model-a"
  claude
}

function claude-provider-b {
  $env:ANTHROPIC_BASE_URL = "https://provider-b.example.com/anthropic"
  $env:ANTHROPIC_API_KEY = "YOUR_KEY_B"
  $env:ANTHROPIC_MODEL = "model-b"
  claude
}

4) VS Code 扩展：让配置与 CLI 同步

VS Code 扩展适合日常开发（更直观的 diff 审核、Plan 预览、@ 引用等），但有些高级能力依然要用 CLI。好消息是：扩展与 CLI 共享 ~/.claude/settings.json。

扩展使用说明：VS Code 集成
配置与环境变量：配置参考

如果你更倾向“只在扩展里跑”，请确保扩展侧的 environmentVariables 与 CLI 使用同一套 Provider 变量，否则会出现“终端能用、扩展不能用”或相反的情况。

5) 排障清单（按优先级）

claude -v 能不能正常输出版本（先确认安装没问题）
settings.json 是否是合法 JSON（一个多余逗号就会导致加载失败）
新开终端后再试一次（排除配置未加载）
Provider 鉴权失败：只保留一种鉴权变量（ANTHROPIC_API_KEY 或 ANTHROPIC_AUTH_TOKEN），并确认 Base URL 是否带对“兼容路径”
npm 安装卡住/超时：优先检查网络与 registry；不要盲目重复安装