选你用的客户端,30 秒接入
我们做的是 OpenAI / Anthropic 协议中转——改一个 base_url,所有客户端原生功能(slash commands、MCP、approval mode、Composer、Agent)100% 保留。下面按你用的客户端选入口,跳过去按章节往下走。
想离线阅读 / 一次看完? 完整接入手册 PDF · v2
付款后客服会发给你 3 样
① API Key(sk- 开头)· ② Base URL(Claude 走 https://api.handsfreeclub.com;OpenAI 走 https://api.handsfreeclub.com/v1)· ③ 可用模型清单(见下面 §3)。Key 等同密码,别 commit、别群发——丢了 联系客服一键作废重发。
curl -fsSL https://handsfreeclub.com/install.sh | bash -s -- --key sk-你的key
$env:HFC_KEY="sk-你的key"; irm https://handsfreeclub.com/install.ps1 | iex
你用什么客户端?#
选一个跳进去,每个专项页流程一致——注册 → 配置 → 验证 → 选模型 → 排错,按部就班 30 秒跑通。
Anthropic 官方 CLI · 4 行环境变量或写 ~/.claude/settings.json 即用 · /agents · /skills · hooks · MCP 全部原版可用
OpenAI 官方 CLI · 写 ~/.codex/config.toml 加一段 [model_providers.handsfree] · GPT-5.5 默认 · approval mode、slash、MCP 全保留
AI 原生 IDE · Settings → Models 一键开 Override OpenAI Base URL · Composer / Chat / Cmd-K 全走我们 · Tab 内联补全保留 Cursor 自家
VSCode 扩展 · Provider 选 Anthropic 走 Claude 系列,选 OpenAI Compatible 走 GPT-5.x · GUI 一次配好,无需改文件
OpenAI 协议 POST /v1/images/generations · 模型 gpt-image-2 · ¥0.05 / ¥0.10 / ¥0.20 三档 · 不绑套餐, 「按量充值」¥10 起步
https://api.handsfreeclub.com,Key = sk-xxxx,按量倍率分别是 0.7× / 0.3×。其他 OpenAI 兼容工具(Roo Code / Continue / Cherry Studio / OpenAI SDK / OpenWebUI)照 /docs/cursor 的写法填。协议入口对照#
同一把 Key 两套协议都能用,选你客户端对应的 base url:
| 客户端 | 协议 | Base URL | Key 字段 |
|---|---|---|---|
| Claude Code | Anthropic Messages | https://api.handsfreeclub.com |
ANTHROPIC_AUTH_TOKEN |
| Codex CLI | OpenAI Responses | https://api.handsfreeclub.com/v1 |
OPENAI_API_KEY |
| Cursor | OpenAI 兼容 | https://api.handsfreeclub.com/v1 |
OpenAI API Key 字段 |
| Cline | 视 provider 而定 | Anthropic 不带 /v1,OpenAI 兼容带 /v1 |
对应 provider 字段 |
| Antigravity | Anthropic Messages | https://api.handsfreeclub.com |
API Key 字段 |
| Kiro | Anthropic Messages | https://api.handsfreeclub.com |
API Key 字段 |
| 生图 API | OpenAI Images | https://api.handsfreeclub.com/v1/images/generations |
OPENAI_API_KEY |
https://api.handsfreeclub.com/openai/v1 · Anthropic https://api.handsfreeclub.com/anthropic。绝大多数情况用上面标准入口即可。当前可用模型 · 跟官方一一对应#
我们不改名、不偷换型号——你看到的模型 ID 就是真实调用的那个。
| Claude Code 选项 | 实际模型 ID | 状态 |
|---|---|---|
| Sonnet(默认) | claude-sonnet-4-6 |
就绪 |
| Opus(难题档) | claude-opus-4-7 |
就绪 |
| Haiku(省钱档) | claude-haiku-4-5 |
就绪 |
| 名称 | 实际模型 ID | 状态 |
|---|---|---|
| GPT-5.5(2026-04 frontier 主推) | gpt-5.5 |
就绪 |
| GPT-5.5 Pro | gpt-5.5-pro |
就绪 |
| GPT-5.4(平衡档) | gpt-5.4 |
就绪 |
| GPT-5.3 Codex(coding 长跑) | gpt-5.3-codex |
就绪 |
| GPT-5.4 mini(省钱) | gpt-5.4-mini |
就绪 |
| GPT-5.4 nano(最轻 / 低延迟) | gpt-5.4-nano |
就绪 |
计费按官方 token 价格 1:1 折算(GPT-5.5 是 $5 / $30 per 1M tokens · 1M context · 2026-04-24 起 API 全量)。
错误码速查#
跑不通先看这里——8 种最常见错误,每条都给到具体动作。仍解决不了?微信客服 30 分钟首响。
model_not_found
模型名拼错或客户端版本太旧。对照 §3 模型表;Codex CLI 报"requires a newer version" → npm i -g @openai/codex@latest。
rate limit
1 分钟内超过 60 次。等 1 分钟自动恢复;持续触发联系客服升档。正常使用碰不到。
网络超时
检查本地代理 / VPN;Claude Code 把 timeout 调大到 120s;Cursor / Cline 重启 IDE。
认证 / 地址有问题
Cursor 的 Base URL 末尾必须带 /v1;Key 是 sk- 开头;首尾无空格。三者满足才会绿勾。
走了 ChatGPT 登录而非 env
之前用 ChatGPT 账号登过 Codex。先 codex logout 清掉,确认 echo $OPENAI_API_KEY 已 export,重启终端再跑。
服务承诺#
工作时段(9:00-23:00)30 分钟内回复 / 深夜次日 9:00 前。
上游异常自动重试,故障 5-7 分钟内监控告警,客服主动同步进度。
因我方原因连续 30 分钟不可用 → 主动补 1 天时长。
成功请求不持久化 prompt 内容;失败请求为排错临时保留请求体,30 天自动清理。不训练、不商用、不外发。
退款规则
主路径不可用 ≥30 分钟 / 服务下线 / 扣错钱 / 给错档位 → 未消耗部分全额退。
觉得不好用 / 用户本地网络问题 / 跟同行比贵 → 剩余金额按 50% 折算退。
30 秒接入,你只差一把 Key
注册后按文档接入,选择合适额度或套餐后即可跑完一整套接入测试。
