接入流程
接入任何客户端都是同一条链路：先确认客户端认哪种协议，再复制 Base URL、创建令牌、选模型记下标识，把三样填进客户端，最后发一句话验证。
最后更新：2026-11-14
不管用哪个 Agent 客户端，接入都是同一套动作。先把下面几步走通，剩下的只是「填在客户端的哪个位置」不同。
第 1 步 · 确定客户端认哪种协议
对照下表选中你的客户端要用的协议与 Base URL（细节见 获取 Base URL）：
| 客户端 | 认的协议 | Base URL |
|---|---|---|
| Claude Code / Claude Desktop、Anthropic SDK | Anthropic | https://api.sagelib.com/anthropic |
| OpenAI SDK、Codex、Cursor、PI / OMP | OpenAI | https://api.sagelib.com/openai |
| 只填「OpenAI 兼容 / 自定义接口地址」的 GUI | OpenAI 协议兼容 | https://api.sagelib.com（站点根，不加后缀） |
| Google GenAI SDK | Gemini | https://api.sagelib.com/gemini/v1beta |
第 2 步 · 复制 Base URL
拿到上面四个地址之一。不要自己给地址再加 /v1（多数客户端会自己补，加了会变成双 /v1 导致 404）。
第 3 步 · 创建并复制 API 令牌
「令牌管理」→「新建令牌」→ 填名称 → 创建 → 复制 sk- 开头的密钥。密钥只在创建时完整显示一次。
第 4 步 · 选模型、记下模型标识
「模型广场」里挑一个模型 → 进详情页 → 复制它的 模型标识（例如 gpt-5.6-terra）。
两个要点：调用时 model 字段填模型标识而不是展示名；这个模型必须支持你第 1 步选的协议。
第 5 步 · 填三样东西
进入该 Agent 客户端的模型/API 设置，填：Base URL、API Key（sk- 密钥）、模型名（模型标识）。
第 6 步 · 发一句验证
保存后新开对话，发送「你好」。能收到回复就接好了；报错按 接入报错排查 逐条对照。
一句话记忆：地址看 获取 Base URL，密钥在「令牌管理」，模型名在「模型广场」详情页。
下面的三篇是各步骤的细节，逐客户端操作见「常见 Agent 接入」。