常见问题

当前购买口径

渠道	计费口径	适合谁	说明
Anthropic 官方	官方订阅 / 官方 API 美元账单	有海外支付、合规或官方销售需求	自己维护账号、付款和限额
Handsfree Club	$30 / $100 / $500 站内调用额度	Claude Code、Codex、Cursor、Cline 等统一 Key 场景	$ 为站内计费标识，不是可提现或兑换的美元现金；按调用扣额度，其他金额可人工充值

服务稳定性与故障处理

• 按额度结算:服务并非无限量；实际可用性仍会受上游容量与接入通道影响
• 出问题能定位:余额页看消耗流水,status page 看服务状态,客服能按时间查错误记录
• 短暂失败处理:部分失败请求可能重试；如发现重复或异常扣费，请提供请求时间和记录联系客服核查
• 持续异常会处理:连续 30 分钟不可用 → 按实际影响提供额度补偿

什么时候建议直接用官方

• 企业有 SOC2 / BAA / GDPR 等合规硬要求,我们当前提供不了正式合规协议
• 需要官方账号权益或超大账单额度,例如团队统一合同、发票、企业审计和专属限额
• 需要 Anthropic 销售直接对接(SO 价、专属客户成功)

还不行?

价格 / 稳定性细节疑问，请联系管理员或客服。我们直接按余额页流水、错误记录和 status page 历史记录解释,不让你靠猜。

Handsfree Club 当前说明

维度	当前说明
接入场景	Claude Code、Codex、Cursor、Cline 等支持的客户端，兼容范围见接入文档
价格	按额度充值，具体价格、到账额度和扣费明细请在下单前核对
客服	可通过页面公布的邮箱或 Telegram 联系管理员或客服
稳定性	依赖本服务及上游可用性；状态页和单次调用结果均需结合实际情况判断
模型与数据	模型标识、角色别名和协议兼容性见FAQ 5；数据处理见隐私说明
开票	下单前确认，见发票与付款凭证

购买前先确认

• 你的客户端、所需模型和功能是否在当前支持范围内
• 实际价格、退款规则和可提供的付款凭证是否满足需求
• 涉及敏感数据或企业采购时，先核对所需的数据处理协议、审计材料和供应商条件；本页不代表相关资质已经具备

需要比较具体功能，请把需求发给管理员或客服，按双方当前公开资料逐项确认。

服务可能受到哪些影响

本服务依赖第三方上游。上游账号、接入通道、服务政策、限流、网络或本服务经营变化，都可能导致部分功能不可用或服务暂停。我们不能保证永不中断。

经营与售后信息

1. 经营主体:同頻數字有限公司（Resonance Digital Limited），详见公司信息
2. 人工支持:需要时可直接联系管理员或客服，按公开服务承诺响应
3. 按需充值:提供 $30 / $100 / $500 固定档位，也支持人工自定义金额，建议用多少充多少
4. 退款规则:今后订单因我方原因退款，退还未使用额度对应实付金额的全额；个人原因退款，退还未使用额度对应实付金额的 50%。错误扣费、未交付及依法应退情形另行纠正处理，详见退款政策
5. 服务停止与历史订单:服务下线属于我方原因，未使用额度对应实付金额全额退还；已有订单保留购买时承诺，不因本次更新追溯减少权益

你应该怎么做(自我保护)

1. 先充 $30 固定额度跑通，验证客服响应速度和实际可用性
2. 确认适合后再按实际用量选择 $100 / $500 或人工自定义金额，避免一次充值过多
3. 每周看一眼 status page,有连续 1 天异常的迹象提前找客服
4. 重要项目同时备一个官方账号或第二家中转作 fallback,不把所有鸡蛋放一个篮子

还不行?

对我们团队还有疑虑，请联系管理员或客服申请进一步核验,信任建立是双向的,我们欢迎尽调。

额度怎么买

• 固定档位：$30 / $100 / $500 站内调用额度
• 在充值页面选择档位，跳转链动小铺完成付款并获取兑换码
• 回到个人中心的兑换页面提交兑换码，成功后额度进入账户
• 需要其他金额时，联系管理员或客服人工自定义充值，管理员在后台入账

怎么扣费

• 文本模型按请求产生的实际 token 和请求时的价格快照扣费
• 生图按图片档位和成功生成张数扣费，失败请求不计费
• 同一账户使用同一个余额池，不需要为 GPT 和 Claude 分开购买
• 余额、扣费明细和当前模型价格以 Console 实际展示为准

为什么价格有优势

本站价格由实际服务范围、计费方式和运营安排决定，不等同于官方订阅或官方 API 的价格与权益。请比较当前模型、扣费规则和服务限制；协议兼容或模型的自我介绍不能单独证明上游身份或授权情况。

相关：充值怎么选 · Token 怎么算

注册不再自动发放体验额度；请先在充值页面选择额度并完成兑换。

你的情况	建议
第一次充值 / 轻量使用	$30 站内调用额度
日常开发 / 持续调用	$100 站内调用额度
团队 / Agent / 高强度调用	$500 站内调用额度
需要其他金额	联系管理员或客服人工自定义充值

自助充值流程

