客户端接入概览
接入前先确认两件事：客户端只支持哪种协议、所选模型声明了哪些协议与端点。四个入口分别是 https://api.sagelib.com（OpenAI 兼容）、https://api.sagelib.com/openai、https://api.sagelib.com/anthropic、https://api.sagelib.com/gemini/v1beta。
最后更新：2026-11-14
任何 Agent 客户端接入网关，都取决于两项：客户端支持的协议、所用模型支持的协议与端点。二者确定后，对照网关入口即可完成配置。
一、确认两项前提
1. 客户端支持的协议
多数客户端仅支持单一协议：Claude Code / Claude Desktop 使用 Anthropic，Codex 使用 OpenAI Responses，Gemini CLI 使用 Gemini。PI、OMP、DeepSeek Harness 支持多种协议，可按模型选择。
2. 模型支持的协议与端点
在「模型广场」→ 模型详情页 →「模型能力」中查看：
| 端点 | 协议 |
|---|---|
/chat/completions |
OpenAI 协议、OpenAI 协议兼容 |
/responses |
OpenAI Responses |
/messages |
Anthropic 协议 |
models.generateContent |
Gemini 协议 |
同一模型可能支持多种协议，也可能仅支持一种。
二、网关入口
| 协议 | Base URL | 认证头 |
|---|---|---|
| OpenAI 协议兼容 | https://api.sagelib.com |
Authorization: Bearer <密钥> |
| OpenAI 协议 | https://api.sagelib.com/openai |
Authorization: Bearer <密钥> |
| Anthropic 协议 | https://api.sagelib.com/anthropic |
x-api-key: <密钥> |
| Gemini 协议 | https://api.sagelib.com/gemini/v1beta |
x-goog-api-key: <密钥> |
客户端协议与模型协议一致时，选用对应入口。
三、客户端配置项
各客户端界面的字段名称不一，归纳为三类：
| 配置项 | 常见字段名 |
|---|---|
| 地址 | Base URL、API 地址、接口地址、请求地址、端点 |
| 密钥 | API Key、密钥、Token |
| 模型 | Model、模型名、模型标识 |
配置要点：
- 提供「自定义」「OpenAI 兼容」供应商选项的客户端，先选择该类供应商；
- 部分客户端仅需填写 Base URL（如
https://api.sagelib.com、https://api.sagelib.com/openai），路径由客户端拼接；部分要求填写完整端点（如https://api.sagelib.com/chat/completions），以客户端提示为准； - 密钥使用「令牌管理」创建的
sk-...，模型填写「模型广场」中的模型标识。
四、常见客户端协议对照
| 客户端 | 协议 | Base URL |
|---|---|---|
| Claude Code / Claude Desktop | Anthropic | https://api.sagelib.com/anthropic |
| Codex | OpenAI（Responses） | https://api.sagelib.com/openai |
| Cursor | OpenAI 协议兼容 | https://api.sagelib.com |
| DeepSeek Harness | OpenAI / Anthropic（可配置） | https://api.sagelib.com 或 https://api.sagelib.com/anthropic |
| WorkBuddy | OpenAI 协议兼容 | https://api.sagelib.com/chat/completions |
| PI | OpenAI / Anthropic / Gemini（可配置） | https://api.sagelib.com/openai/v1 等 |
| OMP | 同 PI | 同上 |
| Gemini CLI | Gemini | https://api.sagelib.com/gemini/v1beta |
| Grok Build / OpenCode / OpenClaw / Hermes / MiniMax Code | OpenAI 协议兼容（以客户端文档为准） | https://api.sagelib.com |
五、协议不一致时的处理
网关不提供跨协议转换。当客户端仅支持协议 A、而所用模型仅支持协议 B 时（例如 Codex 仅支持 /responses，模型仅支持 /chat/completions），需在本地部署支持协议转换的路由服务（路由模式）：客户端请求先发送至该服务，再由其按模型支持的协议转发至网关。
六、验证
在客户端新建对话并发送一条消息，能收到回复即为接入成功；随后在控制台「用量日志」中确认该次调用（入口与协议应与客户端配置一致）。