南北绿豆聊天有陪伴, 编程有搭档 我的 API 密钥
THE FIRST CONNECTION

接好工具,
开始你的下一件作品.

用本站 API Key 连接 Codex 与 Claude Code,
或跟着图解, 为 AstrBot 接上 Gemini.

01 / YOUR OWN KEY

先选用途, 再建密钥.

  1. 注册并充值. 在本站注册, 前往钱包自助充值. 支付 ¥1 到账 ¥1 人民币余额, 模型调用按量扣费.
  2. 按客户端创建独立 API Key. 在API 密钥中新增密钥, 名称可以写成“我的 Codex”或“我的 AstrBot”, 并设置自己的使用额度.
  3. 选择对应分组. 分组决定模型权限和计价. GPT, Claude 和 Gemini 建议分开创建密钥; 密钥启用了模型限制时, 也要允许准备使用的模型.
客户端与分组对应关系
用途密钥分组模型示例
Codex 编程支持目标模型的 GPT 分组,
如 不降智GPTPRO
gpt-6.1-sol
Claude Code 编程kiro-claudeclaude-sonnet-5
claude-opus-5-5
AstrBot 聊天geminigemini-3.8-flash

以上是本站配置示例, 不是所有分组均支持全部模型. 以控制台当前可用分组及价目表为准. 名称中含“稳定”或“不降智”不代表无限并发或无条件服务承诺.

请选对模型: Gemini 仅用于 Bot, 酒馆, 日常聊天与 RP, 不用于 Codex, Claude Code 等编程软件及 Agent. GPT 与 Claude 系列不受这条 Gemini 限制.

02 / LESS TYPING

用 CC Switch 导入.

CC Switch 管理客户端配置. 它不是模型服务, 也不会替你安装 Codex 或 Claude Code.

  1. 安装 CC Switch 和目标客户端. 在官方发布页按自己的 macOS, Windows 或 Linux 下载, 安装并打开一次 CC Switch. Codex 与 Claude Code 的官方安装入口在下方各自教程中.
  2. 使用站内带密钥导入. 登录后打开“API 密钥”, 找到刚创建的对应分组密钥, 点该行“更多操作”菜单, 选择 CC Switch.
  3. 选客户端与模型. Codex 选择 Codex, 主模型填 gpt-6.1-sol; Claude Code 选择 Claude, 主模型填 claude-sonnet-5 或该分组支持的其他 Claude 模型. 不是选 Gemini.
  4. 检查后确认. 点“打开 CC Switch”, 在本机导入确认框核对站名, 地址与模型. 此操作会将该密钥交给本机 CC Switch, 并可能切换当前服务商配置, 请先备份原配置.
  5. 重启客户端并验证. 关闭原来的 Codex 或 Claude Code 会话后重新打开. 完成一次小请求验证, 不要仅凭“导入成功”判断已经可用.
只想导入一个不含真实密钥的模板?

下面的模板使用明确的占位符, 不读取你的账号或 API Key, 也不请求自动启用. 导入后必须在 CC Switch 中编辑服务商, 把 REPLACE_WITH_SITE_API_KEY 换成自己的本站密钥, 然后手动启用.

模板的客户端名称以“待填密钥”结尾. 未替换占位符就调用会认证失败. 没有弹出应用时, 检查 CC Switch 是否已安装, 或在应用内手动新增服务商.

Claude 导入时, Sonnet 模型填 claude-sonnet-5, Opus 模型填 claude-opus-5-5. 本教程将 Haiku 别名也设为 claude-sonnet-5, 用本站已有模型执行轻量任务; 实际调用和计费都是 Sonnet, 不是 Haiku. 不要选择当前分组没有的模型.

带真实密钥的导入链接不可转发, 不要提交给在线链接解析器. 本页模板不含真实密钥, 不包含用量脚本, 也不更改客户端的文件访问或审批权限.

03 / GPT FOR YOUR CODE

Codex 手动配置.

优先使用上方 CC Switch. 以下为 Codex CLI 的环境变量配置方式, 不需要修改项目源码.

安装 Codex CLI: OpenAI 官方指南 ↗

1. 合并到用户配置

macOS / Linux: ~/.codex/config.toml. Windows: %USERPROFILE%\.codex\config.toml. 先备份原文件, 再合并以下字段; 不要覆盖原有 MCP, 项目权限或其他服务商配置, 也不要重复定义同名字段.

config.toml · 不含密钥
model_provider = "nanbei"
model = "gpt-6.1-sol"

[model_providers.nanbei]
name = "南北绿豆"
base_url = "https://hajimi.165201.xyz/v1"
wire_api = "responses"
env_key = "NANBEI_API_KEY"

Codex 需要 Responses 协议. 地址保留 /v1, 不要再追加 /responses 或 /chat/completions. 具体模型必须是你的 GPT 分组可用模型.

2. 在本次终端会话输入密钥

macOS / Linux · Bash 或 Zsh

执行后按提示输入自己的本站 GPT 分组 API Key. 输入不会显示在屏幕上, 也不需要把密钥写进命令历史.

终端
printf '请输入本站 GPT 分组 API Key: '
read -r -s NANBEI_API_KEY
printf '\n'
export NANBEI_API_KEY
codex
Windows · PowerShell
PowerShell
$secureKey = Read-Host "请输入本站 GPT 分组 API Key" -AsSecureString
$env:NANBEI_API_KEY = [System.Net.NetworkCredential]::new("", $secureKey).Password
Remove-Variable secureKey
codex

这组命令只对当前终端及其启动的进程生效. 从桌面打开的应用未必能读到它. 不要把实际密钥写进项目仓库; 想统一管理本机配置, 使用 CC Switch 并检查对应客户端的生效范围.

04 / CLAUDE FOR YOUR CODE

