Claude Code 国内怎么用？接入鹊桥 API 的配置教程（附实测）

Claude Code 是 Anthropic 出的编程助手，在终端里运行：读代码、改文件、跑命令，用中文说清楚要做什么就行。很多人喜欢它的交互方式和工具链，但在国内用起来有两道坎：Anthropic 的服务不面向中国大陆，官方账号和付款都需要海外条件；官方安装脚本也要从 claude.ai 下载。

Claude Code 官方支持把请求发到第三方的 API 服务。这篇文章讲怎么把它接到鹊桥 API 上，每一步都实际跑过。

第一步：安装 Claude Code

官方推荐的安装脚本要从 claude.ai 下载，国内网络可能连不上。可以改用 npm 安装，国内用 npmmirror 镜像（我们确认过镜像上有最新的 2.1.301，包括 Windows、macOS、Linux 的安装文件）：

npm install -g @anthropic-ai/claude-code --registry=https://registry.npmmirror.com

# 装好后看一下版本
claude --version

npm 方式需要先装 Node.js，官方建议 22 或更新的版本（旧版本安装时会有警告，但装好后照样能用）。Windows 上建议同时装 Git for Windows，Claude Code 会用它自带的 Bash 执行命令；不装的话改用 PowerShell，也能用。

第二步：注册并创建 API 密钥

1. 注册鹊桥 API 账号；
2. 在钱包页用支付宝充值，10 元起充，通常十几秒内自动到账（充值说明）；
3. 打开控制台的「API 密钥」页面，创建一个密钥，复制下来（以 sk- 开头）。分组决定用哪类模型：选「Claude（Kiro）」或「Claude（MAX 满血）」用 Claude 模型，默认分组用 GPT 模型（价格见模型与价格）。

第三步：配置 Claude Code

方法一：CC Switch 一键导入（推荐）

在「API 密钥」页面点密钥右侧的「⋯」，选「一键导入 CC Switch」，在打开的页面上方选「Claude Code」，再选线路（GPT、Claude Kiro 或 Claude MAX，要和密钥的分组对应）、主模型和后台小模型后导入；再在 CC Switch 的 Claude 页面把导入的「鹊桥 API」供应商设为当前供应商，重新打开 Claude Code 即可。导入后在终端运行一次导入页下方的命令：CC Switch 只写入地址、密钥、模型和上下文这类设置，这条命令补上网页抓取的设置（不加时国内网络下 WebFetch 会报错）和推理强度。详细步骤见一键导入说明。

方法二：手动写配置文件

Claude Code 的配置文件在 ~/.claude/settings.json（Windows 是 %USERPROFILE%\.claude\settings.json）。按密钥的分组写入下面其中一份，文件里已经有别的设置时，把 env 外面的几项和 env 里这些项合并进去。

用 Claude 模型（Claude（Kiro）分组的密钥；MAX 满血分组把 Sonnet 档位换成 claude-sonnet-5-5、Haiku 档位换成 claude-haiku-5-5）：

{
  "skipWebFetchPreflight": true,
  "env": {
    "ANTHROPIC_BASE_URL": "https://queqiaoapi.com",
    "ANTHROPIC_AUTH_TOKEN": "sk-你的Claude分组密钥",
    "ANTHROPIC_MODEL": "claude-opus-5-5",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-5-5",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-5",
    "ANTHROPIC_DEFAULT_FABLE_MODEL": "claude-fable-5-1",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-haiku-4-5-20251001",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1"
  }
}

用 GPT 模型（默认分组的密钥）：

{
  "skipWebFetchPreflight": true,
  "effortLevel": "high",
  "env": {
    "ANTHROPIC_BASE_URL": "https://queqiaoapi.com",
    "ANTHROPIC_AUTH_TOKEN": "sk-你的密钥",
    "ANTHROPIC_MODEL": "gpt-6.1-sol",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "gpt-6.1-sol",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "gpt-6.1-sol",
    "ANTHROPIC_DEFAULT_FABLE_MODEL": "gpt-6.1-sol",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "gpt-5.6-luna",
    "ANTHROPIC_CUSTOM_HEADERS": "x-queqiao-context: long",
    "CLAUDE_CODE_MAX_CONTEXT_TOKENS": "872000",
    "CLAUDE_CODE_AUTO_COMPACT_WINDOW": "817800",
    "CLAUDE_CODE_AUTO_MODE_SERVER": "0",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1",
    "CLAUDE_CODE_GATEWAY_HINT_HEADERS": "1",
    "CLAUDE_CODE_ATTRIBUTION_HEADER": "0"
  }
}

几个关键的地方：

