--- title: "国内怎么用 Claude Code：安装、接入 API 密钥、验证（2026 年 11 月）" canonical: https://relayswitch.ai/zh/guides/claude-code-china generated: 2026-11-12T04:23:05.953Z source: https://api.relayswitch.io/v1/catalog base_url: https://api.relayswitch.io/v1 --- 配置教程 · 核对于 2026-11-11 # 国内怎么用 Claude Code 这篇只讲配置：装好 Claude Code，把它指向一个按量计费的 API 密钥，确认请求接通，再把充值和发票的事办完。网络环境不在本文范围内，本站只提供 API 和计费，不提供任何网络接入服务。 ## 01先分清两种用法 Claude Code 有两种身份。一种是用 claude.ai 账号登录（`/login`），走订阅额度；另一种是给它一个 API 密钥，按 token 计费。两者可以装在同一台机器上，但一次会话只用其中一个。 本文走第二种。Claude Code 读两个环境变量：`ANTHROPIC_BASE_URL` 决定请求发到哪个地址，`ANTHROPIC_AUTH_TOKEN` 是这个地址认的密钥。两个都指向本站之后，每一轮对话从你在本站的预付余额里扣费，模型 id 还是原来的 Claude id。 想先看价格和可核对的证据，回到 [Claude Code 中转站](https://relayswitch.ai/zh/claude-code)。 ## 02第一步：安装 系统要求（官方安装页）：macOS 13.0 以上、Windows 10 1809 以上或 Ubuntu 20.04 以上，内存 4 GB 起。macOS、Linux 和 WSL 用原生安装脚本： bash 1`curl -fsSL https://claude.ai/install.sh | bash` Windows 在 PowerShell 里执行，不需要管理员权限： powershell 1`# PowerShell` 2`irm https://claude.ai/install.ps1 | iex` 3 4`# 或者用 WinGet` 5`winget install Anthropic.ClaudeCode` 也可以用包管理器： bash 1`# Homebrew（macOS）` 2`brew install --cask claude-code` 3 4`# npm（需要 Node.js 22 或更高）` 5`npm install -g @anthropic-ai/claude-code` 装完开一个新终端窗口，确认版本号能打印出来；`claude doctor` 会检查安装和配置文件有没有问题。 bash 1`claude --version` 2`claude doctor` 安装这一步下载的是 Anthropic 的安装包，和本站没有关系。命令返回一段 HTML、403 或者卡住不动时，照 [官方的安装排错页](https://code.claude.com/docs/en/troubleshoot-install) 逐项对，上面按报错原文列了原因和可以换用的安装方式。 ## 03第二步：拿到密钥 1. 打开 [控制台](https://app.relayswitch.io/console?lang=zh)，填邮箱，收一个验证码登录。不要手机号，不要身份证件。 2. 充值：USDT 或银行卡，最低 $10。余额以美元计，没有订阅。 3. 创建密钥。密钥以 `sk-relay-` 开头，完整内容只显示一次，当场存好。 给 Claude Code 单独建一把密钥，顺手设一个美元预算：预算用完这把密钥就停，账户里其余的余额不受影响。购买和充值的细节在 [Claude API Key 购买与充值](https://relayswitch.ai/zh/claude-api-key)。 ## 04第三步：两个环境变量 先在当前终端里临时设置，跑通了再写进配置文件。macOS、Linux 和 WSL： bash 1`export ANTHROPIC_BASE_URL="https://api.relayswitch.io/v1"` 2`export ANTHROPIC_AUTH_TOKEN="sk-relay-..."` 3`claude` Windows PowerShell： powershell 1`$env:ANTHROPIC_BASE_URL = "https://api.relayswitch.io/v1"` 2`$env:ANTHROPIC_AUTH_TOKEN = "sk-relay-..."` 3`claude` 终端里设的变量只对这个窗口有效。要让它对所有项目、所有启动方式都生效，写进用户级的 `~/.claude/settings.json`（Windows 是 `%USERPROFILE%\.claude\settings.json`）： json 1`{` 2 `"env": {` 3 `"ANTHROPIC_BASE_URL": "https://api.relayswitch.io/v1",` 4 `"ANTHROPIC_AUTH_TOKEN": "sk-relay-...",` 5 `"ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-5-5",` 6 `"ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-5-5",` 7 `"ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-haiku-5-5"` 8 `}` 9`}` 三个 `ANTHROPIC_DEFAULT_*_MODEL` 决定 `/model` 里 opus、sonnet、haiku 三个别名各指向哪个 id，可以不写。两点注意：同一个变量在终端和配置文件里都有时，以配置文件为准；密钥不要写进项目目录下的 `.claude/settings.json`，那个文件会随代码提交。逐个变量的说明在 [Claude Code 配置第三方 API](https://relayswitch.ai/zh/guides/claude-code)。 ## 05VS Code 扩展与桌面版 VS Code 里的 Claude Code 扩展在启动前先检查自己的设置，所以密钥要放在 VS Code 的用户设置里（命令面板里选 Preferences: Open User Settings (JSON)）： json 1`{` 2 `"claudeCode.environmentVariables": [` 3 `{ "name": "ANTHROPIC_BASE_URL", "value": "https://api.relayswitch.io/v1" },` 4 `{ "name": "ANTHROPIC_AUTH_TOKEN", "value": "sk-relay-..." }` 5 `]` 6`}` 桌面版不读这两个环境变量，也不读 `settings.json`，它有一套单独的第三方推理配置。本文只覆盖命令行和 VS Code 扩展。想在几个地址之间来回切换，用 [CC Switch](https://relayswitch.ai/zh/guides/cc-switch) 更省事。 ## 06第四步：验证接通 先绕开 Claude Code，直接向网关发一条最小的请求。返回 200 和一段 JSON，说明地址和密钥都对： bash 1`curl -i https://api.relayswitch.io/v1/messages \` 2 `-H "Authorization: Bearer sk-relay-..." \` 3 `-H "anthropic-version: 2023-06-01" \` 4 `-H "content-type: application/json" \` 5 `-d '{"model": "claude-haiku-5-5", "max_tokens": 16, "messages": [{"role": "user", "content": "回复 ok"}]}'` 然后启动 `claude`，发一句话，再运行 `/status`。Status 页上应该有两行：`Anthropic base URL` 显示 https://api.relayswitch.io/v1，`Auth token` 显示来源是 `ANTHROPIC_AUTH_TOKEN`。第一行没有，说明变量没传进这个进程；出现的是登录账号而不是 Auth token，说明密钥变量没生效。 请求几秒内出现在控制台的用量页，每一条都有模型 id、计费 tokens 和费用。报错了去 [Claude Code 报错速查](https://relayswitch.ai/zh/fix/claude-code-api-error) 按状态码找。 ## 07选模型与价格 下表是此刻目录里 Claude Code 能调用的 13 个 Claude id，价格渲染时读取。没有倍率：表里的美元价就是扣减价，人民币是参考价。 | 模型 | 开发商 | 输入 / 百万 | 输出 / 百万 | | --- | --- | --- | --- | | [Claude Fable 5.1](https://relayswitch.ai/zh/models/claude-fable-5.1)claude-fable-5.1 | Anthropic | $6.00≈ ¥40.82 | $30.00≈ ¥204.12 | | [Claude Fable 5.2](https://relayswitch.ai/zh/models/claude-fable-5.2)claude-fable-5.2 | Anthropic | $4.00≈ ¥27.22 | $20.00≈ ¥136.08 | | [Claude Fable 5](https://relayswitch.ai/zh/models/claude-fable-5)claude-fable-5 | Anthropic | $3.00≈ ¥20.41 | $15.00≈ ¥102.06 | | [Claude Opus 5.5](https://relayswitch.ai/zh/models/claude-opus-5-5)claude-opus-5-5 | Anthropic | $2.716≈ ¥18.48 | $9.70≈ ¥66.00 | | [Claude Sonnet 4.6](https://relayswitch.ai/zh/models/claude-sonnet-4-6)claude-sonnet-4-6 | Anthropic | $1.80≈ ¥12.25 | $9.00≈ ¥61.24 | | [Claude Opus 4.6](https://relayswitch.ai/zh/models/claude-opus-4-6)claude-opus-4-6 | Anthropic | $1.80≈ ¥12.25 | $7.50≈ ¥51.03 | | [Claude Opus 4.7](https://relayswitch.ai/zh/models/claude-opus-4-7)claude-opus-4-7 | Anthropic | $1.80≈ ¥12.25 | $7.50≈ ¥51.03 | | [Claude Opus 4.8](https://relayswitch.ai/zh/models/claude-opus-4-8)claude-opus-4-8 | Anthropic | $1.80≈ ¥12.25 | $7.50≈ ¥51.03 | | [Claude Opus 5](https://relayswitch.ai/zh/models/claude-opus-5)claude-opus-5 | Anthropic | $1.80≈ ¥12.25 | $7.50≈ ¥51.03 | | [Claude Haiku 4.5](https://relayswitch.ai/zh/models/claude-haiku-4-5)claude-haiku-4-5 | Anthropic | $0.60≈ ¥4.08 | $3.00≈ ¥20.41 | | [Claude Sonnet 5](https://relayswitch.ai/zh/models/claude-sonnet-5)claude-sonnet-5 | Anthropic | $1.20≈ ¥8.16 | $3.00≈ ¥20.41 | | [Claude Sonnet 5.5](https://relayswitch.ai/zh/models/claude-sonnet-5-5)claude-sonnet-5-5 | Anthropic | $1.20≈ ¥8.16 | $3.00≈ ¥20.41 | | [Claude Haiku 5.5](https://relayswitch.ai/zh/models/claude-haiku-5-5)claude-haiku-5-5 | Anthropic | $0.0582≈ ¥0.396 | $0.1455≈ ¥0.99 | 美元 / 百万 tokens，人民币参考价按 ECB 2026-11-11 汇率 在会话里用 `/model` 切换；也可以直接写完整的 id，例如 `/model claude-fable-5.1`。 ## 08充值、发票与支持 充值用 USDT 或银行卡，最低 $10，到账后余额以美元显示。充值不可退款，余额不过期。步骤和到账时间见 [充值页](https://relayswitch.ai/zh/pay)。 发票是国际 PDF 发票：在控制台填公司抬头、地址和税号，每次充值生成一张带编号的发票，卖方是运营主体 Uplink Switch LLC。不开中国增值税专用发票或普通发票，需要走公司报销的先和财务确认这种发票能不能用。 支持渠道是邮箱 [hello@relayswitch.io](mailto:hello@relayswitch.io)。来信带上请求 id，能省掉一轮来回。 ## 常见问题 用 API 密钥还需要 claude.ai 账号或订阅吗？ 不需要。按 Claude Code 的文档，设置了 ANTHROPIC\_AUTH\_TOKEN 之后，请求带的是这个凭据，不带 claude.ai 的登录，订阅的用量限制也不参与。账户在本站，用邮箱开通。 Windows 必须装 WSL 吗？ 不必。Claude Code 支持原生 Windows（Windows 10 1809 以上），在 PowerShell 或 CMD 里装都可以，不需要管理员权限。Git for Windows 是可选项：装了之后 Claude Code 用 Git Bash 执行命令，没装就用 PowerShell。 ANTHROPIC\_AUTH\_TOKEN 和 ANTHROPIC\_API\_KEY 用哪个？ 用 ANTHROPIC\_AUTH\_TOKEN。它以 Authorization: Bearer 发送，设置后立即生效；ANTHROPIC\_API\_KEY 以 x-api-key 发送，交互模式下要先确认一次。两个只留一个：同时设置且值不同，网关会返回 400，提示请求里带了不止一个密钥。 环境变量设了，为什么 Claude Code 还是让我登录？ 变量没有传到这个进程。从程序坞或开始菜单启动的编辑器读不到终端里 export 的变量；把两个变量写进 ~/.claude/settings.json 的 env 块（Windows 是 %USERPROFILE%\\.claude\\settings.json），再运行 /status，看有没有 Anthropic base URL 这一行。 人民币怎么付，能开发票吗？ 余额以美元计，用 USDT 或银行卡充值，最低 $10；页面上的人民币是按欧洲央行汇率折算的参考价，不参与计费。发票是国际 PDF 发票：在控制台填公司抬头、地址和税号后，每次充值生成一张带编号的发票。不开中国增值税发票。 遇到问题找谁？ 发邮件到 hello@relayswitch.io，附上响应头里的请求 id（x-uplink-request-id），我们按这个 id 查到那一次调用。安装和登录类的问题属于 Claude Code 本身，官方排错页更全。 相关页面 - [Claude Code 中转站](https://relayswitch.ai/zh/claude-code) - [Claude Code 配置第三方 API](https://relayswitch.ai/zh/guides/claude-code) - [CC Switch 配置中转站](https://relayswitch.ai/zh/guides/cc-switch) - [Claude API 中转站](https://relayswitch.ai/zh/claude-api) - [Claude API Key 购买与充值](https://relayswitch.ai/zh/claude-api-key) - [Claude Code 报错速查](https://relayswitch.ai/zh/fix/claude-code-api-error) - [Claude Code 报错 403](https://relayswitch.ai/zh/fix/claude-code-403) - [Claude Code 封号](https://relayswitch.ai/zh/claude-code-fenghao) - [API 中转站怎么选](https://relayswitch.ai/zh/zhongzhuanzhan-tuijian) - [Claude Code 官方安装页](https://code.claude.com/docs/en/setup) - [Claude Code 官方网关接入页](https://code.claude.com/docs/en/llm-gateway-connect) ## 装好了，就差一把密钥 邮箱开通，USDT 或银行卡充值，最低 $10。Base URL https://api.relayswitch.io/v1。 [Claude Code 中转站](https://relayswitch.ai/zh/claude-code)[获取密钥](https://app.relayswitch.io/console?lang=zh)