本文档默认 API 服务地址为
https://api.xrouter.dev。如果控制台显示了不同的服务地址,请以控制台中的 server_address 为准。先选你的接入方式
应用代码 / OpenAI SDK
把 SDK 的 base URL 改成 XRouter,继续使用 OpenAI 兼容调用方式。
Claude Code
通过 Anthropic Messages 兼容接口,把 Claude Code 指向 XRouter。
Codex CLI
在 Codex CLI 中添加 XRouter 自定义模型供应商。
CC-Switch
用图形界面管理 Claude、Codex 和 Gemini Provider。
推荐阅读顺序
1
完成快速开始
创建 API Key,确认服务地址,并用
/v1/models 和 Chat Completions 验证密钥可用。2
确认接口格式
如果你还没决定使用哪种接口,先阅读“选择接入方式”,再进入对应工具或 API 页面。
3
接入你的工具或应用
应用代码优先看 OpenAI SDK;Claude Code、Codex CLI 和 CC-Switch 分别有独立配置页。
4
出现问题时查看日志
请求失败时先确认认证头、模型名和服务地址,再到控制台用量日志里定位具体请求。