常见问题

价格对比(¥99 基础包举例)

稳定性怎么保证

• 多号轮询:同时 1 主力 200x Pro + 6 副 Plus,单号被限流自动切下一个,客户感觉不到
• 健康检查:每 60 秒探活全部上游,死号自动下线 24 小时冷却
• 断点续流:网络抖动客户端重发,我们智能去重,不双扣
• 透明监控:status.handsfreeclub.com 公开实时状态
• SLA 承诺:连续 30 分钟不可用 → 主动补 1 天时长(故障补偿)

什么时候建议直接用官方

• 企业有 SOC2 / BAA / GDPR 等合规硬要求,我们当前提供不了正式合规协议
• 需要超大单次额度(单天 > $500),我们没准备这么多 Pro 号
• 需要 Anthropic 销售直接对接(SO 价、专属客户成功)

还不行?

价格 / 稳定性细节疑问,微信问客服 aa402837(昵称 Donish),我们直接给你看 status page 30 天历史可用率。

差异点对比

什么时候选我们

• 主用 Claude Code / Cursor / Cline 写代码,不用复杂 SDK
• 价格敏感但不接受「拼车 / 共享号 / 抢号」
• 需要中文客服 + 微信沟通(不想发工单等 24 小时)
• 个人 / 小团队(3 人以内),不需要 SAML / SSO 等企业功能

什么时候选大平台

• 需要 OpenAI / Gemini / DeepSeek 等多家模型混用(我们 Phase 1 只支持 Anthropic)
• 企业 ≥ 10 人 + 需要 SSO / SAML / 部门额度池
• 需要正式国内增值税发票 + 对公转账

还不行?

对比某家具体平台,微信告诉我们,我们给你拉一份逐条对比表(诚实版,该输的我们认)。

行业现实(我们诚实告诉你)

这两年中转跑路确实不少,主要原因:

• 独立站长一人作战,断号 / 政策变 / 个人原因都可能停服
• 预收年费 → 急用钱跑了
• 违规拉客 / 拼车被官方封 → 链路彻底断

我们做了哪些保险

1. 团队实名:3 人小团队,Ethan(创始人,与 Mark 共同负责技术)+ Mark(联合技术)+ 1 客服,微信加好友能看到真人朋友圈
2. 微信渠道:加 aa402837(昵称 Donish),24 小时回复(深夜也回),不会人间蒸发
3. 不卖超大额年卡:Phase 1 主推月度额度包(¥99 / ¥299),年度包 ¥2999 仅老客户复购,降低单次预收
4. 30 天滚动退款:任何时间想退,按余量计算(我方原因全额 / 主观不满意半退),原路返还
5. 预案透明:我们公开承诺如服务下线,主动按余量全额退,不让你追讨

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

1. 先买 ¥9.9 体验包跑通,验证客服响应速度 + 实际能用
2. 感觉 OK 再升 ¥99,不要一上来就买 ¥2999 年度包
3. 每周看一眼 status page,有连续 1 天异常的迹象提前找客服
4. 重要项目同时备一个官方账号或第二家中转作 fallback,不把所有鸡蛋放一个篮子

还不行?

对我们团队还有疑虑,微信加客服直接视频通话 / 加创始人本人 / 看历史用户群运营记录,信任建立是双向的,我们欢迎尽调。

什么是「倍率」

大多数 token 计费的中转(OpenRouter / 灵芽 等)按官方 token 价 × 倍率收钱:

• 1.0x:跟官方一样,主要做合规 / 国内付款便利
• 0.7-0.9x:批量优惠 + 部分让利,合理
• 0.5x 以下:开始可疑(可能是 GLM / Qwen 假装)
• 0.3x 以下:行业默认 = 逆向接口(反代 Cursor / Kiro / Copilot 内部接口)

我们的两套计费

Plan 1 — 包月套餐(LIANDONG 已上架 4 档):

• 付月费 → 锁定 USD 配额(¥29.9 / $100、¥299 / $1,500、¥450 / $3,000、¥899 / $15,000)
• 按官方 token 价 1× 扣 USD 配额,有日 cap(¥299 档 $50/日)防跑飞
• 未用完半年内有效,不清零
• 适合:用量稳定可预测的人

