新手快速配置教程 | GGBond API Docs

一、先记住这几个地址

用途	地址
官网 / 控制台入口	https://api.ggbond666.online
注册账号	https://api.ggbond666.online/register
登录账号	https://api.ggbond666.online/login
用户控制台	https://api.ggbond666.online/dashboard
API 密钥管理	https://api.ggbond666.online/keys
加站长微信充值	在本页扫码添加站长微信
兑换码充值	https://api.ggbond666.online/redeem
使用记录	https://api.ggbond666.online/usage
主 API Base URL	`https://api.ggbond666.online/v1`
备用 API Base URL	`https://api.ggbond686.online/v1`

最常用配置

API Key：你在控制台创建的 sk- 开头密钥
Base URL：https://api.ggbond666.online/v1

二、注册账号

打开注册链接：

注册入口

https://api.ggbond666.online/register

输入邮箱或用户名。
设置登录密码。
点击注册按钮完成创建。

注册完成后，如果页面自动跳转到控制台，说明账号已经可以使用；如果没有自动跳转，就手动打开登录页。

三、登录账号

打开登录入口，输入注册时填写的邮箱 / 用户名和密码。登录成功后会进入用户控制台。

登录入口

https://api.ggbond666.online/login

控制台里可以看到余额、今日用量、API 密钥数量和最近使用记录。

四、充值额度：加站长微信

当前充值请添加站长微信处理。添加时备注你的注册邮箱或用户名，以及要充值的金额，方便尽快确认到账。

加站长微信充值

扫码添加站长微信。
备注你的注册邮箱或用户名。
发送要充值的金额，按站长回复完成付款。
充值完成后回到控制台，刷新页面查看余额是否到账。

如果余额没有及时到账，先刷新控制台；仍未变化时，把付款截图、注册邮箱或用户名发给站长核对。

已有兑换码时

如果你拿到的是兑换码，可以打开兑换页面处理。

兑换码充值

https://api.ggbond666.online/redeem

粘贴兑换码。
点击兑换。
页面提示成功后，查看新的余额或套餐状态。

兑换码通常只能使用一次，请不要公开发送给别人。

五、创建 API 密钥

打开密钥管理页面，点击“创建密钥”或“添加密钥”。

密钥管理

https://api.ggbond666.online/keys

项目	新手建议
名称	写一个自己看得懂的名字，例如 `codex`、`claude-code`、`test-key`
分组	一定要选择你要使用的模型分组
自定义密钥	新手可以不填，系统会自动生成
额度限制	不懂就先不启用，或给测试密钥设置一个小额度
速率限制	不懂就先不启用
过期时间	自己用可以不设置；临时给别人用建议设置过期时间

创建成功后，复制 sk- 开头的 API Key。这个密钥相当于你的账号密码，不要发到公开群、截图、代码仓库或网盘里。

六、选择正确分组

分组决定你的密钥能调用哪类模型。选错分组时，常见现象是：客户端能启动，但请求报错、模型不可用、或一直连不上。

你要用什么	通常选择
Codex CLI / OpenAI 兼容客户端	OpenAI / Codex 相关分组
Claude Code	Claude / Anthropic 相关分组
Gemini CLI	Gemini 相关分组
Antigravity	Antigravity 相关分组

如果你不确定该选哪个分组，先联系管理员确认。不要随便换分组反复测试，容易把问题排查复杂。

七、配置 Codex CLI

适合使用 OpenAI / Codex 分组的密钥。

1. 准备配置目录

macOS / Linux

mkdir -p ~/.codex

Windows 用户按 Win + R，输入 %userprofile%\.codex。如果目录不存在，就手动新建 .codex 文件夹。

2. 写入 config.toml

~/.codex/config.toml

model_provider = "OpenAI"
model = "gpt-5.4"
review_model = "gpt-5.4"
model_reasoning_effort = "xhigh"
disable_response_storage = true
network_access = "enabled"
windows_wsl_setup_acknowledged = true
model_context_window = 1000000
model_auto_compact_token_limit = 900000

[model_providers.OpenAI]
name = "OpenAI"
base_url = "https://api.ggbond666.online/v1"
wire_api = "responses"
requires_openai_auth = true

3. 写入 auth.json

~/.codex/auth.json

{
  "OPENAI_API_KEY": "这里换成你的 sk-密钥"
}

保存后重新打开终端，再运行 Codex CLI 测试。

4. WebSocket 模式可选

如果管理员明确让你使用 WebSocket 模式，再把 config.toml 改成下面这种。不知道该不该开时，就先用普通配置。

Codex WebSocket 配置

model_provider = "OpenAI"
model = "gpt-5.4"
review_model = "gpt-5.4"
model_reasoning_effort = "xhigh"
disable_response_storage = true
network_access = "enabled"
windows_wsl_setup_acknowledged = true
model_context_window = 1000000
model_auto_compact_token_limit = 900000

[model_providers.OpenAI]
name = "OpenAI"
base_url = "https://api.ggbond666.online/v1"
wire_api = "responses"
supports_websockets = true
requires_openai_auth = true

