工具接入概览
连接 OpenAI SDK 和兼容客户端。
准备连接信息
准备网关地址、XHub 虚拟密钥和公开模型名。Base URL 使用调试台相同的网关根地址，不额外添加 /v1，字段名以工具版本为准。
选择接入方式
Python 应用参考 SDK 示例；支持自定义 OpenAI 端点的工具参考客户端配置。只支持固定供应商地址的工具无法直接改用网关。
验证兼容性
先读取模型列表再发最小对话请求。Responses、图片、音频和流式功能需相应部署协议支持，连接成功不代表全部功能可用。
按协议选择工具
| 工具 | 协议 | Base URL |
|---|---|---|
| OpenAI SDK、Cursor、Cline、Chatbox | Chat completions | 调试台的网关根地址 |
| Codex CLI | Responses | 调试台的网关根地址 |
| Claude Code | Messages | 不含 /v1 的根地址 |
| OpenCode 与 Agent 框架 | 所选适配器 | 核对供应商设置 |
目录提供各工具独立指南。XHub 没有第三方工具自动配置安装器。获取模型列表成功不代表所有模型能力已验证。