Claude Code CLI — 中国大陆配置指南
在终端使用 Claude Code(Anthropic 官方 CLI)通过 ClaudeStore 连接 Claude API。无需 VPN,支持中国大陆直连。
安装
npm install -g @anthropic-ai/claude-code配置环境变量
export ANTHROPIC_BASE_URL=https://api3.claudestore.store
export ANTHROPIC_API_KEY="YOUR_SK_CS2_KEY"
export ANTHROPIC_MODEL="claude-sonnet-4.6"
export ANTHROPIC_SMALL_FAST_MODEL="claude-haiku-4.5"
export DISABLE_TELEMETRY=1
export DISABLE_AUTOUPDATER=1$env:ANTHROPIC_BASE_URL="https://api3.claudestore.store"
$env:ANTHROPIC_API_KEY="YOUR_SK_CS2_KEY"
$env:ANTHROPIC_MODEL="claude-sonnet-4.6"
$env:ANTHROPIC_SMALL_FAST_MODEL="claude-haiku-4.5"
$env:DISABLE_TELEMETRY="1"
$env:DISABLE_AUTOUPDATER="1"~/.claude/settings.json (推荐)
创建 ~/.claude/settings.json,让 CLI 与 VS Code 扩展使用同一份配置:
{
"env": {
"ANTHROPIC_BASE_URL": "https://api3.claudestore.store",
"ANTHROPIC_API_KEY": "YOUR_SK_CS2_KEY",
"ANTHROPIC_MODEL": "claude-sonnet-4.6",
"ANTHROPIC_SMALL_FAST_MODEL": "claude-haiku-4.5",
"DISABLE_TELEMETRY": "1",
"DISABLE_AUTOUPDATER": "1"
}
}只用 ANTHROPIC_API_KEY
ANTHROPIC_AUTH_TOKEN — 它是 Anthropic Pro/Max 的 OAuth 登录令牌,与自定义网关不兼容。验证连接
curl https://api3.claudestore.store/healthzcurl https://api3.claudestore.store/v1/models \
-H "Authorization: Bearer $ANTHROPIC_API_KEY"启动 Claude Code
cd your-project
claudeClaude Code 常见配置错误
UI 选择的模型与 ANTHROPIC_MODEL 冲突
最常见的问题之一:你在 Claude Code UI 中选择了一个模型(例如 opus[1m]), 但实际发出的请求却使用了另一个模型(例如 claude-sonnet-4.6)。 1M 上下文窗口和所选 effort 也好像没有生效。
原因通常是 ~/.claude/settings.json 中同时存在:
- 顶层
"model": "opus[1m]"(UI / picker 选择),以及 env.ANTHROPIC_MODEL指向了不同的模型。
ANTHROPIC_MODEL 是环境变量覆盖,会覆盖 UI 选择并决定实际请求使用的模型。ANTHROPIC_SMALL_FAST_MODEL 类似,但仅影响内部的 small/fast 路径(摘要、轻量步骤)——这不一定是 bug,但可以解释为什么部分调用走了另一个更便宜的模型。
模型只保留一个权威来源
ANTHROPIC_MODEL。推荐配置
方案 1 — 通过 UI / picker 控制模型(不要设置 ANTHROPIC_MODEL):
{
"env": {
"ANTHROPIC_BASE_URL": "https://api3.claudestore.store",
"ANTHROPIC_API_KEY": "YOUR_SK_CS2_KEY",
"ANTHROPIC_SMALL_FAST_MODEL": "claude-haiku-4.5"
},
"model": "opus[1m]"
}方案 2 — 用 ANTHROPIC_MODEL 强制锁定单一模型:
{
"env": {
"ANTHROPIC_BASE_URL": "https://api3.claudestore.store",
"ANTHROPIC_API_KEY": "YOUR_SK_CS2_KEY",
"ANTHROPIC_MODEL": "claude-opus-4.7"
}
}ANTHROPIC_SMALL_FAST_MODEL 仅用于 fast/small 模型行为,不要把它当成主模型。
检查清单:使用了错误的模型
如果出现以下任意一种情况:
- UI 中显示的模型与实际计费的模型不一致;
1m上下文未生效;- effort 设置似乎没有生效;
- 意外使用了 Sonnet 而不是 Opus(或相反)。
请按以下顺序检查:
~/.claude/settings.json—env.ANTHROPIC_MODEL是否与顶层"model"冲突?- 项目根目录的
.claude/settings.json— 同样检查;项目级文件会覆盖用户级文件。 - Shell 环境:
env | grep ANTHROPIC— 是否在~/.zshrc/~/.bashrc/ PowerShell profile 中导出了ANTHROPIC_MODEL或ANTHROPIC_SMALL_FAST_MODEL? - VS Code / Claude Code 扩展设置 — 扩展可能继承自带
ANTHROPIC_MODEL覆盖的环境。
移除冲突的覆盖(或让两边一致),重启 CLI / VS Code,然后重试。
Windows 完整配置指南
上面的步骤在 Windows 上同样适用,但 PATH、环境变量和配置文件路径不一样。本节是 Windows 专用的完整配方。
1. 安装 Node.js LTS
从 nodejs.org 下载 LTS 安装包,打开新的 PowerShell 验证:
node -v
npm -v2. 全局安装 Claude Code
npm install -g @anthropic-ai/claude-code
claude --version如果提示 claude 不是命令,关闭并重新打开 PowerShell。npm 全局目录 %APPDATA%\npm 仅在新会话中加入 PATH。
3. 持久化环境变量
$env:... 仅在当前会话有效。用 setx 写入用户配置:
setx ANTHROPIC_BASE_URL "https://api3.claudestore.store"
setx ANTHROPIC_API_KEY "YOUR_SK_CS2_KEY"
setx ANTHROPIC_MODEL "claude-sonnet-4.6"
setx ANTHROPIC_SMALL_FAST_MODEL "claude-haiku-4.5"
setx DISABLE_TELEMETRY "1"
setx DISABLE_AUTOUPDATER "1"GUI 替代方案:Win+R → sysdm.cpl → 高级 → 环境变量 → 用户变量。
setx 不会影响当前终端,请关掉再开新 PowerShell。4. Windows 上的 settings.json
路径是 %USERPROFILE%\.claude\settings.json(例如 C:\Users\<you>\.claude\settings.json):
mkdir $env:USERPROFILE\.claude -ErrorAction SilentlyContinue
notepad $env:USERPROFILE\.claude\settings.json粘贴上文相同的 JSON。
5. WSL / Remote-WSL
setx 设的变量不会进入 WSL。在 WSL 内的 ~/.bashrc 也要导出:
export ANTHROPIC_BASE_URL="https://api3.claudestore.store"
export ANTHROPIC_API_KEY="YOUR_SK_CS2_KEY"
export ANTHROPIC_MODEL="claude-sonnet-4.6"
export ANTHROPIC_SMALL_FAST_MODEL="claude-haiku-4.5"6. Windows 常见问题
- "claude 不是命令" — 打开新 PowerShell,或把
%APPDATA%\npm手动加入 PATH。 - PowerShell 引号 — 始终用双引号包裹值。cmd.exe 的引号规则不同,会破坏 URL。
- 企业代理:
setx HTTPS_PROXY "http://proxy.company:8080"。 - 杀软 / SmartScreen — 把
api3.claudestore.store与node.exe加入白名单。 - 长路径错误(npm 全局安装)— 启用 Win10/11 长路径:
git config --system core.longpaths true或注册表 LongPathsEnabled。