接入点与 API 格式
QCode.cc 的两种 API 协议（Anthropic / OpenAI）、四个接入域和 BASE_URL 填写指南
接入点与 API 格式¶
本页统一讲清 QCode.cc 的两种 API 协议、四个接入域名与 BASE_URL 的正确填法。同一个 API Key 两种协议都可用，协议由你请求的路径决定，服务端自动路由。
1. 两种 API 协议¶
QCode.cc 后端同时兼容 Anthropic Messages 和 OpenAI 两种协议：
| 协议 | 典型客户端 | 路径 |
|---|---|---|
| Anthropic Messages | Claude Code / Claude Agent SDK / Cline / Aider | /api/v1/messages 或等价的 /claude/v1/messages |
| OpenAI Chat Completions | OpenAI 官方 SDK / LangChain 等通用客户端 | /openai/v1/chat/completions |
| OpenAI Responses | Codex CLI（必须用这个） | /openai/v1/responses |
请求体 schema 与对应官方 API 保持一致（Anthropic POST /v1/messages / OpenAI POST /v1/chat/completions / OpenAI POST /v1/responses）。
注意：
/api、/claude、/openai/v1本身都是路径前缀，不是独立端点。SDK 会把/v1/messages、/chat/completions、/responses等自动拼到后面。直接curl https://api.qcode.cc/api会收到 404，这是正常现象。
2. 四个接入域名¶
四个域名业务能力完全一致，差异只在网络路由：
| 域名 | 面向 | 协议 | 说明 |
|---|---|---|---|
api.qcode.cc |
全球（Route 53 就近） | HTTPS | 海外首选，自动选择延迟最低节点 |
us.qcode.cc |
北美 | HTTPS | 洛杉矶节点，2026-04-22 上线 |
eu.qcode.cc |
欧洲 | HTTPS | 法兰克福节点 |
asia.qcode.cc |
亚洲 | HTTPS | 香港节点 |
103.236.53.153 |
中国大陆 | HTTP | 深圳直连，延迟最低（裸 IP） |
同一个 API Key 在四个域下都能用，随意切换即可。中国大陆建议使用 103.236.53.153（HTTP，注意不是 HTTPS）以获得最佳延迟。
3. BASE_URL 填写对照表¶
根据你使用的工具，按下表填写：
| 工具 | 环境变量 / 配置键 | 填写值 | SDK 会拼成 |
|---|---|---|---|
| Claude Code | ANTHROPIC_BASE_URL |
https://api.qcode.cc/api |
/api/v1/messages |
| Claude Agent SDK | base_url= 构造参数 |
https://api.qcode.cc/api |
/api/v1/messages |
| Cline / Aider | Anthropic 模式 base URL | https://api.qcode.cc/api |
/api/v1/messages |
| OpenAI Python/JS SDK | base_url= 构造参数 |
https://api.qcode.cc/openai/v1 |
/openai/v1/chat/completions |
| Codex CLI | TOML 配置 base_url = |
https://api.qcode.cc/openai |
/openai/v1/responses |
中国大陆用户把域名前缀 https://api.qcode.cc 换成 http://103.236.53.153 即可（注意是 HTTP）。
4. curl 自测¶
路径是否可达、网络是否通畅，用 curl 发一个 POST 即可判断：
# Anthropic 协议路径测试
curl -X POST https://api.qcode.cc/api/v1/messages
# → 返回 401 = 路径通过了，只是缺 Authorization header（预期结果）
# OpenAI Chat Completions 协议路径测试
curl -X POST https://api.qcode.cc/openai/v1/chat/completions
# → 返回 401 = 路径通
# OpenAI Responses 协议（Codex 用）
curl -X POST https://api.qcode.cc/openai/v1/responses
# → 返回 401 = 路径通
解读：401 Unauthorized 表示路径映射正确、网络通到位，只是没带认证头 — 这是好消息。如果返回 404 说明路径前缀错了，需对照上面第 3 节的表修正。
带真实 API Key 做端到端测试：
curl -X POST https://api.qcode.cc/api/v1/messages \
-H "x-api-key: YOUR_KEY" \
-H "anthropic-version: 2023-06-01" \
-H "content-type: application/json" \
-d '{"model":"claude-sonnet-4-5","max_tokens":64,"messages":[{"role":"user","content":"ping"}]}'
切换到 us.qcode.cc / eu.qcode.cc / asia.qcode.cc 的相同路径，应得到一致结果 — 能验证该备用接入点对你可用。
5. 常见问题¶
Q：为什么 curl https://api.qcode.cc/api 返回 404？
A：/api 是路径前缀，不是端点。完整路径是 /api/v1/messages。
Q：/api/v1/messages 和 /claude/v1/messages 有区别吗？
A：没有。两种前缀都被路由到 Anthropic Messages 协议，SDK 配哪个都行。我们文档默认用 /api 前缀，因为这是多数 Claude 生态 SDK 的默认路径。
Q：同一个 API Key 同时能调 Claude 和 Codex 吗？
A：可以。Key 不区分协议，协议由你请求的路径决定。路径走 /api/v1/messages 就是 Anthropic，走 /openai/v1/responses 就是 OpenAI Responses。
Q：我应该选哪个接入域？
A：中国大陆 → 103.236.53.153（深圳直连 HTTP）；其他地区 → api.qcode.cc（全球路由）。如果主用域不稳，随意切到 us / eu / asia 备用。
Q：BASE_URL 填的时候要不要带尾部斜杠？
A：不要带。大多数 SDK 会自动拼 /v1/messages 等后缀，如果你把尾斜杠带上了，会拼成 //v1/messages 导致 404。