Plan 2 — 按量充值:

• 1 元 RMB = $1 配额(1:1,与包月同口径)
• 按官方 token × 渠道倍率扣:GPT 0.3×(Codex / Cursor)/ Claude 1.7×(Claude Code / Cline)/ Antigravity 0.7× / Kiro 0.3×
• 默认 $50/日 cap 可微信申请关闭
• 适合:用量波动 / 试用 / 灵活切渠道

GPT 0.3 倍率为啥不是逆向

• 多账号池批发拼组摊销 token 单价(企业 API 阶梯返利 + 多区域 ChatGPT Team)
• 官方原生 Prompt Caching 复用(命中后输入费用降至 1/10,Codex 类长 context 任务尤其省)
• 跑 OpenAI 官方 /v1 接口,不是反代 Cursor / Copilot 等客户端内部接口
• 响应 X-OpenAI-* response header 直透传,有 openai-organization 字段(逆向接口给不出)

为啥 Claude 比 GPT 贵这么多

• Anthropic 国内 KYC 政策严,账号成本高(每号要 KYC + 防封措施)
• 1.7× 倍率仍是官方价约 24%(按 ¥7.2/$ 折算,等于打约 2.4 折)
• 反重力 0.7×、Kiro 0.3× 是新上的低价渠道,适合成本敏感和轻量场景
• 对比同行高质量 Claude 分组(PackyCode CC / CloseAI):1.7× 低于常见 2.0× 水位,也优于应急 2.5× 分组

怎么验证我们没掺水

1. 长 context:发 5000 行 markdown 让 AI 总结 — 假 Claude / GPT 撑不到 200K context
2. 自家术语:问 Claude「Constitutional AI 是啥」,问 GPT「GPT-5.5 vs 5.4 区别」— GLM / Qwen 答不来
3. 看返回的 X-Anthropic-* / X-OpenAI-* response header(我们直透传)
4. 对照 Anthropic / OpenAI 官方文档校验响应格式

还不行?

怀疑掺水,微信发疑点截图,我们当场跟你的官方账号比对一次,证明输入输出完全一致。

相关:怎么选包月还是按量 · 缓存怎么算

4 句话决策

同样花 ¥299 能买多少官方调用量

按量新渠道:反重力 0.7× 约 $427 调用,Kiro 0.3× 约 $996 调用。

→ 用量到一定程度,包月几乎永远比按量划算(代价是有日 cap + 月度上限)。按量优势在灵活,以及 GPT 重度用户(0.3× 倍率比包月 1× 还便宜)。

切换

包月用完后剩余配额半年保留,期间也可以叠加充值进按量余额(同一 sk-key 双 Plan 共存)。

三档怎么选

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

可以。注册时选「按量充值」分组,最低 ¥10 起,余额半年保留。不用买月度套餐、不用承诺最低消费。生 100 张 2K 就充 ¥10,Console 显示余额、生一张扣一张。

失败会扣费吗

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

图生图 / variations 什么时候开?

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

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

行业里「降智」怎么发生的

常见 3 种降智手段(我们都不做):

• 模型替换:你以为在用 Claude Sonnet,实际后台路由到 GLM-4 / Qwen / DeepSeek(便宜很多)
• 上下文截断:你以为有 200K context,实际服务端偷偷裁到 8K(省成本)
• System prompt 注入:服务端在你不知道的情况下加 "回答简短一些" 等限制(节省 output token)

怎么自己验证

1. 挑战 1 — 长 context:发一段 5000 行的 markdown 让模型总结(GLM 撑不住)
2. 挑战 2 — 自家术语:问「Constitutional AI 是什么 / 为什么 Claude 用」(只有 Claude 会用 Anthropic 自家术语解释)
3. 挑战 3 — 模型自报家门:发「你是哪个模型?给我精确版本号」
   我们透传,Claude 会真实说「Claude Sonnet 4.6 by Anthropic」
   掺水中转可能说「我是一个 AI 助手」(不敢说名字)