• ANTHROPIC_BASE_URL 填 https://queqiaoapi.com，不带 /v1。Claude Code 照常发 Anthropic 格式的请求：Claude 模型名原样交给 Claude 渠道，GPT 模型名由本站在服务端转换。
• ANTHROPIC_AUTH_TOKEN 填你的密钥。用它而不是 ANTHROPIC_API_KEY，Claude Code 就不会再问你要不要使用这个 API Key。
• Claude 配置里，Opus、Sonnet、Fable、Haiku 档位各填这个分组里对应的 Claude 模型；GPT 配置里，ANTHROPIC_MODEL 和 Opus、Sonnet、Fable 三个档位填同一个主模型。ANTHROPIC_DEFAULT_HAIKU_MODEL 都是后台小任务用的小模型。模型名用价格页上的名字。
• skipWebFetchPreflight 写在最外层：Claude Code 抓网页前默认先连 api.anthropic.com 检查域名，国内网络连不上，不加这一行 WebFetch 会报错。
• GPT 配置里的 effortLevel 是推理强度，可选 low、medium、high、xhigh，以后在 Claude Code 里用 /effort 切换会改写它；max 用 /effort max，只在当前会话生效。
• GPT 配置的上下文按模型上限 87.2 万 token 设置，用到 78.48 万（90%）时 Claude Code 自动压缩；ANTHROPIC_CUSTOM_HEADERS 这一行告诉本站按 87.2 万处理。

每一项的详细说明见使用教程。保存后重新打开终端再运行 claude。

第四步：跑起来，确认接通了

先用非交互模式问一句：

claude -p "say ok"

回复 ok 就说明接通了。之后进到项目目录运行 claude，就是平常的交互界面。

实测：用 Claude Code 修一个小 bug 花了多少钱

我们用和 Codex 教程里同一个有 bug 的小函数测试：average 求平均值，循环漏掉了第 1 个数，空列表还会除以零。这次用的是 GPT 线路，主模型 gpt-6.1-sol，推理强度 medium：

claude -p "calc.py 里的 average 函数有 bug，找出来修好，然后运行 python test_calc.py 确认测试通过。" \
  --permission-mode acceptEdits --allowedTools "Bash(python test_calc.py)"

Claude Code 回复：“已修复 calc.py 的 average 函数：之前循环从索引 1 开始，漏掉了第一个元素；空列表也会导致除零……运行 python test_calc.py，测试通过：all tests passed。”从开始到结束约 20 秒。用量来自本站的使用日志：

同一个任务，两个工具都修好了，花费都在几分钱。Claude Code 每次请求会带上一万多 token 的系统提示和工具说明，第一次请求没有缓存，后面的请求大部分输入都命中缓存，按输入价的 5%～10% 计费。本站会把同一个会话固定在同一条线路上，缓存才能持续命中。

Claude 线路我们用 Claude Code 2.1.301 在 Kiro 和 MAX 两个分组都实测过：工具调用正常，第二轮起每次有两三万到四万 token 的输入命中缓存。Claude 模型按所选分组的价格计费，缓存写入和命中分别计价，见模型与价格。

用 GPT 线路时和官方有什么不同

用 Claude 分组的密钥时，背后就是 Claude 模型，下面这几条不适用。用默认分组的密钥（GPT 模型）时：

• 模型：/model 里的 Opus、Sonnet 档位就是你配置的主模型，Haiku 档位是小模型。要换别的模型，改 settings.json 或重新一键导入；推理强度用 /effort 切换。
• 思考过程：Claude Code 里显示的思考过程是模型的推理摘要，不是完整的思考内容，推理较短时可能是空的。
• 网页搜索：WebSearch 由 OpenAI 的搜索服务完成，结果和官方 Claude 不同。
• 启动提示：Claude Code 可能提示模型未被识别、或者请求经过网关，这是接第三方模型的正常提示，不影响使用。
• 上下文：上面的配置按模型上限 87.2 万 token 设置，用到 90% 时 Claude Code 自动压缩较早的对话；单次请求的提示词超过 27.2 万 token 时按长上下文价格计费。想一直按标准价，见使用教程里的“想把上下文控制在 27.2 万以内”。

常见报错和解决办法

前两条是我们实测时 Claude Code 显示的原文。

GPT 线路的后台小模型 gpt-5.6-luna 在上游限流或暂时不可用时，这些请求会自动改用 gpt-6.1-sol 完成，按实际使用的模型计费，不需要你处理。

常见问题

会影响我原来的 Claude 账号吗？

写在 ~/.claude/settings.json 里的设置对所有 Claude Code 会话生效。想换回官方账号，把 env 里这些项删掉；用 CC Switch 的话，在 Claude 页面切回原来的供应商就行。

能用 Claude 模型吗？

能。在控制台「API 密钥」新建密钥时选「Claude（Kiro）」或「Claude（MAX 满血）」分组，按上面的 Claude 配置写模型名就行。两个分组模型名一样，价格 = 官方价 × 分组倍率（Kiro ×0.54，MAX 满血 ×1.56）。

价格和其他用法一样吗？

一样。用 Claude Code 和直接调接口按同样的 token 单价计费（Claude 按所选分组计价），见模型与价格。