更多客户端接入

手机端可横向滑动表格，查看 Base URL 和 Key 放置。

Aider

read -rsp 'HandsfreeClub API Key: ' OPENAI_API_KEY; echo
export OPENAI_API_KEY
export OPENAI_API_BASE=https://api.handsfreeclub.com/v1
aider --model openai/gpt-5.6-terra

openai/ 是 Aider 本地 provider 前缀；HFC 日志和账单仍显示实际模型 gpt-5.6-terra。

Continue

在 Continue 的本机 Models 配置中新增 OpenAI provider；Key 放在本机 Secret / apiKey 字段，不要把真实值提交到项目仓库。

name: Handsfree Club
version: 0.0.1
schema: v1
models:
  - name: GPT-5.6 Terra
    provider: openai
    model: gpt-5.6-terra
    apiBase: https://api.handsfreeclub.com/v1
    apiKey: <在 Continue 本机凭据中填写 HFC Key>

Continue 对 GPT-5 系列默认可使用 Responses；HFC 同时支持 Responses 和 Chat Completions，无需强制关闭 Responses。

Roo Code / Kilo Code

1. API Provider 选 OpenAI Compatible。
2. Base URL 填 https://api.handsfreeclub.com/v1，Key 存在扩展的凭据字段。
3. Model ID 手动填 gpt-5.6-terra，保存后发短消息验证。

Zed

打开 Settings → AI → LLM Providers → Add Provider，类型选 OpenAI Compatible，provider ID 使用 handsfree，API URL 填 https://api.handsfreeclub.com/v1，添加三个精确模型。Key 通过界面存入系统钥匙串，或在启动 Zed 的环境中设置 HANDSFREE_API_KEY；不要把 Key 写进 settings.json。对应设置路径是 language_models → openai_compatible → api_url。

• Cherry Studio：新增 OpenAI Compatible provider，填带 /v1 的地址，再手动添加三个精确模型。
• Chatbox：Add Provider → OpenAI API Compatible，填写 API Host、Key 和模型，点 Check 验证。
• Jan：Settings → Model Providers → Add Provider → OpenAI-compatible；Base URL 必须以 /v1 结尾，自动发现失败时手动添加模型。
• OpenWebUI：Admin Settings → Connections → OpenAI → Add Connection；填 URL 和管理员持有的 Key，模型发现失败时使用 Model IDs filter。

LibreChat

LibreChat 不是在普通用户的 Connections 页面里直接改：Docker 部署需要挂载 librechat.yaml，Key 放 .env，修改后重建或重启对应应用容器。

endpoints:
  custom:
    - name: Handsfree Club
      apiKey: '${HFC_API_KEY}'
      baseURL: 'https://api.handsfreeclub.com/v1'
      models:
        default: [gpt-5.6-sol, gpt-5.6-terra, gpt-5.6-luna]
        fetch: false

在同目录受限权限的 .env 中设置 HFC_API_KEY；Docker 用户还要在 docker-compose.override.yml 挂载该 YAML。不要在 YAML 中写明文 Key。

NextChat

OPENAI_API_KEY=<HFC Key，仅放部署 Secret>
BASE_URL=https://api.handsfreeclub.com
CUSTOM_MODELS=+gpt-5.6-sol,+gpt-5.6-terra,+gpt-5.6-luna

LobeHub / LobeChat

OPENAI_API_KEY=<HFC Key，仅放部署 Secret>
OPENAI_PROXY_URL=https://api.handsfreeclub.com/v1
OPENAI_MODEL_LIST=+gpt-5.6-sol,+gpt-5.6-terra,+gpt-5.6-luna

改完部署变量后按你的托管平台重新部署；团队仓库只提交变量名，不提交真实值。

Open Interpreter

read -rsp 'HandsfreeClub API Key: ' OPENAI_API_KEY; echo
export OPENAI_API_KEY
interpreter --api_base https://api.handsfreeclub.com/v1 --model openai/gpt-5.6-terra

n8n / Zapier / 自建 Agent

HTTP Request 调 POST https://api.handsfreeclub.com/v1/responses，Authorization 使用 Credentials / Secret Vault 注入 Bearer Key，正文模型填精确 ID。不要把真实 Key 写进工作流 JSON、截图或导出文件。

以下产品的当前官方文档未验证可填写任意 HFC Base URL，因此本站不提供猜测式直连步骤：

• Windsurf：有 BYOK 不等于允许任意 OpenAI-compatible Base URL。
• Antigravity / Kiro：同时是 HFC 后台渠道或计费分组名称；客户侧产品本身未验证任意 Base URL。
• Gemini Code Assist / Gemini CLI、GitHub Copilot：使用各自官方账号与模型服务；不能因为支持 MCP 或工具协议就推导为支持 HFC 模型端点。

1. 先保存连接，再拉取或手动添加三个精确模型。
2. 用 gpt-5.6-terra 发一条短测试消息。
3. 到 HFC Console Usage 检查实际 upstream / billing model；不应显示为 Claude。

• 400：使用了裸 gpt-5.6 或请求结构不兼容。
• 401：Key 无效、未加载或客户端没有发送 Bearer 凭据。
• 403：Key 不属于 openai-default 或 GPT-5.6 未授权。
• 404：Base URL 层级错误；先检查该客户端是否属于 NextChat 例外。