4. 挑战 4 — Tool Use:发一个标准 Anthropic tools 字段调用,看 tool_use 块格式是否完全合规
5. 挑战 5 — 看 response header:curl -i 调用,看是否有 anthropic-ratelimit-* 字段(我们透传上游 header)

我们的承诺

• 所有请求原封不动转发给 Anthropic Pro / Plus 真实订阅,不改任何字段
• 响应也原封不动转回客户端,不删 / 不改 / 不裁 token
• 我们没有「省钱模式」「fast 模式」「降智档位」(这种通常就是掺水)
• 我们不是「2API 渠道」(逆向 ChatGPT 网页版),是真的订阅 + 真的 API 链路

还不行?

跑挑战 1-5 你怀疑结果不对,微信发结果给客服,我们当场对照官方调一次给你看,证明完全一致。

完整流程(5 分钟)

1. 加客服微信 aa402837(昵称 Donish),自动回复展示 4 档定价
2. 回复想要的档位,客服发微信 / 支付宝收款码
3. 付款时备注:`档位简称 + 邮箱`,比如 `基础 zhang@gmail.com`
4. 客服看到到账(微信支付宝即时通知),进后台:
   • 建 / 找 user(用你的邮箱)
   • assign 对应档位的 group
   • 设 validity(今天 + 30/365 天)
   • 创建 sk-key(sk- 开头,sub2api 实际颁发格式)
5. 客服微信发给你:API Base + sk-key + 模型名 + 有效期 + CUSTOMER_GUIDE 链接

常见情况处理

Phase 2(¥5k 流水后)会变什么

切换到链动小铺平台 + 兑换码自助:

• 链动小铺下单 → 微信领 16 位兑换码 → handsfreeclub.com/redeem 自助激活 → portal 拿 sk-key
• 客服工时从 5 分钟/单 降到 2 分钟/单
• 支持平台开个人服务发票(电子)

还不行?

付款后 30 分钟没收到 key,微信发客服:

• 付款时间(精确到分钟)
• 付款金额 + 渠道(微信 / 支付宝)
• 付款单号(微信账单 / 支付宝账单可复制)
• 邮箱(已经在备注里也再发一遍)

5 分钟内人工补单。逾期或不满意按 [退款政策](#faq-19) 处理。

第 1 步:env 是否生效?

# 在你跑 claude / cursor 的同一个终端窗口里
echo $ANTHROPIC_BASE_URL
echo $ANTHROPIC_AUTH_TOKEN | head -c 20
echo $ANTHROPIC_MODEL

正确输出:

https://router.handsfreeclub.com
sk-xxxxx
claude-sonnet-4-6

• 3 个都空 → 你 export 在了别的终端,或写错 ~/.zshrc 没 source
• BASE_URL 末尾不要带 /(https://router.handsfreeclub.com 不是 .../)
• AUTH_TOKEN 必须 sk- 开头(sub2api 颁发的实际格式),复制时务必完整,少 1 个字 401

第 2 步:链路通不通?

curl -i https://router.handsfreeclub.com/v1/messages \
  -H "x-api-key: $ANTHROPIC_AUTH_TOKEN" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{"model":"claude-haiku-4-5","max_tokens":50,"messages":[{"role":"user","content":"hi"}]}'

看返回:

• 200 OK + JSON content → 链路通,问题在客户端配置
• 401 → key 错(对照第 1 步检查)
• 429 → 你被限流(等 1 分钟再试)
• 5xx → 上游故障,看 状态页
• curl: timeout → 网络不通(看下面 FAQ 17 跨境网络)

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

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

• Claude Code:跑 claude --debug,看启动日志里 base_url 是不是我们的
• Cursor:Settings → Models → 看 Override Base URL 是不是 https://router.handsfreeclub.com
• 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 用户复制这一行:

curl -fsSL https://handsfreeclub.com/install.sh | bash -s -- --key sk-你的key

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

$env:HFC_KEY="sk-你的key"; irm https://handsfreeclub.com/install.ps1 | iex

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

Claude Code(官方 CLI · 最推荐)

claude
# 进去后:
/model claude-sonnet-4-6

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

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://router.handsfreeclub.com",
    "ANTHROPIC_AUTH_TOKEN": "sk-你的key",
    "ANTHROPIC_MODEL": "claude-sonnet-4-6",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1"
  }
}

