客户端接入指南

在 Cline 接入 Handsfree Club

30 秒搞定。GPT 用户选择 OpenAI Compatible provider，Base URL 填 https://api.handsfreeclub.com/v1。仅 openai-default 分组可选 gpt-5.6-sol / gpt-5.6-terra / gpt-5.6-luna，默认推荐 Terra。

想离线阅读? 完整接入手册 PDF · v2.3

原本

https://api.openai.com/v1

→

改成

https://api.handsfreeclub.com/v1

在 Cline 设置里填一次 Base URL + API Key，再精确填写 GPT-5.6 模型 ID

30 秒摘要

VSCode 装 Cline 扩展 → 打开侧栏 → 点齿轮 → API Provider 选 OpenAI Compatible → Base URL 填 https://api.handsfreeclub.com/v1 → API Key 填 sk-xxxx → 模型手动填 gpt-5.6-terra → Done。

注册账号,拿 API Key#

没注册过的话,先注册一个账号,进 Console 创建一把 API Key。Key 长这样:

key

sk-XXXXXXXXXXXXXXXXXXXXXXXX  # 末 4 位会显示在 Console,出问题报这 4 位给客服

GPT-5.6 仅限 openai-default；该 Key 已开放 Messages 调度时，才可同时给 Cline、Claude Code、Codex、Cursor 使用。

在 Cline 设置面板里配置#

Cline 是 VSCode 扩展,所有配置都在它的侧边栏面板里。按下面 6 步走:

VSCode 打开扩展面板(Cmd + Shift + X / Ctrl + Shift + X),搜索 Cline 安装(作者:saoudrizwan)。装完左侧 Activity Bar 会多出一个 Cline 图标。
点 Cline 图标打开侧边栏,首次进入会让你选 API Provider——选择 OpenAI Compatible(已经用过的话点右上角齿轮 ⚙️ 进设置改)。
找到 Base URL 字段,填:
base url
```
https://api.handsfreeclub.com/v1
```
OpenAI API Key 字段填我们发给你的 Key:sk-XXXXXXXXXXXXXXXXXXXXXXXX。
Model 手动填 gpt-5.6-terra(默认推荐),也可精确填写 gpt-5.6-sol 或 gpt-5.6-luna——具体差异看下面 step 4。
点 Done 保存。设置项一存就立即生效,Cline 输入框现在就能用了。

权限边界：原 Key 不变；裸 gpt-5.6 返回 400，非 openai-default 返回 403。Anthropic provider + 根地址仅供 Claude-native 或 legacy alias 配置，不要与本页 GPT 配置混用。

启动验证#

在 Cline 侧边栏的输入框里发一句:

cline

> 你好,确认下走的是 Handsfree Club 中转?

有响应就说明通了。想再确认一下就去余额查询页输入 Key,看 used 数字有没有跳——跳了就证明请求确实走我们的服务器、计费没问题。

试试 agent 流程:让 Cline 帮你改一个文件,看看它会不会要 approval、能不能正常 patch、能不能跑测试。这是 Cline 最重型的能力,跑通了说明工具调用 + 文件 IO 全链路都没问题。

GPT-5.6 精确模型怎么选#

Cline 的 GPT 路径直接填写真实执行模型；请求、执行、上游、计费和日志身份保持为 GPT，不再显示 Claude alias:

用途	精确模型 ID	状态
默认主力	`gpt-5.6-terra`	就绪
高难任务	`gpt-5.6-sol`	就绪
轻量任务	`gpt-5.6-luna`	就绪

切换时在 Cline 输入框上方选择或手动填写精确 ID。不要填写裸 gpt-5.6，也不要用通配符或跨 tier 映射。费用按实际执行模型和后台已验证价格计算，以 Console 用量记录为准。

不知道选哪个?按场景挑就行:

日常 agent 任务

Terra

Cline 默认推荐。适合改 bug、加 feature、跑工具调用和日常 agent loop。

复杂重构 / 架构

Sol

Terra 解不出再切，适合需要全局规划的多文件改造、复杂调试和新模块设计。

