在 Cline 接入 Handsfree Club
30 秒搞定。Cline 是 VSCode 里的开源 autonomous coding agent 扩展,接入我们最简单——选 Anthropic provider,Base URL 改一行,Claude 全系即开即用。
想离线阅读? 完整接入手册 PDF · v2
30 秒摘要
VSCode 装 Cline 扩展 → 打开侧栏 → 点齿轮 → API Provider 选 Anthropic → Base URL 填 https://api.handsfreeclub.com → API Key 填 sk-xxxx → 模型选 Sonnet → Done。
注册账号,拿 API Key#
没注册过的话,先注册一个账号,进 Console 创建一把 API Key。Key 长这样:
sk-XXXXXXXXXXXXXXXXXXXXXXXX # 末 4 位会显示在 Console,出问题报这 4 位给客服
在 Cline 设置面板里配置#
Cline 是 VSCode 扩展,所有配置都在它的侧边栏面板里。按下面 6 步走:
- VSCode 打开扩展面板(Cmd + Shift + X / Ctrl + Shift + X),搜索 Cline 安装(作者:saoudrizwan)。装完左侧 Activity Bar 会多出一个 Cline 图标。
- 点 Cline 图标打开侧边栏,首次进入会让你选 API Provider——选 Anthropic(已经用过的话点右上角齿轮 ⚙️ 进设置改)。
- 找到 Anthropic Base URL 字段,填:base url
https://api.handsfreeclub.com - Anthropic API Key 字段填我们发给你的 Key:
sk-XXXXXXXXXXXXXXXXXXXXXXXX。 - Model 下拉选
claude-sonnet-4-6(默认推荐),也可以选 Opus 或 Haiku——具体差异看下面 step 4。 - 点 Done 保存。设置项一存就立即生效,Cline 输入框现在就能用了。
https://api.handsfreeclub.com/v1,Model 手敲 gpt-5.5(默认推荐)/ gpt-5.3-codex / gpt-5.4-mini 即可。完整模型清单和切换技巧看 Codex 接入页。启动验证#
在 Cline 侧边栏的输入框里发一句:
> 你好,确认下走的是 Handsfree Club 中转?
有响应就说明通了。想再确认一下就去 余额查询页输入 Key,看 used 数字有没有跳——跳了就证明请求确实走我们的服务器、计费没问题。
模型映射 · 跟官方一一对应#
我们不改模型名、不偷换型号。Cline 设置里 Model 下拉的所有选项都直通官方:
| Cline 选项 | 实际模型 ID | 状态 |
|---|---|---|
| Default | claude-sonnet-4-6 |
就绪 |
| Opus | claude-opus-4-7 |
就绪 |
| Sonnet | claude-sonnet-4-6 |
就绪 |
| Haiku | claude-haiku-4-5-20251001 |
就绪 |
切换:Cline 输入框上方点模型名,下拉选 Sonnet / Opus / Haiku 即可。计费按官方各自的 token 价格 1:1 折算,Opus 比 Sonnet 贵约 1.7x,Haiku 比 Sonnet 便宜约 3x,跟官方完全一致。
不知道选哪个?按场景挑就行:
常见错误速查#
Key 填错或漏前缀
设置面板里的 Anthropic API Key 字段重检查:末 4 位跟 Console 一致,前缀是 sk- 不是 sk-ant-。
Base URL 写错
检查 Anthropic Base URL 是 https://api.handsfreeclub.com(不带 /v1,Anthropic 协议路径在 /v1/messages,Cline 自己拼)。
模型下拉缺项
Cline 模型下拉里没看到 claude-sonnet-4-6?把扩展更新到最新版(VSCode 扩展面板搜 Cline 看有没有 update)。老版本的 model list 可能没 4.6。
选了 OpenRouter / Bedrock
Cline 支持很多 provider,容易选错。必须选 Anthropic(直连协议),不是 "OpenRouter" 或 "AWS Bedrock" ——后者会把请求发到那些平台,而不是我们。
@prosper777888 或 support@handsfreeclub.com,30 分钟内有人回。FAQ · Cline 用户常问#
Cline 的 agent 能力(自动改文件、跑命令、用 MCP)能用吗?
全部能用,我们不阉割任何官方功能。因为我们是协议中转——你的请求 → 我们 → Anthropic 官方,官方该返回什么就返回什么。Cline 端的所有 agent 行为(文件 patch、shell 命令、MCP server 通信、auto-approve)都是本地逻辑,跟我们无关。
我能在多台机器、多个项目同时用同一把 Key 吗?
能。Key 没设备绑定,家里 + 公司 + 项目 A + 项目 B 同时跑都行,所有调用合并计入同一个套餐余额。同一把 Key 也能给 Claude Code、Codex、Cursor 用——Anthropic 协议走 /、OpenAI 协议走 /v1。
但请不要把 Key 公开(commit 到 git、贴到 issue 里),泄露了 Console 一键作废重发。
Cline 的 auto-approve 列表会影响计费吗?
不会。Auto-approve 是 Cline 本地的"自动放行"逻辑——决定哪些工具调用不用问你直接执行。计费只看模型 token 消耗,跟你 approve 几次无关。
但开 auto-approve 后 agent 跑得更顺、token 用得更多,这是间接影响。
Cline 长任务(比如改 30 个文件)会不会很贵?
不会失控。Cline 有实时 token 计数,你能看到当前会话用了多少 input/output token。cache hit 0.1x,长任务 cache 命中率高,实际消耗比看着的少。
真要省钱,简单步骤切 Haiku、复杂规划切 Opus,平均下来比纯 Sonnet 还便宜。
prompt cache 怎么算钱?
跟官方完全一致。cache write 1.25x、cache hit 0.1x,我们透传。Cline 跑 agent loop 时会大量复用上下文(项目文件 tree、之前的 turn),cache 命中率非常高。
能用官方订阅(Claude Pro / Max)走 Cline 吗?
不行。我们走的是 API token 模式,Pro/Max 订阅是 OAuth 模式,Cline 也只支持 API key,不读官方订阅。
这其实是好事——Pro/Max 订阅有"5 小时 session 重置"等限制,跑 agent 容易遇到 quota 边界。我们的 token 模式纯按 USD 用量计费,用多少花多少,长任务更稳定。
跑通了?现在就把 Cline 接上来
注册后按文档接入,选择合适额度或套餐后即可跑完一整套接入测试。