Cursor

设置 → Models → Anthropic API Key:

• 勾选 Override OpenAI Base URL
• Base URL: https://router.handsfreeclub.com
• API Key: sk-你的key

Cline(VS Code 插件)

• API Provider: Anthropic
• Anthropic Base URL: https://router.handsfreeclub.com
• API Key: sk-你的key

Antigravity / 通用 Anthropic 客户端

• Base URL / Endpoint:https://router.handsfreeclub.com
• API Key:sk-你的key
• 协议:Anthropic Messages API(/v1/messages)
• 按量充值倍率:0.7×
• 注意客户端的「test connection」按钮可能因为它在 ping /v1/models(我们也支持)

Kiro

• Base URL / Endpoint:https://router.handsfreeclub.com
• API Key:sk-你的key
• 协议:Anthropic Messages API(/v1/messages)
• 按量充值倍率:0.3×

还不行?

报「无法连接」(代码 NET01)→ 走 FAQ 7 三步排查。其他客户端见 FAQ 9。

Aider(终端 AI pair programming)

export ANTHROPIC_API_KEY=sk-你的key
export ANTHROPIC_API_BASE=https://router.handsfreeclub.com
aider --model anthropic/claude-sonnet-4-6

Continue(VS Code / JetBrains 插件)

编辑 ~/.continue/config.json:

{
  "models": [{
    "title": "Claude Sonnet (HFC)",
    "provider": "anthropic",
    "model": "claude-sonnet-4-6",
    "apiKey": "sk-你的key",
    "apiBase": "https://router.handsfreeclub.com"
  }]
}

Roo Code(Claude Code fork,VS Code 插件)

• 设置 → API Provider: Anthropic
• API Key: sk-你的key
• Base URL: https://router.handsfreeclub.com

Cherry Studio(桌面 GUI)

等 Phase 2(OpenAI 协议适配)上线再用。当前用 Cherry Studio 只能配 Anthropic provider 部分功能。

Open-WebUI / LibreChat / NextChat

在 Connections / Provider 里选 Anthropic,填 Base URL + sk-key。这类 OpenWebUI 系工具部分版本写死了 OpenAI 协议,Phase 2 之前不一定可用。

n8n / Zapier / 自建 Agent 工作流

用 HTTP Request 节点直接调 POST https://router.handsfreeclub.com/v1/messages,headers:

x-api-key: sk-你的key
anthropic-version: 2023-06-01
content-type: application/json

还不行?

客户端不在上面?微信告诉客服客户端名字 + 截图配置页,我们 5-10 分钟内告诉你怎么配 / 是否兼容。

模型对比

怎么切换

Claude Code 里:

/model claude-haiku-4-5     # 快
/model claude-sonnet-4-6    # 默认
/model claude-opus-4-7      # 强

Cursor / Cline / Continue:客户端的「模型选择」下拉里直接选,我们在 https://router.handsfreeclub.com/v1/models 暴露了模型列表。

改默认模型:~/.zshrc 里 export ANTHROPIC_MODEL="claude-sonnet-4-6",改这一行。

什么时候用哪个

• haiku:跑测试 / 批量翻译 / 简单脚本生成 / 快速 Q&A
• sonnet(默认):日常写代码 / 改 bug / 解释 / 重构小模块
• opus:架构设计 / 跨大量文件分析 / 复杂调试 / 需要深度推理

Phase 2 计划加什么

• OpenAI 协议:GPT-5 / GPT-5-mini / GPT-5-fast(等 OpenAI 协议适配)
• Gemini 2.5 Pro(用户呼声高再上)
• DeepSeek-R1 / Qwen3-Max(用户呼声高再上)

还不行?

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

• 检查模型名拼写,是 4-6 不是 4.6(短横线不是小数点)
• 看到曾支持但现在不在的模型可能是上游已下线 — 微信问客服

发生了什么

额度按「请求次数」计,但一次任务在 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. 想省额度:
   • 短问题用 claude-haiku-4-5(消耗一样,但更快)
   • 复杂任务用 claude-sonnet-4-6(默认,平衡)
   • 大型重构用 claude-opus-4-7(强但慢)
