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 并创建密钥
- 打开 foxhub.cn 注册账号并登录。
- 在左侧菜单进入「兑换」页面完成余额兑换。
- 进入「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。
第三步:切换并验证
- 保存配置后在 CC-Switch 中启用该供应商。
- 关闭所有 Claude Code 进程,重新打开。
- 在 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 的配置,从这里继续。