ClaudeStore/文档
⚠ 文档仍在完善中。部分内容可能不准确或为临时由 AI 生成。

Claude Code CLI — 中国大陆配置指南

在终端使用 Claude Code(Anthropic 官方 CLI)通过 ClaudeStore 连接 Claude API。无需 VPN,支持中国大陆直连。

安装

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

配置环境变量

bash / zsh (~/.zshrc 或 ~/.bashrc)bash
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
PowerShell (Windows)powershell
$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 扩展使用同一份配置:

~/.claude/settings.json (canonical)json
{
  "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 登录令牌,与自定义网关不兼容。

验证连接

Healthbash
curl https://api3.claudestore.store/healthz
模型列表bash
curl https://api3.claudestore.store/v1/models \
  -H "Authorization: Bearer $ANTHROPIC_API_KEY"

启动 Claude Code

cd your-project
claude
现在你可以让 Claude 阅读、修改、重构代码,全部在中国大陆直连。

Claude 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,但可以解释为什么部分调用走了另一个更便宜的模型。

模型只保留一个权威来源

如果希望以 picker 为准,请不要同时保留 UI 选择的模型和与之冲突的 ANTHROPIC_MODEL

推荐配置

方案 1 — 通过 UI / picker 控制模型(不要设置 ANTHROPIC_MODEL):

~/.claude/settings.json (UI 控制模型)json
{
  "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 强制锁定单一模型

~/.claude/settings.json (env 锁定模型)json
{
  "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(或相反)。

请按以下顺序检查:

  1. ~/.claude/settings.jsonenv.ANTHROPIC_MODEL 是否与顶层 "model" 冲突?
  2. 项目根目录的 .claude/settings.json — 同样检查;项目级文件会覆盖用户级文件。
  3. Shell 环境:env | grep ANTHROPIC — 是否在 ~/.zshrc / ~/.bashrc / PowerShell profile 中导出了 ANTHROPIC_MODELANTHROPIC_SMALL_FAST_MODEL
  4. VS Code / Claude Code 扩展设置 — 扩展可能继承自带 ANTHROPIC_MODEL 覆盖的环境。

移除冲突的覆盖(或让两边一致),重启 CLI / VS Code,然后重试。

Windows 完整配置指南

上面的步骤在 Windows 上同样适用,但 PATH、环境变量和配置文件路径不一样。本节是 Windows 专用的完整配方。

1. 安装 Node.js LTS

nodejs.org 下载 LTS 安装包,打开新的 PowerShell 验证:

node -v
npm -v

2. 全局安装 Claude Code

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

如果提示 claude 不是命令,关闭并重新打开 PowerShell。npm 全局目录 %APPDATA%\npm 仅在新会话中加入 PATH。

3. 持久化环境变量

$env:... 仅在当前会话有效。用 setx 写入用户配置:

PowerShell(运行一次)powershell
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+Rsysdm.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 也要导出:

~/.bashrc(WSL 内)bash
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.storenode.exe 加入白名单。
  • 长路径错误(npm 全局安装)— 启用 Win10/11 长路径:git config --system core.longpaths true 或注册表 LongPathsEnabled。

准备好开始了吗?

2 分钟即可获得 Claude 全系列模型 API 接入。

查看价格