一个网关，兼容 Anthropic / OpenAI / Gemini 协议。下面是 Claude Code、Codex、cc-switch 等常用客户端的配置教程 —— 复制、粘贴、跑起来。
所有客户端的接入本质是同一件事：告诉它 网关地址 和 API Key。
# 1) 网关地址 Base URL —— 换成你自己的域名/IP BASE_URL=https://your-domain.com # 生产：域名 + HTTPS（推荐） BASE_URL=http://47.83.128.6:8080 # 或：直接 IP:端口 # 2) API Key —— 登录后台 → API 令牌 → 新建，形如 sk-xxxx API_KEY=sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxx
BASE_URL → 用管理员账号登录 → 进入「API 令牌 / API Keys」页 → 新建一个令牌 → 复制 sk- 开头的字符串。给不同用途建不同 Key，方便随时吊销。
/v1 的根地址；Codex / OpenAI 类用带 /v1 的地址。每篇教程里都写清楚了，照抄即可。
网关暴露的主要端点（相对 BASE_URL）。鉴权支持三种 Header：Authorization: Bearer sk-...、x-api-key: sk-...、Gemini 用 x-goog-api-key。
| 协议 / 客户端 | 方法 | 端点 | 说明 |
|---|---|---|---|
| Claude Code | POST | /v1/messages | Anthropic 消息接口 |
| Codex | POST | /v1/responses | OpenAI Responses API |
| Codex（直连别名） | POST | /backend-api/codex/responses | Codex 专用路径 |
| OpenAI 兼容 | POST | /v1/chat/completions | Chat Completions |
| Embeddings | POST | /v1/embeddings | 向量（仅 OpenAI 平台分组） |
| 图像 | POST | /v1/images/generations | 文生图 |
| Gemini | POST | /v1beta/models/* | Gemini 原生兼容 |
| 模型列表 | GET | /v1/models | 可用模型 |
| 健康检查 | GET | /health | 存活探针（无需鉴权） |
配任何客户端前，先用 curl 确认网关和 Key 是对的：
# 健康检查（无需 Key） $ curl $BASE_URL/health {"status":"ok"} # 带 Key 拉模型列表 $ curl $BASE_URL/v1/models \ -H "Authorization: Bearer $API_KEY" {"object":"list","data":[{"id":"claude-...","object":"model"}, ...]}
/health 返回 ok = 网关活着；/v1/models 返回模型列表 = Key 有效且分组已放开模型。若返回 401，检查 Key；返回连接拒绝，检查地址/端口/防火墙。