1. 在充值页面选择额度
2. 跳转链动小铺下单并付款
3. 在链动小铺获取兑换码
4. 回个人中心兑换，确认余额到账

三档怎么选

档位	用途	价格	¥30 能跑
1K	缩略图 / 草图 / 批量预览	¥0.05	600 张
2K(默认)	公众号配图 / PPT 插图 / 自媒体素材	¥0.10	300 张
4K	海报 / 印刷 / 商品图	¥0.20	150 张

"我就想生图,不跑代码可以吗?"

可以。注册后选择「按额度充值」，完成兑换后即可使用。Console 显示余额和每次扣费流水；固定档位以充值页面为准，需要其他金额可联系人工处理。

失败会扣费吗

不会。只有 200 OK 且实际拿到图片字节才扣费。被 OpenAI 内容政策拦掉(真人脸 / 暴力 / 政治人物)、超时 504、地址 / 模型名错都不算钱,Console 也不会出现这条记录。

图生图 / variations 什么时候开?

/v1/images/edits(图生图)和 /v1/images/variations(变体)本季度内开放内测。需要的同学发 TG @prosper777888 报名,内测开放时优先发邀请。

→ 完整接入示例(curl / Python / Node 三方式 + 错误码 + 8 条 FAQ): /docs/image

模型名称与实际能力

• 部分客户端使用角色别名；请查看相应接入文档说明的映射关系，并核对 Console 中的执行模型与计费记录。
• 上下文长度、工具调用、图片处理、流式输出等能力，依具体模型、通道和客户端兼容范围而异。
• 同一任务的输出可能变化；长文本测试、知识问答、响应格式或模型自报身份，都不能单独证明使用的是哪家供应商的哪一款模型。

服务与第三方的关系

Handsfree Club 由同頻數字有限公司独立运营，提供第三方模型接入与额度服务。页面上的第三方名称用于说明模型标识或客户端兼容性，不表示我们已取得其官方合作、经销或转售授权，本接入服务也不等同于直接购买官方订阅。

接入过程可能涉及协议适配、路由和字段转换，不能理解为请求与响应逐字不变地传递。上游账号、通道及供应商政策变化可能影响服务。需要官方直连、特定供应链证明或企业采购材料的，请在付款前确认是否能满足。

发现结果与说明不符

请保存请求时间、请求 ID、所选模型、Console 中的执行及计费标识，并联系管理员或客服核查。不要发送完整 API Key 或包含敏感信息的原始请求；必要示例请先脱敏。计费或交付有误时按退款与售后规则处理。

链动小铺自助充值

1. 登录 Console，进入「充值额度」页面
2. 选择 $30、$100 或 $500，跳转链动小铺完成下单
3. 付款完成后，在链动小铺订单中获取兑换码
4. 回到个人中心「兑换」页面，输入兑换码并提交
5. 看到兑换成功后，到余额页确认新额度和入账流水

人工自定义充值

1. 联系管理员或客服，说明充值金额和注册邮箱
2. 按客服确认的方式完成转账
3. 管理员核对收款后，在网站后台为对应账户增加额度
4. 用户回余额页确认到账；若金额不一致，立即联系管理员或客服核查

常见问题

情况	怎么办
付款后没有看到兑换码	先检查链动小铺订单详情，再携带订单截图联系管理员或客服
兑换码提示无效或已使用	不要重复尝试，提交订单号和提示截图给客服核查
兑换成功但余额未变化	刷新余额页；仍未到账时提供兑换时间和注册邮箱
需要非固定金额	联系管理员或客服人工自定义充值，不要拆分多笔错误档位

第 1 步:env 是否生效?

# 在你跑 claude / cursor 的同一个终端窗口里
echo $ANTHROPIC_BASE_URL
echo $ANTHROPIC_MODEL

正确输出:

https://api.handsfreeclub.com
gpt-5.6-terra

