配置教程 · 核对于 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 中转站。

02第一步：安装

系统要求（官方安装页）：macOS 13.0 以上、Windows 10 1809 以上或 Ubuntu 20.04 以上，内存 4 GB 起。macOS、Linux 和 WSL 用原生安装脚本：

bash
1curl -fsSL https://claude.ai/install.sh | bash

Windows 在 PowerShell 里执行，不需要管理员权限：

powershell
1# PowerShell
2irm https://claude.ai/install.ps1 | iex
3
4# 或者用 WinGet
5winget install Anthropic.ClaudeCode

也可以用包管理器：

bash
1# Homebrew（macOS）
2brew install --cask claude-code
3
4# npm（需要 Node.js 22 或更高）
5npm install -g @anthropic-ai/claude-code

装完开一个新终端窗口，确认版本号能打印出来；claude doctor 会检查安装和配置文件有没有问题。

bash
1claude --version
2claude doctor

安装这一步下载的是 Anthropic 的安装包，和本站没有关系。命令返回一段 HTML、403 或者卡住不动时，照 官方的安装排错页 逐项对，上面按报错原文列了原因和可以换用的安装方式。

03第二步：拿到密钥

  1. 打开 控制台，填邮箱，收一个验证码登录。不要手机号，不要身份证件。
  2. 充值：USDT 或银行卡，最低 $10。余额以美元计，没有订阅。
  3. 创建密钥。密钥以 sk-relay- 开头，完整内容只显示一次，当场存好。

给 Claude Code 单独建一把密钥，顺手设一个美元预算：预算用完这把密钥就停，账户里其余的余额不受影响。购买和充值的细节在 Claude API Key 购买与充值。

04第三步：两个环境变量

先在当前终端里临时设置，跑通了再写进配置文件。macOS、Linux 和 WSL：

bash
1export ANTHROPIC_BASE_URL="https://api.relayswitch.io/v1"
2export ANTHROPIC_AUTH_TOKEN="sk-relay-..."
3claude

Windows PowerShell：

powershell
1$env:ANTHROPIC_BASE_URL = "https://api.relayswitch.io/v1"
2$env:ANTHROPIC_AUTH_TOKEN = "sk-relay-..."
3claude

终端里设的变量只对这个窗口有效。要让它对所有项目、所有启动方式都生效，写进用户级的 ~/.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。

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 更省事。

06第四步：验证接通

先绕开 Claude Code，直接向网关发一条最小的请求。返回 200 和一段 JSON，说明地址和密钥都对：

bash
1curl -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 报错速查 按状态码找。

07选模型与价格

下表是此刻目录里 Claude Code 能调用的 13 个 Claude id，价格渲染时读取。没有倍率：表里的美元价就是扣减价，人民币是参考价。

模型开发商输入 / 百万输出 / 百万
Claude Fable 5.1claude-fable-5.1Anthropic$6.00≈ ¥40.82$30.00≈ ¥204.12
Claude Fable 5.2claude-fable-5.2Anthropic$4.00≈ ¥27.22$20.00≈ ¥136.08
Claude Fable 5claude-fable-5Anthropic$3.00≈ ¥20.41$15.00≈ ¥102.06
Claude Opus 5.5claude-opus-5-5Anthropic$2.716≈ ¥18.48$9.70≈ ¥66.00
Claude Sonnet 4.6claude-sonnet-4-6Anthropic$1.80≈ ¥12.25$9.00≈ ¥61.24
Claude Opus 4.6claude-opus-4-6Anthropic$1.80≈ ¥12.25$7.50≈ ¥51.03
Claude Opus 4.7claude-opus-4-7Anthropic$1.80≈ ¥12.25$7.50≈ ¥51.03
Claude Opus 4.8claude-opus-4-8Anthropic$1.80≈ ¥12.25$7.50≈ ¥51.03
Claude Opus 5claude-opus-5Anthropic$1.80≈ ¥12.25$7.50≈ ¥51.03
Claude Haiku 4.5claude-haiku-4-5Anthropic$0.60≈ ¥4.08$3.00≈ ¥20.41
Claude Sonnet 5claude-sonnet-5Anthropic$1.20≈ ¥8.16$3.00≈ ¥20.41
Claude Sonnet 5.5claude-sonnet-5-5Anthropic$1.20≈ ¥8.16$3.00≈ ¥20.41
Claude Haiku 5.5claude-haiku-5-5Anthropic$0.0582≈ ¥0.396$0.1455≈ ¥0.99

美元 / 百万 tokens，人民币参考价按 ECB 2026-11-11 汇率

在会话里用 /model 切换；也可以直接写完整的 id，例如 /model claude-fable-5.1。

08充值、发票与支持

充值用 USDT 或银行卡，最低 $10，到账后余额以美元显示。充值不可退款，余额不过期。步骤和到账时间见 充值页。

发票是国际 PDF 发票：在控制台填公司抬头、地址和税号，每次充值生成一张带编号的发票，卖方是运营主体 Uplink Switch LLC。不开中国增值税专用发票或普通发票，需要走公司报销的先和财务确认这种发票能不能用。

支持渠道是邮箱 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 本身，官方排错页更全。
相关页面

装好了，就差一把密钥

邮箱开通，USDT 或银行卡充值，最低 $10。Base URL https://api.relayswitch.io/v1。

Claude Code 中转站获取密钥