选你用的客户端,30 秒接入
我们做的是 OpenAI / Anthropic 协议中转——改一个 base_url,所有客户端原生功能(slash commands、MCP、approval mode、Composer、Agent)100% 保留。下面按你用的客户端选入口,跳过去按章节往下走。
GPT-5.6 统一规则：仅 openai-default 分组可用 gpt-5.6-sol / gpt-5.6-terra / gpt-5.6-luna，Terra 默认推荐。原 Key 和 Base URL 不变；裸 gpt-5.6 返回 400，未授权返回 403。
想离线阅读 / 一次看完? 完整接入手册 PDF · v2.3
付款后客服会发给你 3 样
① API Key(sk- 开头)· ② Base URL(Claude 走 https://api.handsfreeclub.com;OpenAI 走 https://api.handsfreeclub.com/v1)· ③ 可用模型清单(见下面 §3)。Key 等同密码,别 commit、别群发——丢了 联系客服一键作废重发。
bash <(curl -fsSL https://handsfreeclub.com/install.sh)
& ([scriptblock]::Create((irm https://handsfreeclub.com/install.ps1)))
你用什么客户端?#
选一个跳进去,每个专项页流程一致——注册 → 配置 → 验证 → 选模型 → 排错,按部就班 30 秒跑通。
Anthropic 协议 CLI · openai-default 将 Opus / Sonnet / Haiku 三档角色绑定到真实 GPT-5.6 · 日志与计费显示实际 GPT
OpenAI 官方 CLI · 写 ~/.codex/config.toml 加一段 [model_providers.handsfree] · GPT-5.6 Terra 默认 · approval mode、slash、MCP 全保留
AI 原生 IDE · Settings → Models 一键开 Override OpenAI Base URL · Composer / Chat / Cmd-K 全走我们 · Tab 内联补全保留 Cursor 自家
VSCode 扩展 · GPT-5.6 选择 OpenAI Compatible，Base URL 带 /v1，手动填写 Sol / Terra / Luna 精确 ID
OpenAI 协议 POST /v1/images/generations · 模型 gpt-image-2 · ¥0.05 / ¥0.10 / ¥0.20 三档 · 不绑套餐, 「按量充值」¥10 起步
在 ~/.hermes/config.yaml 注册命名 custom provider，使用 OpenAI Chat Completions 与真实 GPT-5.6 精确模型。
在 models.providers 注册 Handsfree provider，使用 provider/model 形式选 GPT-5.6；无需迁移到 Hermes。
在 opencode.json 中显式配置 @ai-sdk/openai、Base URL 和模型表；不能只靠环境变量自动接入。
Aider、Continue、Roo、Kilo、Zed、Chatbox、Jan、OpenWebUI、LibreChat、NextChat、LobeHub、Open Interpreter 已按官方能力分类核对。
协议入口对照#
属于 openai-default 且已开放 Messages 调度的 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 字段 |
| Hermes | OpenAI Chat Completions | https://api.handsfreeclub.com/v1 |
OPENAI_API_KEY |
| OpenClaw | OpenAI Responses | https://api.handsfreeclub.com/v1 |
OPENAI_API_KEY |
| OpenCode | OpenAI Responses | https://api.handsfreeclub.com/v1 |
OPENAI_API_KEY |
| 更多 OpenAI 客户端 | OpenAI 兼容 | https://api.handsfreeclub.com/v1 |
API Key / Secret 字段 |
| 生图 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。绝大多数情况用上面标准入口即可。当前可用模型 · 按真实执行身份展示#
新配置使用精确 GPT ID；Claude Code 的界面角色与实际执行身份分开记录，Console 默认展示 upstream 模型。
| Claude Code 选项 | 实际模型 ID | 状态 |
|---|---|---|
| Sonnet(默认) | gpt-5.6-terra |
就绪 |
| Opus(难题档) | gpt-5.6-sol |
就绪 |
| Haiku(省钱档) | gpt-5.6-luna |
就绪 |
| 名称 | 实际模型 ID | 状态 |
|---|---|---|
| GPT-5.6 Terra(默认推荐) | gpt-5.6-terra |
就绪 |
| GPT-5.6 Sol | gpt-5.6-sol |
就绪 |
| GPT-5.4(平衡档) | gpt-5.4 |
就绪 |
| GPT-5.3 Codex(coding 长跑) | gpt-5.3-codex |
就绪 |
| GPT-5.6 Luna(省钱) | gpt-5.6-luna |
就绪 |
计费按真实执行模型和请求时价格快照结算。模型、价格 revision 和费用结果会写入用量记录。
错误码速查#
跑不通先看这里——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 清掉，运行 test -n "$OPENAI_API_KEY" && echo KEY_SET 确认变量已设置（不要输出完整 Key），重启终端再跑。
服务承诺#
工作时段(9:00-23:00)30 分钟内回复 / 深夜次日 9:00 前。
上游异常自动重试,故障 5-7 分钟内监控告警,客服主动同步进度。
因我方原因连续 30 分钟不可用 → 主动补 1 天时长。
成功请求不持久化 prompt 内容;失败请求为排错临时保留请求体,30 天自动清理。不训练、不商用、不外发。
退款规则
主路径不可用 ≥30 分钟 / 服务下线 / 扣错钱 / 给错档位 → 未消耗部分全额退。
觉得不好用 / 用户本地网络问题 / 跟同行比贵 → 剩余金额按 50% 折算退。
30 秒接入,你只差一把 Key
注册不再自动发放体验额度。需要先验证链路时，可充值 $30 固定额度；也可联系管理员或客服人工自定义充值。