FoxHub· AI API 中转
FoxHub / 使用教程 / Claude Code 中转

Claude Code 中转使用教程:国内接入方法与配置步骤

更新于 2026-10-19 · 阅读约 4 分钟 · 适用客户端:Claude Code / CC-Switch

Claude Code 是 Anthropic 官方的命令行编程工具,直连官方 API 需要海外网络环境,且按官方挂牌价计费。通过 FoxHub 中转,只需要把请求地址换成 https://foxhub.cn,即可在 Claude Code 中使用 claude-sonnet-5,价格为官方的 0.16 倍(省 84%),且 API 格式与 Anthropic 完全一致,客户端无需任何改造。

核心配置就两行:请求地址填 https://foxhub.cn(不要带 /v1),API Key 在 FoxHub 控制台创建(选 Anthropic 兼容分组)。下面是从零开始的完整步骤。

三步完成接入

第一步:注册 FoxHub 并创建密钥

  1. 打开 foxhub.cn 注册账号并登录。
  2. 在左侧菜单进入「兑换」页面完成余额兑换。
  3. 进入「API 密钥」页面,选择 Anthropic 兼容分组,创建 API Key。不同客户端建议创建不同 Key,方便排查问题和分别统计用量。

第二步:配置请求地址

推荐用 CC-Switch 集中管理供应商和密钥(也可以直接在客户端环境变量里配置):

API 请求地址
https://foxhub.cn
API 格式
Anthropic Messages(原生)
分组选择
Anthropic / Claude 兼容分组
模型名称
claude-sonnet-5(以后台显示为准)
最容易踩的坑:渠道类型不要选错。Claude Code 选 Anthropic 类型,GPT / Codex 才选 OpenAI 类型;另外 Claude 地址不带 /v1,重复添加会导致 404。

第三步:切换并验证

  1. 保存配置后在 CC-Switch 中启用该供应商。
  2. 关闭所有 Claude Code 进程,重新打开。
  3. 在 Claude Code 中选择 claude-sonnet-5 发送一条测试消息,返回正常即接入成功。

费用:比官方便宜多少

以主力型号 claude-sonnet-5 所在的 kiro 福利分组(0.16x)为例,按每百万 token 计费:

官方挂牌价
$2.00 / $10.00(输入 / 输出)
FoxHub 价格
$0.32 / $1.60(输入 / 输出)
折扣
省 84%

FoxHub 按 1 元 = 1 美元额度结算(1:1,不做汇率换算),表内数字可直接当人民币理解。完整 9 个分组的价格对照见 价格总览。

常见错误排查

400 Bad Request — 请求参数有问题
检查模型名称是否复制了后台显示的完整名称(不要自行添加后缀)、检查 API 地址;减少上下文内容后重新发送,或先用最小测试请求验证。
401 Unauthorized — 身份验证失败
重新复制 API Key,确认没有多余空格、换行或引号;确认创建时选的是 Anthropic 兼容分组;仍失败就重新创建一个 Key。
403 Forbidden — 没有权限完成请求
检查账号余额是否充足;确认分组支持所选模型;尝试切换其他可用模型。
404 Not Found — 请求地址不存在
检查 Base URL 是否填写正确;不要重复添加 /v1;不要在地址末尾加多余斜杠。
model not found — 模型名称无法识别
复制后台显示的完整模型名称,确认大小写和符号完全一致,不要自行添加后缀。

下一步

想看完整价格对照、或了解 Codex / CC-Switch 的配置,从这里继续。