GPT / Codex / Claude Code 接入
面向 Handsfree Club GPT 用户的权威快速配置。原 API Key 和 Base URL 不用更换，但模型名必须改成 GPT-5.6 的精确档位。
先确认权限
只有 openai-default 分组可以使用 GPT-5.6，未授权时返回 403。升级 IDE 或 Codex 也不会改变 Key 的分组权限。
不要填写裸的 gpt-5.6，它会返回 400；也不要使用通配符或跨档映射。
三个可用模型
| 模型 | 建议场景 |
|---|---|
gpt-5.6-sol | 高难度推理、架构和复杂调试 |
gpt-5.6-terra | 默认推荐，质量与成本平衡 |
gpt-5.6-luna | 轻量任务、速度和成本优先 |
Codex CLI
建议先运行 codex update 或 npm i -g @openai/codex@latest，但不能只升级 Codex：还必须把用户级 ~/.codex/config.toml 的模型改成精确档位。
model = "gpt-5.6-terra"
model_provider = "handsfree"
model_reasoning_effort = "high"
[model_providers.handsfree]
name = "Handsfree Club"
base_url = "https://api.handsfreeclub.com/v1"
wire_api = "responses"
requires_openai_auth = true~/.codex/auth.json（macOS/Linux 保存后执行 chmod 600 ~/.codex/auth.json；Windows 必须收紧为当前用户 owner-only，权限失败不要继续）：
{
"OPENAI_API_KEY": "sk-XXXXXXXXXXXXXXXXXXXXXXXX"
}不要把 provider 配置放到项目级 .codex/config.toml；自定义 provider 应放在用户级配置。GPT-5.6 使用 HTTP Responses，当前不要选择 WebSocket 模板。
Cursor / Cline / OpenAI SDK
Base URL 使用 https://api.handsfreeclub.com/v1，Key 仍用原来的 sk-...，模型填三档之一，推荐 gpt-5.6-terra。
Claude Code 调用 GPT-5.6
Claude Code 继续使用 Anthropic 协议，Base URL 使用根地址 https://api.handsfreeclub.com（不要加 /v1），模型环境变量可直接填写原生 GPT 身份：
ANTHROPIC_MODEL=gpt-5.6-terra
ANTHROPIC_DEFAULT_OPUS_MODEL=gpt-5.6-sol
ANTHROPIC_DEFAULT_SONNET_MODEL=gpt-5.6-terra
ANTHROPIC_DEFAULT_HAIKU_MODEL=gpt-5.6-luna旧的 claude-* alias 仍保留为兼容入口，但它不是实际 GPT 模型名。后台日志、用量和计费会显示真实执行的 upstream GPT 身份，避免误认为调用了 Claude。