• 3 个都空 → 你 export 在了别的终端,或写错 ~/.zshrc 没 source
• BASE_URL 末尾不要带 /(https://api.handsfreeclub.com 不是 .../)
• 不要在截图或群聊中输出完整 AUTH_TOKEN；只在 Console 对照 Key 末 4 位

第 2 步:链路通不通?

curl -i https://api.handsfreeclub.com/v1/responses \
  -H "Authorization: Bearer $ANTHROPIC_AUTH_TOKEN" \
  -H "content-type: application/json" \
  -d '{"model":"gpt-5.6-terra","input":"Reply with OK only","max_output_tokens":8}'

看返回:

• 200 OK + JSON content → 链路通,问题在客户端配置
• 401 → key 错(对照第 1 步检查)
• 403 → Key 不属于 openai-default 或未开放 GPT-5.6
• 400 → 模型名或请求格式错误；不要使用裸 gpt-5.6
• 429 → 你被限流(等 1 分钟再试)
• 5xx → 上游故障,看 状态页
• curl: timeout → 网络不通(看下面 FAQ 17 服务区域与网络访问)

第 3 步:客户端读到了吗?

关键:新开一个终端窗口(老窗口 env 是旧的)。

• Claude Code:跑 claude --debug,看启动日志里 base_url 是不是我们的
• Cursor:Settings → Models → 看 Override Base URL 是不是 https://api.handsfreeclub.com/v1
• Cline / Continue:VS Code 命令面板搜 "settings",看插件配置里的 endpoint

还不行?

3 步都过了还跑不通,把以下信息发客服:

• 你的客户端 + 版本(Claude Code 1.x / Cursor 0.x)
• 第 2 步 curl 完整截图(注意挡住 sk-key 中间部分,只露末 4 位)
• 客户端报错原文截图

5-10 分钟客服远程指导。

相关错误码:AUTH01 · NET01 · REQ01

最简单:跑一键脚本

Mac / Linux 用户复制这一行:

bash <(curl -fsSL https://handsfreeclub.com/install.sh)

Windows 用户按 Win 键,输入 PowerShell,打开后复制这一行:

& ([scriptblock]::Create((irm https://handsfreeclub.com/install.ps1)))

脚本自动:检测系统 → 校验 Key 格式 → 探活 1 次 → 写好 Claude Code / Codex 配置 → 没装 Node 自动装 Node LTS → 装好 claude + codex 二进制。跑完新开终端,直接 claude 或 codex 启动即可。不希望脚本动你系统就加 --no-install-cli 或 Windows 的 -NoInstallCli(只写配置)。

Claude Code(Anthropic 协议使用 GPT-5.6)

claude
# 进去后:
/model sonnet

或写进 ~/.claude/settings.json 永久生效:

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.handsfreeclub.com",
    "ANTHROPIC_AUTH_TOKEN": "sk-你的key",
    "ANTHROPIC_MODEL": "gpt-5.6-terra",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "gpt-5.6-sol",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "gpt-5.6-terra",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "gpt-5.6-luna",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1"
  }
}

Cursor

设置 → Models → Anthropic API Key:

• 勾选 Override OpenAI Base URL
• Base URL: https://api.handsfreeclub.com/v1
• API Key: sk-你的key
• 模型:精确填写 gpt-5.6-terra（或 Sol / Luna，仅 openai-default）

Cline(VS Code 插件)

• API Provider: OpenAI Compatible
• Base URL: https://api.handsfreeclub.com/v1
• API Key: sk-你的key
• 模型:精确填写 gpt-5.6-terra（或 Sol / Luna）

Hermes Agent

在 ~/.hermes/config.yaml 注册 custom:handsfree，Base URL 使用 https://api.handsfreeclub.com/v1，api_mode 设为 chat_completions。查看完整教程。

OpenClaw

在 models.providers 注册 openai-responses provider，模型使用 handsfree/gpt-5.6-terra 形式。查看完整配置与安全边界。

OpenCode

在 opencode.json 中显式配置 @ai-sdk/openai、Base URL 与模型表；不能只靠环境变量自动接入。查看完整教程。

还不行?

报「无法连接」(代码 NET01)→ 走 FAQ 7 三步排查。Aider、Continue、Roo、Kilo、Zed、Cherry、Chatbox、Jan、OpenWebUI、LibreChat、NextChat、LobeHub、Open Interpreter 见 更多客户端专项页。

Aider(终端 AI pair programming)

read -rsp 'HandsfreeClub API Key: ' OPENAI_API_KEY; echo
export OPENAI_API_KEY
export OPENAI_API_BASE=https://api.handsfreeclub.com/v1
aider --model openai/gpt-5.6-terra

Continue(VS Code / JetBrains 插件)

在本机 Models 配置里使用 provider: openai、model: gpt-5.6-terra、apiBase: https://api.handsfreeclub.com/v1。Key 只放 Continue 本机 Secret / apiKey，不要提交到项目。完整 YAML 见 /docs/openai-compatible/。

Roo Code(VS Code 插件)

• 设置 → API Provider: OpenAI Compatible
• API Key: sk-你的key
• Base URL: https://api.handsfreeclub.com/v1
• Model: gpt-5.6-terra（也可精确选择 Sol / Luna）

Cherry Studio(桌面 GUI)

Provider 选 OpenAI Compatible，Base URL 填 https://api.handsfreeclub.com/v1，模型手动填 gpt-5.6-terra；Sol / Luna 同样可用。

Kilo Code / Zed / Chatbox / Jan / OpenWebUI

Kilo 选 OpenAI Compatible；Zed 在 AI 的 LLM Providers 里 Add Provider；Chatbox 选 OpenAI API Compatible；Jan 选 OpenAI-compatible；OpenWebUI 由管理员在 Connections 新增 OpenAI 连接。这五个都填带 /v1 的 Base URL，Key 放客户端凭据存储，再添加三个精确模型。

LibreChat(自托管)

需要在 librechat.yaml 配 baseURL 和模型表，Key 用 ${HFC_API_KEY} 从 .env 读取；Docker 还要挂载 YAML 并重启应用容器。不是在普通用户 Connections 页随手改一项。

NextChat / LobeHub(自托管)

NextChat 用部署变量 OPENAI_API_KEY、BASE_URL=https://api.handsfreeclub.com、CUSTOM_MODELS；注意它的 Base URL 不带 /v1。LobeHub 用 OPENAI_API_KEY、OPENAI_PROXY_URL=https://api.handsfreeclub.com/v1、OPENAI_MODEL_LIST。两者都要修改部署 Secret 后重新部署。

Open Interpreter

先通过隐藏输入设置 OPENAI_API_KEY，再用 interpreter --api_base https://api.handsfreeclub.com/v1 --model openai/gpt-5.6-terra。

n8n / Zapier / 自建 Agent 工作流

用 HTTP Request 节点调 POST https://api.handsfreeclub.com/v1/responses，模型填 gpt-5.6-terra。Key 必须放进 n8n / Zapier 的 Credentials 或 Secret Vault，再由 Authorization Bearer 凭据引用；不要把真实 Key 写进工作流正文、截图或导出文件。

还不行?

客户端不在上面?请把客户端名字和配置页截图发给管理员或客服,我们 5-10 分钟内告诉你怎么配 / 是否兼容。

模型对比

模型	速度	能力	适合
gpt-5.6-luna	快	轻量	短问题、补全、批量调用
gpt-5.6-terra	中等	主力	默认，日常工程任务
gpt-5.6-sol	中等	高难	大型重构、深度分析、复杂调试

怎么切换

Claude Code 里:

/model haiku      # 执行 gpt-5.6-luna
/model sonnet     # 执行 gpt-5.6-terra（默认）
/model opus       # 执行 gpt-5.6-sol

Cursor / Cline / Continue:在 OpenAI Compatible provider 中手动填写精确 GPT-5.6 ID；模型列表见 https://api.handsfreeclub.com/v1/models。

改 Claude Code 默认模型:export ANTHROPIC_MODEL="gpt-5.6-terra"，并同步设置 Opus / Sonnet / Haiku 三档角色变量。

什么时候用哪个

• Luna / Haiku 角色:跑测试 / 批量翻译 / 简单脚本生成 / 快速 Q&A
• Terra / Sonnet 角色(默认):日常写代码 / 改 bug / 解释 / 重构小模块
• Sol / Opus 角色:架构设计 / 跨大量文件分析 / 复杂调试

OpenAI / GPT 当前状态

• OpenAI Responses 已上线；GPT-5.6 仅限 openai-default，使用 Sol / Terra / Luna 三个精确档位。
• Gemini 2.5 Pro(用户呼声高再上)
• DeepSeek-R1 / Qwen3-Max(用户呼声高再上)

还不行?

/model xxx 报「模型不存在」(代码 REQ02 / MODEL01):

• 检查模型名拼写，必须是 gpt-5.6-sol / gpt-5.6-terra / gpt-5.6-luna 之一
• 裸 gpt-5.6 会返回 400；未授权分组返回 403
• 看到曾支持但现在不在的模型可能是上游已下线 — 请联系管理员或客服确认

发生了什么

额度按「请求次数」计,但一次任务在 Claude Code / Cursor 里其实包含多次请求:

• 你说「帮我改这个文件」→ AI 先读文件(1 次)→ 思考(1 次)→ 写代码(1 次)→ 运行测试(1 次)→ 修 bug(1 次)→ 共 5 次
• 复杂多文件改动 30-50 次很正常,这都是 AI 在帮你干活
• 余额页(/balance)显示累计请求次数,不是任务次数

你应该做什么

1. 打开 余额查询页 paste 你的 sk-key 看实时用量(7 天图表)
2. 看 7 天图表是否有异常突刺(被盗用 Key 的征兆),如有立刻去 FAQ 24 重置 Key
3. 想省额度:
   • 短问题用 gpt-5.6-luna
   • 日常任务用 gpt-5.6-terra(默认)
   • 大型重构用 gpt-5.6-sol
4. Token 计费原理见 FAQ 13(怎么省 token)

异常突刺怎么判断

正常	异常
白天 9:00-22:00 高,夜里低	夜里 2-5 点突然有大量调用
每天总量在 ±50% 范围波动	某天暴涨 5 倍以上
每次任务 5-50 次请求	持续 30 分钟单分钟 60 次撞限流

还不行?

把以下信息发客服:

• Key 末 4 位
• 当前用量 / 总额度
• 怀疑被多扣的时间段(精确到小时)
• 那段时间你在干什么

客服会结合调用和扣费记录核查；确认错误扣减的额度予以纠正或补回，不按个人原因退款扣除 50%。涉及实付款退款时，按退款政策处理。

相关错误码:BILL01 · BILL02

发生了什么

先按实际现象判断:

• 首字延迟 1-5 秒:正常,符合预期
• 首字延迟 5-15 秒:正常上限,正在排队
• 首字延迟 > 30 秒:异常,大概率上游某账号被限流

不要用 Claude alias 推断上游；Console 中的 upstream / billing model 才是实际身份。

你应该做什么

优先级从高到低:

1. 轻量任务切换到 gpt-5.6-luna；Claude Code 中用 /model haiku 切换对应角色
2. 检查本机网络 — ping api.handsfreeclub.com,> 200ms 建议更换网络，并确认所在网络区域受支持(详见 FAQ 17 服务区域与网络访问)
3. 看 实时状态页 — 状态页只反映已监测到的情况，全绿仍可能存在个别通道或请求异常
4. 保留错误码和时间戳，便于判断模型、网络还是上游问题
5. 判断锅在哪 — 看 FAQ 18 是你们的问题还是上游?

还不行?

状态页全绿但你这边持续慢 > 5 分钟:

• 发给管理员或客服:Key 末 4 位 + traceroute api.handsfreeclub.com 截图 + 你跑的具体命令
• 客服以 30 分钟内首次回复为响应目标；如已有明确服务约定，按该约定处理

相关错误码:SVR05 · RL01 · STREAM02

Token 怎么数

• 英文:1 word ≈ 1 token,标点 + 空格也算
• 中文:1 字 ≈ 1.5-2 tokens(古文 / 生僻字更多)
• 代码:每行 ≈ 5-15 tokens(取决于变量名 / 缩进 / 复杂度)
• example:5000 行 markdown ≈ 80,000-150,000 tokens

额度计费

维度	当前规则
余额单位	站内调用计费额度（界面以 USD / $ 标示），不能提现或兑换美元；退款按订单对应实付金额计算
固定档位	$30 / $100 / $500
扣费规则	按余额页当前展示的模型价格与实际 usage 扣费
自定义金额	联系管理员或客服人工充值，由管理员核对后入账
核对方式	以 Console 的余额和扣费流水为准

怎么省 token

1. 批量提问:5 个相关问题合并成 1 个 prompt
2. 关闭非必要工具:Claude Code 里 CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1 关掉 telemetry
3. 明确任务边界:「读这个文件 → 改 X 函数 → 跑测试」一次说清,避免 AI 来回 ping pong
4. 用 /clear 切话题:换任务前 clear,避免拖着旧 context 反复发
5. 用好 Prompt Caching(下一条 FAQ)

还不行?

觉得用量明显比预期高:

• 看 余额页 7 天分布,锁定哪天 / 哪小时暴涨
• 那天具体在跑什么任务?发客服判断是否正常
• 怀疑被多扣 → 走 FAQ 11

缓存怎么生效

• Anthropic 原生:client 在 system 或 messages 块加 cache_control: {"type":"ephemeral"} 标记
• OpenAI 原生:GPT-5.6 Terra / 4.x 自动缓存 ≥1024 token 的 prefix,无需标记
• 缓存阈值、有效期和计价可能随模型及价格 revision 变化，以当前上游响应为准

能省多少

没有跨模型统一答案。请按 request_id 对比 cache token、价格 revision/hash、账户有效倍率与最终费用；不要用旧公开单价或 Claude alias 手算。

客户端默认配置

• 不同客户端与版本的缓存行为不同；升级客户端不能保证命中
• GPT-5.6 的实际缓存结果看 OpenAI usage 字段，Claude-native 看 Anthropic usage 字段

怎么验证命中了

1. 看响应 usage.cache_read_input_tokens(Anthropic)或 usage.prompt_tokens_details.cached_tokens(OpenAI)字段 > 0
2. 用 Console 的 request_id 明细核对实际执行模型、cached tokens、价格快照和费用
3. 没命中?多半是 prompt 前缀变了(每次都加时间戳 / 随机 ID 会破坏缓存)

还不行?

明显该命中却没命中,把请求 ID 发客服,我们查上游缓存状态。

限流规则

维度	阈值	触发后
每分钟请求数	60 req/min	429 + Retry-After header
瞬时突发	20 req(令牌桶)	429,等令牌恢复
单调用 input	200K tokens	413 Payload Too Large
单调用 output	8K tokens	响应被截断 + stop_reason: max_tokens

我们做了什么自动重试

• 客户端层:Claude Code / Cursor 等内置 3 次指数退避(1s / 2s / 4s)
• 我们的中转层:撞上游限流 → 自动重试或切换可用通道(对你完全透明)
• 客户感知:你看到的 429 只在「连续 3 次重试都失败」后才返回

你应该做什么

1. 看到 429 → 等 30-60 秒再发(客户端通常会自动 retry,你也可以手动重发)
2. 如果是批量调用(脚本一次发 100 个) → 在你的脚本里加 sleep 1 让 QPS 控制在 1/秒
3. 持续撞 429 → 降低并发和单请求 token；不要依赖切换 alias 绕过限流
4. 常态高频用户 → 联系管理员或客服申请升级配额

还不行?

• 持续超 5 分钟 429 → 联系管理员或客服并提供 Key 末 4 位 + 触发时间
• 客服核查实际限流原因和可用容量；是否调整配额或通道需按当前服务条件确认

相关错误码:RL01 · RL02

什么是流式输出

Anthropic 协议默认流式(stream: true):AI 边生成边发回,你看到字一个个蹦出来。优点:首字延迟低、可中断。

常见中断原因

现象	原因	怎么办
生成到一半突然停	客户端连接被网络中断(WiFi 或网络切换)	重发,Claude Code 会接着写
第一个字出来后断	上游通道在你说话期间被限流或连接抖动	我们自动重试或切换通道,你重发 1 次
大段输出 30s 后断	nginx 连接超时(默认 60s 心跳)	我们已加心跳,如重现告诉我们
固定在某个字断	你的网关 / 防火墙过滤特定字符 (罕见)	更换受支持网络测试

你应该做什么

1. 先重发 — 客户端通常自动 retry,实在不行手动重发
2. 检查网络稳定性 — ping api.handsfreeclub.com 持续 30 秒,看丢包率
3. 关流式试试(只在调试时用) — 大多数客户端不直接暴露,可以告诉客服切非流式渠道排查
4. 切 haiku — 短输出更不易断

还不行?

1 小时内多次中断 → 联系管理员或客服:

• Key 末 4 位
• 中断时间(精确到分钟)
• 客户端 + 网络环境(WiFi / 移动网络 / 企业网络)
• 系统识别的网络来源国家或地区

相关错误码:STREAM01 · STREAM02 · NET02

错误码 8 大类

前缀	含义	责任	动作
AUTH	Key 鉴权	通常你	检查 Key 完整 / 有效 / 未过期
RL	限流	上游高峰	等 30-60 秒或换 haiku
SVR	服务端故障	我们	已自动重试,看状态页
REQ	请求格式	通常你	模型名 / 参数范围
BILL	计费 / 额度	通常你	余额页 + 充值
STREAM	流式中断	网络	重发或关流式
MODEL	模型限制	通常你	max_tokens / 模型已下线
NET	网络层	本地	检查 BASE_URL 拼写

常见错误 Top 6 速查

代码	触发	解
AUTH01	key 错或过期	检查 sk- 开头 + 完整复制;dashboard 验证
AUTH02	key 被作废(泄露)	找客服重新发(FAQ 24)
RL01	每分钟超 60 次	等 1 分钟(FAQ 14)
SVR04	上游 5xx	等 30s 重试,持续 2 分钟找客服
NET01	无法连接	BASE_URL 拼写 + ping
REQ02	模型名错	4-6 不是 4.6

找客服必带 4 项

我的 Key 末 4 位 abcd
报错代码 AUTH01
完整报错截图(整个红字面板)
我刚才在干什么(关键!)

这些信息有助于客服缩小问题范围。处理时长依问题而异；发送截图前请遮挡完整 Key、密码及无关个人资料。

还不行?

错误码不在表里时，请发送已脱敏的报错截图或文字，客服协助核查。

第 1 步:确认服务区域

• 访问资格以每次请求的网络来源地区为准，不按语言、国籍或设备判断
• 香港、澳门、台湾及其他明确识别为非中国大陆的地区按正常规则提供服务
• 无法识别来源地区的网络可能被拒绝，以保护访问边界

第 2 步:基础连通性

# 测延迟
ping api.handsfreeclub.com
# 记录延迟和丢包率

# 测 DNS
nslookup api.handsfreeclub.com
# 应返回 Cloudflare 代理地址

第 3 步:HTTPS 通不通

curl -v https://api.handsfreeclub.com/v1/models
# 看是否能拿到 JSON 模型列表
# 卡在 SSL handshake → 中间网关有 TLS 拦截
# 401 → 通了,只是没带 key,正常

不通常见原因 + 解

现象	原因	解
HTTP 403 地区限制	当前网络来源地区不在服务范围，或来源地区无法识别	该网络不可使用本服务；如判断有误，提交请求 ID 给客服复核
DNS 解析失败	本地 DNS 缓存 / 公司 DNS 拦截	切 1.1.1.1 / 8.8.8.8;手机热点测试对比
ping 通但 https 不通	公司网关 SSL 检测	问 IT 加白名单 *.handsfreeclub.com,或换网络
延迟 > 500ms	网络绕路 / 高峰	更换受支持网络并对比

地区判断有误?

请记录被拒绝页面或 API 响应中的请求 ID、发生时间和系统识别的国家或地区，联系管理员或客服复核。我们不会提供规避地区限制的网络配置指导。

还不行?

把以下信息发客服:

• traceroute api.handsfreeclub.com 截图(macOS / Linux)或 tracert(Windows)
• 所在国家或地区 + 网络服务商
• 是否在企业、学校或公共网络

客服收到信息后排查服务状态或地区识别问题；处理时长依排查情况而异，不提供绕过地区限制的替代入口。

相关错误码:NET01 · NET02 · NET03

5 分钟自检流程

1. 看我们的实时状态:https://status.handsfreeclub.com
   • 全绿 → 监测项未报告异常，仍需核对具体请求
   • 有异常 → 查看公告，并保留受影响请求记录
2. 看 OpenAI 官方:https://status.openai.com
   • 有异常 → 可能影响相关模型，需结合本服务通道情况核查
   • 全绿 → 不能排除局部或尚未报告的上游故障
3. curl 直测我们端点:

   curl -i https://api.handsfreeclub.com/v1/responses \
     -H "Authorization: Bearer $OPENAI_API_KEY" \
     -H "content-type: application/json" \
     -d '{"model":"gpt-5.6-terra","input":"Reply with OK only","max_output_tokens":8}'

   • 200 OK → 这次测试成功，可继续检查原始请求及客户端差异
   • 5xx → 我们或上游(对照状态页判断)
   • 429 → 你被限流
   • 403 → Key 未开放 GPT-5.6 或不属于 openai-default
   • 400 → 模型名或请求格式错误
   • 401 → key 错

常见组合

状态页	curl	结论
全绿	200	该次测试成功；原始故障仍需核查
全绿	5xx	可能存在未报告的服务或上游异常，保留请求记录
我们红	5xx	我们的问题,看公告 ETR
Anthropic 红	5xx	相关上游可能异常，需核对实际使用通道
全绿	timeout	客户端、网络、本服务或上游均可能导致超时

我们的承诺

• 已确认的服务异常通过 status page 或客服沟通进度；监测和公告可能存在延迟
• 连续 30 分钟不可用 → 按实际影响提供额度补偿，或按我方原因退款规则处理；已有订单保留购买时承诺
• 上游故障时核查受影响范围及可用处理方式；备用通道并非始终可用

还不行?

判断不出哪一边，请联系管理员或客服并带上面 3 个截图,我们当场对账。

退款规则

情形	处理方式
我方原因：例如主路径连续不可用 ≥30 分钟、服务下线，或确认由我方造成的交付问题	退还未使用额度对应实付金额的全额；涉及未交付、错误扣费的另行纠正，不能仅以当前剩余额度限制应退金额
个人原因：服务符合约定，但用户改变使用计划、偏好或不再需要	退还未使用额度对应实付金额的 50%
错误扣费、未交付及依法应退	核实后纠正、补交付或办理相应退款，不按个人原因扣除 50%，不影响依法享有的权利

页面显示的 USD / $ 是站内调用计费额度，不能提现或兑换美元。退款按相关订单实际支付金额与未使用比例换算，不按标示的 $ 数额兑付美元。例如某订单实付 ¥100，尚有 20% 对应额度未使用：我方原因退 ¥20，个人原因退 ¥10；错误扣费及依法应退等情形另行核算。

已有订单权益

本次更新不追溯减少已有订单的退款、补偿或其他承诺。如果购买时适用的页面或订单曾承诺“购买后 7 日内，因我方原因全额退款，包括已使用部分”，或约定了其他期限、金额和条件，仍按当时适用承诺处理。请保留订单及购买时页面记录；客服同时核查历史记录。本段仅保留历史权益，不为今后订单新增 7 日或 30 日期限。

怎么申请

1. 联系 support@handsfreeclub.com 或页面公布的管理员/客服，提供订单号、付款日期、付款金额、付款渠道及退款原因；请遮挡无关账户资料，不要发送密码或完整 Key。
2. 客服以 30 分钟内首次回复为响应目标，核实订单、用量及退款原因；已有订单另有明确时效承诺的按原约定处理。
3. 退款资料及金额核实后，在 1–3 个工作日内按原支付渠道办理退款；实际到账时间可能受支付机构处理时间影响。
4. 办理前确认应退金额及相应额度处理。仅咨询或申请退款不会自动停用全部 Key；已退款对应额度不再继续使用。确需调整或停用服务时，客服会说明具体范围。

卡顿或故障怎样判定

不能仅凭“觉得卡”、本地网络报错或状态页全绿，就自动按个人原因处理。客服应结合请求时间、错误码、服务与上游状态和实际交付情况核查；争议未清楚前不直接扣除 50%。

• 我方或上游通道问题造成服务未按约提供，应结合影响及购买时承诺处理。
• 扣错额度、给错档位或付款后未交付，应先核对并纠正，不适用个人原因半退。
• 如对判定有异议，请说明争议及依据，客服进一步复核；本政策不排除适用法律规定的消费者权利。

详细规则：退款政策 · 服务条款

自助追加

1. 进入充值页面，选择 $30、$100 或 $500
2. 在链动小铺完成付款并获取兑换码
3. 回个人中心兑换，确认余额增加

自定义金额

需要固定档位以外的金额时，联系管理员或客服，提供注册邮箱和充值金额。管理员核对转账后在后台入账，请在余额页核对最终结果。

• 下单前请核对档位、付款金额和到账额度
• 页面价格发生变化时，只影响之后的新订单
• 人工自定义充值以客服确认的金额和到账额度为准
• 对订单或入账有疑问时，提交订单号、注册邮箱和余额截图核查

发票与付款凭证

如需发票或报销凭证，请在下单前联系客服，确认可提供的凭证类型、出具方及所需资料。

如有增值税普通发票或专用发票等具体要求，请先确认是否能够提供，再决定购买。

付款与历史订单

• 付款前，请核对订单页面显示的收款人、金额和支付渠道。
• 历史订单的收款及凭证安排，以购买时的订单和付款记录为准；如需查询，请提供订单号联系客服。

共用单 Key 的问题

• 限流互踩:同时 3 人发请求,60 req/min 限流共享,容易撞 RL01
• 账目不清:谁用了多少看不到,内部对账难
• 泄露风险放大:任何一人电脑丢了 / 离职没回收,全员的 Key 都得换
• 额度消耗难归因:多人共用同一余额池时,很难独立核算每个人的实际用量

当前阶段方案

方案 A:每人各自注册(推荐 ≤ 3 人)

• 每人分别购买所需的固定额度，各自按公司流程报销
• 规模 ≤ 2 人或不需要管理视角
• 缺点:对账靠每人提供

方案 B(过渡):暂时共用(只适合 ≤ 2 人 / 临时项目)

• 按团队预计用量充值，额度不足时继续按需充值
• 注意:务必只在受信任同事之间
• 限流大概率撞,做好心理准备

团队额度包(规划中,Phase 2 上线)

• 1 个主 Key(管理员)+ N 个副 Key(团队成员各 1 个)
• 主 Key 后台能看每个副 Key 用量、独立设上限、随时禁用某个
• 所有副 Key 共享主 Key 的总额度池
• 团队方案按实际用量和所需并发评估，请联系管理员或客服确认
• 感兴趣的请提前联系管理员或客服，功能上线后优先通知

企业方案(≥ 10 人 / 跨地域)

• 联系管理员或客服开 定制方案:
  • 企业域邮箱登录 / SAML SSO
  • 按部门 / 项目分组的额度池
  • 专属客户成功经理 + 1 小时响应
• 价格视规模,≥ ¥2000 / 月起,签年度合同打 8 折

还不行?

团队场景特殊(跨国 / 多分公司 / 需 SOC2)，请联系管理员或客服详谈，我们会明确当前能提供的范围。

相关错误码:RL01(共用导致限流)

常见泄露场景

• Key 写到 GitHub 公开仓库被爬走(GitHub Secret Scanning 会通知,但已被爬到)
• 截图发群忘记打码
• 共用电脑没退账号
• 钓鱼邮件 / 钓鱼网站骗你输 Key
• 公共 WiFi 被中间人攻击(罕见,因为是 HTTPS)

泄露的征兆

看 余额页 7 天图表:

• 夜里突然有异常用量(凌晨 2-5 点你没在工作但有大量请求)
• 陌生 IP 段(我们后台日志可查,客服能告诉你来源国)
• 额度断崖下跌(几小时跑掉 50% 以上)

应急流程(分钟级)

1. 立刻联系管理员或客服:报「Key 泄露」+ 注册邮箱，并按要求完成身份验证
2. 客服完成身份核验后处理:
   • 找到你的 user
   • 旧 sk-key 状态改 revoked(立即生效,旧 key 调用立即返 401)
   • 同 user 创建新 sk-key(余额 / validity 不变)
3. 客服通过确认的安全渠道发送新 sk-key
4. 系统自动发事务邮件「您的 API Key 已重置」到 user.email(防止恶意操作)
5. 你改客户端 settings.json / env 里的 key,重启即恢复
6. 如确认有被盗用扣量,告诉客服时间段 + 你那段时间在哪 / 在干什么(证明不是你)→ 后台调日志确认非本人 IP / 异常 pattern,被盗用部分全额退回额度

预防(永远胜于补救)

• 永远不要把 Key 提交到 git。用 .env + .gitignore,或者用 direnv
• 截图应遮住完整 Key；联系客服定位问题时仅保留末 4 位
• 每月在 余额页扫一眼图表,看有没有突刺
• 开启余额预警邮件(默认在已用额度达到 75% / 90% / 100% 时自动提醒)
• 如多人共用想分账,等 [团队额度包](#faq-23)(Phase 2 上线)

还不行?

怀疑严重盗刷(已经掉 80% 以上余额):

• 向客服明确说明疑似盗用及影响范围，申请优先处理
• 同步给 Ethan(创始人)亲自跟进
• 必要时配合你提供 IP 取证(报警材料)

相关错误码:AUTH01 · AUTH02

哪些信息可能被处理

• 账户与交易：注册及联系信息、订单、付款或兑换记录，用于账户管理、交付、计费、退款与客服。
• 模型请求：输入文字、上传内容、上下文和响应需要在本服务与相关上游之间处理；上游的数据使用和保存规则需按实际接入通道另行核对。
• 运行与排错：请求时间、模型标识、用量、状态、网络及故障信息等可能进入日志；部分故障记录可能包含内容。

HTTPS 保护传输过程，并不意味着本服务或上游无法处理明文内容。完整数据流、保存期限和删除机制仍需按实际系统逐项核实，本页不作统一 30 天删除或绝无泄露的保证。具体说明及查阅、更正请求渠道见隐私说明。

公司信息与相关说明

项	当前说明	备注 / 后续安排
ICP 备案	当前未展示备案信息	适用服务地区见FAQ 17；境外部署不等同于所有合规要求已满足
公司注册	同頻數字有限公司 Resonance Digital Limited	2026 年 9 月 30 日在香港成立
服务条款	查看服务条款	下单前阅读；既有订单按适用约定处理
隐私说明	查看隐私说明	提交个人资料或模型请求前阅读
企业数据要求	本页不构成 SOC2、GDPR 或 HIPAA 等认证或合规证明	需要专项材料或协议，请先确认能否提供

提交内容前请确认

• 只提交你有权处理和传送的内容，涉及他人或商业敏感信息时先取得必要权限并脱敏。
• 不要提交完整密码、API Key、私钥、支付凭据或不必要的身份资料。
• 如果业务必须满足特定保密、数据所在地、删除期限或审计要求，请在购买及上传前联系客服确认；未确认前不要上传此类数据。

NDA / DPA 与隐私请求

如需保密协议、数据处理协议或具体数据处理说明，请联系 support@handsfreeclub.com，在下单前确认可提供的范围和条款。本页不承诺所有客户均已获相应协议；已经签署的书面协议按其约定执行。

提出数据查阅、更正或删除请求时，请提供注册邮箱和请求事项，不要通过公开群聊发送敏感资料。我们会核实身份及请求范围；能够处理的范围和需要依法保留的记录应在回复中说明。