深色模式
Base URL 与兼容性
配置错误里最常见的就是 Base URL 填错。这一页把规则集中说清楚。
一张表记住
| 工具 / SDK 类型 | Base URL | 示例工具 |
|---|---|---|
| OpenAI 协议 | https://aimoniker.top/v1 | OpenAI SDK、Codex CLI、Cursor、Cline、OpenCode |
| Anthropic 协议 | https://aimoniker.top | Claude Code、Anthropic SDK |
| Gemini 协议 | https://aimoniker.top | Gemini CLI、google-genai SDK |
正确与错误写法
| 场景 | ✅ 正确 | ❌ 错误 |
|---|---|---|
| Claude Code | ANTHROPIC_BASE_URL=https://aimoniker.top | https://aimoniker.top/v1（会变成 /v1/v1/messages） |
| OpenAI SDK | base_url="https://aimoniker.top/v1" | https://aimoniker.top（缺 /v1，报 404） |
| Codex | base_url = "https://aimoniker.top/v1" | https://aimoniker.top/v1/responses（不要写到具体接口） |
| 任何地方 | https://aimoniker.top | 结尾多一个 /、写成 http:// |
| 密钥 | sk-xxxx | Bearer sk-xxxx（工具会自动加 Bearer） |
软件会自动补 /v1 吗？
有些客户端（如 Cherry Studio 的 OpenAI 类型）会自动在地址后补 /v1，此时填 https://aimoniker.top。拿不准就两种都试一下：报 404 说明 /v1 多了或少了。
协议兼容性矩阵
不同模型系列能用哪些接口：
| 模型系列 | Chat Completions/v1/chat/completions | Messages/v1/messages | Responses/v1/responses | Gemini 原生/v1beta/models/... |
|---|---|---|---|---|
| Claude | ✅ | ✅ 推荐 | — | — |
| GPT / Codex | ✅ | — | ✅ 推荐 | — |
| Gemini | ✅ | — | — | ✅ 推荐 |
| 国产（DeepSeek / GLM / Kimi / Qwen） | ✅ 推荐 | 视分组 | — | — |
| Grok | ✅ | — | — | — |
- "推荐"表示该协议能完整使用模型能力（思考、缓存、工具调用等）。
国产模型-oai分组仅提供 OpenAI 协议，在 Claude Code 中使用需要配合 claude-code-router 之类的路由工具。
分组对客户端的限制
部分 Claude 分组只允许 Claude Code（或 Claude 官方客户端）调用，详见 分组选择指南：
| 只允许 Claude Code | 不限客户端 |
|---|---|
ccmax-cheap、claude-max、claude-max-vip、ccmax-ext | claude-pro、claude-pro-cheap、claude-ultra、claude-ultra-cheap、ccmax-ext-cheap、Aws_Bedrock_Claude |
