Skip to main content
XRouter 提供统一的 API Key 和兼容接口,让应用代码、AI 编程工具和本地 Provider 管理工具都能接入同一个服务地址。
本文档默认 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

出现问题时查看日志

请求失败时先确认认证头、模型名和服务地址,再到控制台用量日志里定位具体请求。

核心端点

如果你只需要兼容 OpenAI SDK,通常只要把 base_urlbaseURL 改成 https://api.xrouter.dev/v1,再使用 XRouter API Key。