简单任务 / 省钱

Luna

格式化、批量改名、提取信息等轻量任务，适合短链路自动化。

常见错误速查#

401 / Invalid API Key

Key 填错或漏前缀

设置面板里的 OpenAI API Key 字段重新检查：末 4 位跟 Console 一致，前缀是 sk-，不要输出或截图完整 Key。

404 / ENOTFOUND

Base URL 写错

本页 GPT 路径应检查 Base URL 是否为 https://api.handsfreeclub.com/v1（带 /v1），Provider 必须是 OpenAI Compatible。

429

请求被限流

短时限流请稍后重试；若持续出现，请保留时间戳和错误码联系管理员核查上游通道。

402 / quota

账户额度耗尽

账户额度已用完。请到充值页面选择额度，链动小铺付款后获取兑换码，再回个人中心兑换；需要其他金额时，可联系管理员或客服人工自定义充值。去充值 →

502 / 503

上游或网关问题

上游或我方网关异常时可能出现。先保留错误码和时间戳；持续 5 分钟以上查看 status page。权限或模型问题应返回明确 4xx，不应反复重试成 503。

model not found

模型下拉缺项

GPT-5.6 不一定出现在下拉列表；直接手动填写 gpt-5.6-terra、gpt-5.6-sol 或 gpt-5.6-luna。升级 Cline 只能改善客户端兼容，不能替代模型配置与 Key 权限。

Provider 选错

选了 Anthropic / OpenRouter / Bedrock

本页 GPT-5.6 路径必须选 OpenAI Compatible，并填写带 /v1 的 Base URL。其他 provider 会使用不同协议或把请求发到其他平台。

排查 5 分钟还没解决?把错误码 + Key 末 4 位 + 时间戳发到 Telegram @prosper777888 或 support@handsfreeclub.com,30 分钟内有人回。

FAQ · Cline 用户常问#

Cline 的 agent 能力(自动改文件、跑命令、用 MCP)能用吗?

Cline 的文件 patch、shell 命令、MCP server 通信和 auto-approve 属于本地能力；模型侧是否支持具体工具调用仍以当前 Cline 版本、所选模型和实际响应为准。

我能在多台机器、多个项目同时用同一把 Key 吗?

能。Key 没设备绑定，多台机器的用量合并计算。只有属于 openai-default 且已开放 Messages 调度的 Key，才能同时用于 Claude Code 与 OpenAI 客户端。

但请不要把 Key 公开(commit 到 git、贴到 issue 里),泄露了 Console 一键作废重发。

Cline 的 auto-approve 列表会影响计费吗?

不会。Auto-approve 是 Cline 本地的"自动放行"逻辑——决定哪些工具调用不用问你直接执行。计费只看模型 token 消耗,跟你 approve 几次无关。

但开 auto-approve 后 agent 跑得更顺、token 用得更多,这是间接影响。

Cline 长任务(比如改 30 个文件)会不会很贵?

Cline 会显示会话 token 统计，但长任务仍可能持续消耗。建议先用 Terra，复杂阶段按需切 Sol，轻量阶段切 Luna，并在 Console 查看真实用量和费用。

prompt cache 怎么算钱?

缓存 token 以实际上游 usage 和 Console 账单记录为准。不同模型、请求形态和上游价格 revision 可能不同，本教程不承诺固定缓存倍率。

能用官方订阅(Claude Pro / Max)走 Cline 吗?

不行。我们走的是 API token 模式,Pro/Max 订阅是 OAuth 模式,Cline 也只支持 API key,不读官方订阅。

这其实是好事——Pro/Max 订阅有"5 小时 session 重置"等限制,跑 agent 容易遇到 quota 边界。我们的 token 模式纯按 USD 用量计费,用多少花多少,长任务更稳定。

跑通了?现在就把 Cline 接上来

注册不再自动发放体验额度。需要先验证链路时，可充值 $30 固定额度；也可联系管理员或客服人工自定义充值。

去充值额度 → 查看额度档位