Claude Code 手动配置.

使用本站 Claude 分组密钥和 Claude 模型. 下面针对 Claude Code CLI, 不等同于 Claude 网页订阅或桌面聊天应用.

安装 Claude Code: 官方指南 ↗

1. 合并到个人 settings.json

macOS / Linux: ~/.claude/settings.json. Windows: %USERPROFILE%\.claude\settings.json. 先备份, 将以下字段合并到现有 env 对象, 替换密钥占位符. JSON 不支持注释或末尾多余逗号.

settings.json · 请替换占位符
{
  "env": {
    "ANTHROPIC_BASE_URL": "https://hajimi.165201.xyz",
    "ANTHROPIC_AUTH_TOKEN": "REPLACE_WITH_SITE_API_KEY",
    "ANTHROPIC_MODEL": "claude-sonnet-5",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-sonnet-5",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-5",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-5-5"
  }
}

Claude Code 地址与 Codex 不同: 这里填写站点根地址, 不带 /v1, 也不带 /messages. 客户端会追加请求路径. 不要同时保留其他站点的 ANTHROPIC_API_KEY 或认证配置; 先检查冲突来源, 不必清空整个配置文件.

2. 启动并检查

在项目目录运行 claude. 输入 /status 确认 Anthropic base URL 指向本站, Auth token 来源与上方配置一致. 用 /model claude-sonnet-5 选择示例模型, 再发送一个简短问题.

上方将 Haiku 别名明确指向本站已有的 Sonnet, 轻量任务也按 Sonnet 价格结算, 不是 Haiku 原版. 如果该分组以后提供 Haiku, 再按实际模型 ID 调整. VS Code 扩展和桌面应用的接入方式请按官方各客户端说明单独配置.

05 / A LITTLE BRAIN FOR YOUR BOT

AstrBot 接入 Gemini.

下图来自 AstrBot v4.28.2. 请使用 gemini 分组的本站 API Key, 按红框顺序操作; 其他版本的按钮位置可能不同.

1. 打开模型提供商, 点击新增

进入 AstrBot 管理面板, 左侧选择“模型提供商”, 在“提供商源”处点击“新增”.

AstrBot 第一步: 红框 1 为左侧模型提供商, 红框 2 为新增按钮
点击图片查看大图. 红框 1 → 红框 2.

2. 选择 Gemini OpenAI API

在新建模型提供商窗口中选择 Gemini OpenAI API. 本教程用的是 OpenAI 兼容入口, 不要选成 Gemini Compatible.

AstrBot 第二步: 红框 3 标出 Gemini OpenAI API 提供商类型
红框 3: Gemini OpenAI API.

3. 填写站点地址和密钥, 获取模型列表

ID
南北绿豆 (或自己容易辨认的名称)
API Key
自己的本站 gemini 分组密钥
API Base URL
https://hajimi.165201.xyz/v1
超时时间
可先使用截图中的 120 秒
AstrBot 第三步: 红框 4 为 ID, API Key 与 API Base URL, 红框 5 为获取模型列表
红框 4 填写配置, 红框 5 获取模型列表. 截图中的密钥已遮挡.

4. 添加模型, 保存, 再绑定到机器人

从获取的列表中添加 gemini-3.8-flash, 保存配置. 如果获取列表失败, 先核对地址和密钥分组, 确认可用后再用“自定义模型”添加同名模型. 最后在需要的配置文件或会话中选择这个模型, 向机器人发一句简短问候.

获取列表只说明能读取模型, 不代表机器人已经切换到新模型. 还需要选中模型, 保存并完成实际回复. 在本站使用日志中核对这次调用.

06 / MAKE SURE IT WORKS

看到回复, 也核对账单.

  1. 客户端有实际回复. 先发送一个简短问题, 不要直接启动长时间任务. 这次模型请求会按本站价格扣费.
  2. 本站有对应使用记录. 打开使用日志, 核对时间, 密钥名称, 模型, 分组和扣费. 没有记录时, 先检查客户端是否仍在使用原来的服务商.
  3. 再开启工作流. 按需设置密钥额度与模型权限. 模型列表, 导入提示或一次文本回复都不能代替完整工具调用兼容性验证.
WHEN SOMETHING GETS STUCK

常见问题.

401 / API Key 无效

检查是否复制了完整本站 API Key, 是否仍是占位符, 是否存在多余空格, 密钥是否已停用或过期. 后台登录密码不是 API Key. 不要把完整密钥发到群里.

模型不存在 / 无可用渠道 / 分组不匹配

核对密钥分组, 模型限制和完整模型 ID. Codex 用 GPT 分组, Claude Code 用 Claude 分组, AstrBot Gemini 用 gemini 分组. 列表中的模型不一定属于当前密钥分组; 以对应分组权限为准.

404 / 路径重复

Codex 与本教程中的 AstrBot 地址带 /v1; Claude Code 的 ANTHROPIC_BASE_URL 不带 /v1. 不要填写完整的 /v1/responses 或 /v1/messages 请求路径.

429 / 超时 / 服务暂时不可用

先停止重复并发请求, 查看错误说明与使用日志. 区分余额, 速率限制, 上游繁忙和网络超时; 重试可能产生额外费用. 连续失败时记录请求时间和请求 ID 联系售后, 不要无限重试.

CC Switch 没弹出 / 改完配置仍走旧站

确认已从官方渠道安装并打开过 CC Switch. 浏览器出现打开应用提示时自行确认. 导入后核对启用的服务商, 重启目标客户端. 手动配置与 CC Switch 不要来回覆盖; 检查原有环境变量和项目配置.

需要帮忙? 售后 QQ 群 1108263703

提供客户端名称, 模型, 错误码, 时间和请求 ID. 截图请遮住 API Key 与私人代码.