集成指南总览
TokenSG 同时兼容 OpenAI Chat Completions 协议与 Anthropic Messages 协议（/v1/chat/completions + /v1/messages），几乎所有主流开发者 CLI、IDE 插件、SDK 都能零代码接入。下表覆盖 5 种我们正式测试过的集成；其他 OpenAI 兼容工具请参考 通用 OpenAI 兼容工具 页面。
已支持的集成
| 集成 | 协议 | 指南 |
|---|---|---|
| Claude Code | Anthropic Messages（/v1/messages） | Claude Code |
| OpenCode | OpenAI Chat 或 Anthropic Messages | OpenCode |
| OpenAI Codex CLI | OpenAI Chat（wire_api = "chat"） | Codex CLI |
| Gemini CLI | 局限（仅原生支持 Google GLA）— 推荐改用 OpenAI 兼容 CLI | Gemini CLI |
| 通用 OpenAI 兼容工具 | OpenAI Chat — Cursor、Cline、Continue.dev、Vercel AI SDK、LangChain、LlamaIndex 等 | OpenAI 兼容工具 |
不确定选哪个？
| 你的主要目标 | 推荐路径 |
|---|---|
| 在专用 agentic CLI 里跑 Claude 模型 | Claude Code 或 OpenCode（Anthropic 模式） |
| 在终端 coding agent 里跑 GPT-4o / o3 / o4-mini | OpenAI Codex CLI 或 OpenCode（OpenAI 模式） |
| 编程调用 Gemini 模型 | 任意 OpenAI 兼容 CLI + model: "gemini-2.5-pro" — TokenSG 内部路由到 Google GLA / Vertex（Gemini CLI 本身不适合主用，详见 Gemini CLI） |
| 在 Cursor / Cline / Continue / Zed / Vercel AI SDK / LangChain / 任意 IDE 插件 中驱动 TokenSG | 通用 OpenAI 兼容 — 改 base_url 即可 |
| 在 Python / Node.js / Go 里编程调用 | OpenAI SDK + base_url = https://api.tokensg.ai/v1，参考 快速开始 |
通用要点
- OpenAI 兼容端点：
https://api.tokensg.ai/v1 - Anthropic 兼容端点：
https://api.tokensg.ai（SDK 自动拼接/v1/messages） - 认证：
Authorization: Bearer sk-xxx；TokenSG 不接受 Anthropic 风格的x-api-key - 验证方式： 打开 TokenSG 控制台 查看 请求日志 / 本日消费，看到新记录即接入成功
没有你用的工具？
任何允许修改 OpenAI base URL 的工具都能按 通用 OpenAI 兼容工具 文档接入。如希望我们新增独立指南页，欢迎到 github.com/xmai-ai/xmai-docs 提交 PR。