GET CONNECTED
接入指南
选分组，建密钥，连接你的工具。
01 · 先创建对应分组的密钥
注册或登录后，进入「API 密钥」并新建密钥。按用途选择分组，复制后妥善保存。
分组由密钥决定，不是修改模型名就能切换。使用前确认账户余额和密钥限额。
02 · GPT · 通用接入
在支持 Responses API 的工具中添加自定义服务商：
https://hfzm.top/v1
Base URL 不要重复添加 /v1，也不要填成完整的 /v1/responses。若工具自动添加 /v1，只填域名。
03 · Codex CLI 配置示例
先按官方说明安装 Codex CLI，备份 ~/.codex/config.toml 后合并以下配置：
model = "填写你的模型ID"
model_provider = "hfzm"
[model_providers.hfzm]
name = "HFZM"
base_url = "https://hfzm.top/v1"
wire_api = "responses"
env_key = "HFZM_API_KEY"在启动 Codex 的同一终端设置密钥：
# macOS / Linux
export HFZM_API_KEY="YOUR_GPT_GROUP_KEY"
codex
# Windows PowerShell
$env:HFZM_API_KEY="YOUR_GPT_GROUP_KEY"
codex避免在共享终端或录屏中输入密钥；命令可能被 shell 历史记录保存。
04 · Claude Code 配置
先安装官方 Claude Code CLI。打开 ~/.claude/settings.json（Windows：%USERPROFILE%\.claude\settings.json），不存在则创建：
{
"env": {
"ANTHROPIC_BASE_URL": "https://hfzm.top",
"ANTHROPIC_AUTH_TOKEN": "YOUR_CLAUDE_GROUP_KEY"
}
}这里的地址不带 /v1。替换密钥后重启 Claude Code，在终端运行
claude；不要把密钥写进项目仓库的配置文件。05 · 发一条短消息，确认接入
在客户端发送「只回复 OK」，收到回复后，打开控制台的使用记录，确认密钥、分组与模型。
Claude Code 也可先用 /status 检查配置来源。
06 · 遇到问题，先检查这几项
401 / 认证失败：检查密钥是否复制完整、是否有效，以及旧环境变量或项目配置是否覆盖了新配置。
403 / 无权限：核对分组、模型权限与客户端限制。
404 / 路径或模型错误：检查 Base URL、重复的 /v1，以及模型 ID 拼写。
429 / 限流：降低并发，稍后重试，并检查余额及限额；5xx 请查看服务状态或联系支持。
寻求帮助时提供错误码、时间和请求 ID；截图请遮挡密钥。若密钥泄露，请立即撤销并重新创建。