4. Token 计费原理见 FAQ 13(怎么省 token)

异常突刺怎么判断

还不行?

把以下信息发客服:

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

我们后台能查到每一次请求的时间戳,多扣的部分按 [我方原因](#faq-19) 全额退款到额度。

相关错误码:BILL01 · BILL02

发生了什么

Claude 上游和电网一样有「用电高峰」:

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

我们后台同时挂着 1 个 Pro 200x 主力 + 6 个 Plus 副号,单个号被限流时自动切换,客户感觉不到。

你应该做什么

优先级从高到低:

1. 切换到 claude-haiku-4-5 — 比 sonnet 快 3 倍。Claude Code 里输 /model claude-haiku-4-5
2. 检查本机网络 — ping router.handsfreeclub.com,> 200ms 建议开 VPN / 换网络(详见 FAQ 17 跨境网络)
3. 看 实时状态页 — 全绿就是上游问题,等高峰过
4. 晚 11 点之后再试 — 高峰过了速度自然恢复
5. 判断锅在哪 — 看 FAQ 18 是你们的问题还是上游?

还不行?

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

• 微信发客服:Key 末 4 位 + traceroute router.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

两种 Plan 的计费

怎么省 token(两种 Plan 通用)

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.5 / 4.x 自动缓存 ≥1024 token 的 prefix,无需标记
• 缓存有效期:Anthropic 5 分钟、OpenAI 5-10 分钟(滚动续期)

能省多少

客户端默认配置

• Claude Code ≥ v1.x:默认开启,长任务自动命中
• Cursor:默认开启(Pro 模式),无需配置
• Cline:settings 里勾「Enable Prompt Caching」
• Codex CLI:GPT-5.5 自动缓存,无需手动标

怎么验证命中了

1. 看响应 usage.cache_read_input_tokens(Anthropic)或 usage.prompt_tokens_details.cached_tokens(OpenAI)字段 > 0
2. 用 余额页对比 7 天用量曲线,长任务后扣费明显小于 token 数 × 官方价 → 缓存生效
3. 没命中?多半是 prompt 前缀变了(每次都加时间戳 / 随机 ID 会破坏缓存)

还不行?

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

限流规则

我们做了什么自动重试

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

你应该做什么

1. 看到 429 → 等 30-60 秒再发(客户端通常会自动 retry,你也可以手动重发)
2. 如果是批量调用(脚本一次发 100 个) → 在你的脚本里加 sleep 1 让 QPS 控制在 1/秒
3. 持续撞 429 → 切 claude-haiku-4-5(限流分桶不同,可能不撞)
4. 常态高频用户 → 微信客服升级配额(企业卡可以提到 200 req/min)

还不行?

• 持续超 5 分钟 429 → 微信发客服 + Key 末 4 位 + 触发时间
• 30 分钟内调阈值 / 临时给你切独立通道

相关错误码:RL01 · RL02

什么是流式输出

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

常见中断原因

你应该做什么

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

还不行?

1 小时内多次中断 → 微信客服:

• Key 末 4 位
• 中断时间(精确到分钟)
• 客户端 + 网络环境(WiFi / 4G / 公司网)
• 有没有开 VPN(VPN 类型)

相关错误码:STREAM01 · STREAM02 · NET02

错误码 8 大类

常见错误 Top 6 速查

找客服必带 4 项

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

带齐这 4 项,90% 客服 5 分钟内能给出明确解决方案。

还不行?

错误码不在表里 → 直接发完整截图,我们对照内部错误库给翻译。

第 1 步:基础连通性

# 测延迟
ping router.handsfreeclub.com
# 正常:50-200ms
# 不通:跳到第 2 步

# 测 DNS
nslookup router.handsfreeclub.com
# 应返回 1.x.x.x 或 104.x.x.x (Cloudflare)

第 2 步:HTTPS 通不通

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

不通常见原因 + 解

VPN 推荐?

• 大部分用户不需要 VPN,直连香港 / 新加坡延迟 50-200ms 够用
• 如确实卡,推荐 Clash / Surge 设规则:只有 router.handsfreeclub.com 走代理,其他直连(避免被代理误伤)
• 不要用免费 VPN(可能截获你的 sk-key)

还不行?

把以下信息发客服:

• traceroute router.handsfreeclub.com 截图(macOS / Linux)或 tracert(Windows)
• 所在地区 + 运营商(电信 / 联通 / 移动)
• 是否在公司 / 学校特殊网络

30 分钟内排查并提供方案(可能需要切第二个域名 backup)。

相关错误码:NET01 · NET02 · NET03

5 分钟自检流程

1. 看我们的实时状态:https://status.handsfreeclub.com
   • 全绿 + 历史 7 天可用率 ≥ 99.9% → 我们正常
   • 有红 → 我们承认,等公告
2. 看 Anthropic 官方:https://status.anthropic.com
   • 有红 → 上游故障,跟我们无关,等他们修
   • 全绿 → 排除上游
3. curl 直测我们端点:

   curl -i https://router.handsfreeclub.com/v1/messages \
     -H "x-api-key: $ANTHROPIC_AUTH_TOKEN" \
     -H "anthropic-version: 2023-06-01" \
     -H "content-type: application/json" \
     -d '{"model":"claude-haiku-4-5","max_tokens":50,"messages":[{"role":"user","content":"hi"}]}'

   • 200 OK → 我们正常,问题在你的客户端 / 配置
   • 5xx → 我们或上游(对照状态页判断)
   • 429 → 你被限流
   • 401 → key 错

常见组合

我们的承诺

• 我们的故障会在 status page 5-7 分钟内触发监控告警 + 客服微信主动同步进度
• 连续 30 分钟不可用 → 主动补 1 天时长 / 走 [我方退款](#faq-19)
• 上游故障我们不甩锅,会同步原因 + 切换备用账号

还不行?

判断不出哪一边,微信客服带上面 3 个截图,我们当场对账。

退款政策(2026-05-02 Ethan 拍板)

举例:你买 ¥99 基础包用了 10 天还剩 20 天:
· 我方原因 → 退 ¥99 × 20/30 = ¥66
· 非我方原因 → 退 ¥66 × 50% = ¥33

怎么申请

1. 微信客服 aa402837(昵称 Donish),发以下 4 项 + 退款理由:
   • 付款时间(精确到天)
   • 付款金额
   • 付款渠道(微信 / 支付宝)
   • 付款单号(订单页可复制)
   • 退款理由(我们据此判定我方/非我方)
2. 30 分钟内客服首响,确认金额
3. 1-3 个工作日原路退回(微信付的退微信、支付宝付的退支付宝)
4. 后台:你的 sk-key 立即作废,group 改回 default

什么是「我方原因」(明文清单)

✓ 是我方

• 主路径不可用连续 ≥30 分钟(对照 status page 历史)
• 服务下线 / 跑路
• 计费 bug 多扣额度
• 给错档位(你买 ¥99 我们配成 ¥9.9)

✗ 非我方

• Claude 写错代码 / 答得不好(模型本身问题,Anthropic 也一样)
• 客户本地网络问题(不通 / 慢)
• 客户主观觉得「卡」「不好用」「跟同行比贵」

还不行?

我方/非我方判定有争议:

• 客服会主动调出 status page 历史 + 你的调用日志判断
• 双方分歧大 → 主动让你 2-3 句话陈述,我们倾向客户(初创品牌口碑 > 单笔利润)
• 明确属于灰色地带的(故障时间 25 分钟接近 30 分钟阈值)→ 直接按我方处理

详细政策:CUSTOMER_JOURNEY_SPEC §1 决策 ②③

升级流程(¥99 → ¥299)

1. 微信客服说要升级
2. 客服发差价收款码(¥299 - ¥99 = ¥200)
   ※ 不是按余量算差价,是直接补差价升档(简单透明)
3. 付款 + 备注「升级 邮箱」
4. 客服后台:
   • 找到你的 user
   • 跑额度合并脚本:旧档剩余美元 + 新档总额度
   • group 切换到 paid-pro
   • validity 取 max(原到期日, 今天 + 30 天)
5. sk-key 不变,客户端无需改任何配置

多档并行(没升级,直接再买一档)

场景:你 5/1 买了 ¥9.9 体验包(7 天),5/4 又想直接买 ¥99 月度包,不浪费体验包剩余:

1. 正常付款 ¥99 + 备注「基础 邮箱」
2. 客服合并:旧体验包剩余美元(4 天 × $2 = $8)+ 新月度包额度($150) = $158 total_balance
3. validity = max(原 5/8 到期, 今天 + 30 天 = 6/3) = 6/3
4. sk-key 不变

降级

当前不支持中途降级(政策原因:防止套利),你可以:

• 等当前包到期,下次买低档
• 实在用不完且觉得贵 → 走 [非我方退款](#faq-19) 半退,然后买低档

换邮箱(账号绑定)

看 [FAQ 24 Key 安全](#faq-24) 和客服身份认证流程。三选二验真后,客服改 user.email,旧邮箱收到通知防恶意。

还不行?

升级 / 多档场景算不清,微信发客服:

• 邮箱(找你的 user)
• 当前档位 + 想换的档位
• 客服当场算给你,合并后 total_balance 截图给你确认

续费机制

• 到期前 3 天:客服主动微信提醒「快到期了,要不要续」+ 自动发收款码
• 同档续费:发原档位价格的收款码,付完客服延 validity 30/365 天,sk-key 不变
• 升档续费:你说要升 → 走 [FAQ 20 升级流程](#faq-20)
• 不续:到期日凌晨 sk-key 自动 expired,后续调用返 401。可以随时复活(再买一档,user / 邮箱不变)

价格政策

老客户专属

• 连续续费 ≥ 3 期 → 自动列入「老客户」名单,享后续折扣 / 优先客服
• 介绍新客户成交 → 给老客户额度抵扣(下次续费 -¥30 等)
• 具体老客户优惠见:微信客服「老客户专享」当月活动

提前续费

• 未到期主动续费 → validity 累加(原到期日 + 30 / 365),不浪费
• 例:你 5/1 买 ¥99 30 天到 5/31,5/15 又续 ¥99 → validity 延到 6/30

还不行?

到期了客服没主动联系你 / 价格调整有疑问:

• 主动微信戳客服(我们 24h 内回)
• 价格异常(跟你之前买的不一样)→ 客服会查历史订单,异常处按原价

当前阶段(Phase 1)

个人收款(微信 / 支付宝)无法开发票:

• 客户付款是个人对个人转账性质
• 我们提供付款记录截图 + 服务说明 word 文档,部分公司可作为内部报销凭证
• 需要发票的客户建议等 Phase 2再买,或同时考虑直接 Anthropic 官方

Phase 2(¥5k 流水后,预计 1-2 月内)

切换链动小铺平台:

• 链动小铺支持个人服务发票(电子版),客户在链动小铺后台自助申请,2-5 工作日 PDF 邮件发到注册邮箱
• 金额 = 实付金额(含平台手续费)
• 抬头 = 个人姓名 / 公司全称都可以
• 票面项目:「信息技术服务费」

Phase 3(注册公司后,3-6 月内)

注册个体工商户 / 有限公司,接微信支付商户号:

• 普通增值税电子发票:免费、所有客户均可、税率 6%(信息技术服务)
• 专用发票:需企业一般纳税人资质、税率 6%、邮寄纸质或电子均可
• 合并开票:同一抬头一年内的多笔订单可合并开一张大票

需要发票的临时方案

1. 找客服说明用途 → 我们出具「服务说明 + 付款确认函」(word + 盖创始人电子签),部分小公司可入账
2. 同时建议你直接走 Anthropic 官方(他们有正式境外 invoice,部分公司接受)
3. 等待 Phase 2 上线 → 老客户可补开历史订单的电子凭证(从 Phase 1 起算,但需要补充资料)

还不行?

大额度团队 / 企业(单笔 ≥ ¥2000)有强发票需求:

• 微信客服「企业方案」,我们走 Phase 3 走过的合作伙伴公司代开(实测 5 工作日)
• 价格 + 发票挂钩,会有 5% 手续费,提前商量

相关错误码:无

共用单 Key 的问题

• 限流互踩:同时 3 人发请求,60 req/min 限流共享,容易撞 RL01
• 账目不清:谁用了多少看不到,内部对账难
• 泄露风险放大:任何一人电脑丢了 / 离职没回收,全员的 Key 都得换
• 额度配额耗得快:人均算下来比单人买进阶包更贵

当前阶段方案

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

• 每人各买一个 ¥99 / ¥299,各自微信报销给公司
• 规模 ≤ 2 人或不需要管理视角
• 缺点:对账靠每人提供

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

• 买 ¥299 进阶包(更高配额,扛得住 2 人)
• 注意:务必只在受信任同事之间
• 限流大概率撞,做好心理准备

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

• 1 个主 Key(管理员)+ N 个副 Key(团队成员各 1 个)
• 主 Key 后台能看每个副 Key 用量、独立设上限、随时禁用某个
• 所有副 Key 共享主 Key 的总额度池
• 预估价格:基础团队 ¥299 / 月(含 3 个副 Key,加 1 个 +¥30)
• 感兴趣的提前微信客服报名,Phase 2 上线优先通知

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

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

还不行?

团队场景特殊(跨国 / 多分公司 / 需 SOC2),微信客服详谈,我们 Phase 3 后能签合规协议。

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

常见泄露场景

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

泄露的征兆

看 余额页 7 天图表:

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

应急流程(分钟级)

1. 立刻微信客服 aa402837(昵称 Donish):报「Key 泄露」+ 邮箱 + 微信号(简化验证,场景紧急)
2. 客服5 分钟内后台:
   • 找到你的 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
• 群聊截图先打码后端 4 位
• 每月在 余额页扫一眼图表,看有没有突刺
• 开启余额预警邮件(默认 75% / 90% / 100% / 到期 3 天前自动发邮件)
• 如多人共用想分账,等 [团队额度包](#faq-23)(Phase 2 上线)

还不行?

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

• 客服优先级提到 P0,3 分钟内响应
• 同步给 Ethan(创始人)亲自跟进
• 必要时配合你提供 IP 取证(报警材料)

相关错误码:AUTH01 · AUTH02

数据流(诚实版)

HTTPS 加密只保护「客户端 ↔ 我们服务器」和「我们服务器 ↔ Anthropic」两段,我们中间这一跳必然能看到明文(任何中转服务都一样,不可避免)。

我们做了哪些(技术 + 法务双层)

• 不存:nginx access log 只记 HTTP method / 路径 / 状态码 / token 数,请求 body 直接丢弃不写盘
• 失败请求例外:5xx / 限流等失败请求会临时保留请求 body 用于排错,30 天自动 cron 清理(OpsCleanupService 已上线生产)
• 不读:运营人员无业务需要不会看你的请求,有需要(故障排查)会先脱敏
• 不训练:我们不是模型公司,我们没有训练任何 AI
• 不商用 / 不外发:任何形式的数据外流都不会发生
• Anthropic 上游已对企业客户承诺 30 天滚动删除,我们传上去的请求也走这条策略

合规现状

你应该怎么做

1. 一般工作 / 学习内容:不必担心,正常用
2. 商业敏感 / 法律 / 医疗等高敏感:
   • 建议用 Anthropic 官方企业版(他们和你签 BAA / SOC2 等正式协议)
   • 或本地部署开源模型(Qwen / DeepSeek 等)
3. 身份证 / 银行卡 / 私钥:任何 AI 服务都不要发,包括 Anthropic 官方,这是基本操作

NDA / DPA

需要书面隐私保密协议:

• 微信客服说明用途,我们提供 v1 模板,双方电子签
• 企业客户 100% 提供,个人客户根据情况
• 违约赔偿条款 = 退还历年付款的 5 倍封顶
• Phase 3(公司化后)起可签更严格的 DPA

还不行?

具体合规问题(GDPR / SOC2 / 等保 / HIPAA),微信客服详谈,我们能做的会照实告诉你不能做的不糊弄。

相关错误码:无 · 详见 隐私政策全文(Phase 3 上线)