[features]
responses_websockets_v2 = true

八、配置 Claude Code

适合使用 Claude / Anthropic 分组的密钥。如果你拿到的是 Antigravity Claude 分组，Base URL 通常要用 https://api.ggbond666.online。

macOS / Linux

export ANTHROPIC_BASE_URL="https://api.ggbond666.online/v1"
export ANTHROPIC_AUTH_TOKEN="这里换成你的 sk-密钥"
export CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1

Windows CMD

set ANTHROPIC_BASE_URL=https://api.ggbond666.online/v1
set ANTHROPIC_AUTH_TOKEN=这里换成你的 sk-密钥
set CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1

Windows PowerShell

$env:ANTHROPIC_BASE_URL="https://api.ggbond666.online/v1"
$env:ANTHROPIC_AUTH_TOKEN="这里换成你的 sk-密钥"
$env:CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1

长期配置

如果你想让 Claude Code 在 VSCode 或长期会话里稳定读取配置，可以编辑 ~/.claude/settings.json 或 %userprofile%\.claude\settings.json。

settings.json

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.ggbond666.online/v1",
    "ANTHROPIC_AUTH_TOKEN": "这里换成你的 sk-密钥",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1",
    "CLAUDE_CODE_ATTRIBUTION_HEADER": "0"
  }
}

九、配置 Gemini CLI

适合使用 Gemini 分组的密钥。

macOS / Linux

export GOOGLE_GEMINI_BASE_URL="https://api.ggbond666.online/v1"
export GEMINI_API_KEY="这里换成你的 sk-密钥"
export GEMINI_MODEL="gemini-2.0-flash"

Windows CMD

set GOOGLE_GEMINI_BASE_URL=https://api.ggbond666.online/v1
set GEMINI_API_KEY=这里换成你的 sk-密钥
set GEMINI_MODEL=gemini-2.0-flash

Windows PowerShell

$env:GOOGLE_GEMINI_BASE_URL="https://api.ggbond666.online/v1"
$env:GEMINI_API_KEY="这里换成你的 sk-密钥"
$env:GEMINI_MODEL="gemini-2.0-flash"

如果你的分组是 Antigravity Gemini，Base URL 通常改成 https://api.ggbond666.online/antigravity。

十、配置 OpenAI 兼容客户端

很多第三方工具只需要两个字段。

通用配置

Base URL：https://api.ggbond666.online/v1
API Key：你的 sk-密钥

如果工具要求填写模型名，可以先使用 gpt-5.4。

如果工具要求完整请求地址，一般 Base URL 填 https://api.ggbond666.online/v1，工具自己会请求 /chat/completions 或 /responses。不要重复拼成 https://api.ggbond666.online/v1/chat/completions/v1。

十一、先做一个最小测试

拿到密钥后，可以先测试模型列表。把下面的 sk-xxx 换成你的密钥。

macOS / Linux

curl https://api.ggbond666.online/v1/models \
  -H "Authorization: Bearer sk-xxx"

Windows PowerShell

curl.exe https://api.ggbond666.online/v1/models `
  -H "Authorization: Bearer sk-xxx"

能返回模型列表，说明 Base URL 和 API Key 基本没问题。

十二、常见问题

提示 API_KEY_REQUIRED

说明请求没有带 API Key，或客户端没有正确读取密钥。检查 API Key 是否填了、是否是 sk- 开头、Authorization 是否是 Bearer sk-xxx。

提示无权限、分组不存在、模型不可用

大概率是密钥没有选择正确分组，或当前分组不支持你调用的模型。到密钥管理页检查该密钥的“分组”。

提示余额不足

账号余额不够。回到本页的充值额度章节，扫码添加站长微信充值；如果你有兑换码，也可以打开兑换码充值页面处理。

Codex / Claude Code 配了还是不生效

是否重新打开了终端。
配置文件路径是否正确。
API Key 是否复制完整，没有多空格。
Base URL 是否是 https://api.ggbond666.online/v1。
密钥分组是否选对。

请求很慢或偶尔失败

先到使用记录页查看是否有错误信息：https://api.ggbond666.online/usage。如果持续异常，把报错截图、使用的客户端、模型名、时间发给管理员。

十三、安全提醒

API Key 不要发到群里、论坛、GitHub、网盘或截图里。
给别人临时使用时，建议单独创建一个密钥，并设置额度限制和过期时间。
密钥泄露后，立刻到密钥管理页面禁用或删除旧密钥，再创建新密钥。
不要把自己的账号密码和 API Key 一起交给陌生人排查。

十四、新手推荐流程

注册：https://api.ggbond666.online/register
登录：https://api.ggbond666.online/login
充值额度：回到本页扫码添加站长微信充值
创建密钥：https://api.ggbond666.online/keys
选择正确分组。
复制 API Key。
客户端里填写 Base URL：https://api.ggbond666.online/v1
测试一次模型列表或发起一次简单对话。

只要 Base URL、API Key、分组三个地方都对，大多数客户端都能正常使用。