主题
选择接入方式
Zivv 同时支持 OpenAI、Anthropic 和 Gemini 三种协议。先按你的工具选择接入方式，再进入对应的详细指南。
不确定怎么选？
- 使用 Claude Code / Claude Desktop：选 Anthropic 协议
- 使用 Codex / OpenAI SDK / 支持自定义 OpenAI Base URL 的客户端：选 OpenAI 协议
- 使用 Cursor / Windsurf：先阅读兼容性说明；官方当前未承诺任意自定义 Base URL 的稳定支持
- 使用 Google Gen AI SDK / Gemini 原生客户端：选 Gemini 协议
接入方式速查
| 场景 | 推荐协议 | Base URL | 详细指南 |
|---|---|---|---|
| Claude Code | Anthropic | https://zivv.pro | Claude Code |
| Claude Desktop | Anthropic | https://zivv.pro | Claude Desktop |
| Codex CLI | OpenAI Responses | https://zivv.pro/v1 | Codex CLI |
| ChatGPT Desktop（Codex） | OpenAI Responses | https://zivv.pro/v1 | 桌面端指南 |
| Cursor / Windsurf | 兼容性取决于客户端当前能力 | 不保证可配置 | Cursor 说明 · Windsurf 说明 |
| OpenAI SDK | OpenAI 兼容 | https://zivv.pro/v1 | OpenAI SDK |
| Anthropic SDK | Anthropic | https://zivv.pro | Anthropic SDK |
| Google Gen AI SDK | Gemini 原生 | https://zivv.pro/v1beta | Gemini 原生协议 |
| 其他第三方客户端 | 通常为 OpenAI 兼容 | https://zivv.pro/v1 | 其他客户端 |
开始前的共同准备
无论使用哪种客户端，都建议先完成下面四步：
一个客户端一个 Key
不要在所有设备和应用中复用同一个 Key。按「客户端 + 设备」命名，例如 codex-workstation、backend-staging，便于查看用量、设置额度和单独吊销。
三种协议的区别
| 对比项 | OpenAI | Anthropic | Gemini |
|---|---|---|---|
| 认证头 | Authorization: Bearer ... | x-api-key: ... | x-goog-api-key: ... |
| 常用端点 | /v1/chat/completions、/v1/responses | /v1/messages | /v1beta/models/{model}:generateContent |
| 流式输出 | 支持 | 支持 | 支持 |
| 典型客户端 | Codex、OpenAI SDK、可配置 Base URL 的第三方客户端 | Claude Code、Claude Desktop | Google Gen AI SDK |
| 推荐用途 | 通用 SDK、编程客户端、图像接口 | Claude 原生工具调用 | Gemini 原生多模态请求 |
完整差异见 协议与兼容性。