MOEROUTER · 文档
一个 Key,
接入你熟悉的 AI 工具
Claude Code、Codex、Gemini CLI 和各种聊天客户端,换一个接口地址和 Key 就能用。三分钟发出第一个请求。
接口地址https://moerouter.com
OpenAI 兼容客户端、Codex…/v1
Claude Code、Gemini CLI不带 /v1
Keysk-…
开始
三步开始#
- 登录并创建 API Key用 Doc2X、Google 等账号登录控制台,在“API 密钥”里创建。
- 挑一个模型在模型广场复制模型 ID,例如
claude-opus-5-5、gpt-6.1-sol。 - 把客户端指向 MoeRouter换掉接口地址和 Key,其他照旧。
- QUICKSTART三分钟上手从登录到在使用日志里看到第一条记录,含 cURL、Python、Node.js 示例。开始 →
- GENERATOR配置生成器选客户端和模型,直接得到可以粘贴的配置。Key 只留在你的浏览器里。生成配置 →
接入客户端
选择你的客户端#
不确定选哪个?先看选择接入方式。每一篇都在真机上实测过,带截图。
- 推荐 · 一键导入CC Switch从控制台一键导入,同时管好 Claude Code、Codex 和 Gemini CLI。查看教程 →
- ANTHROPIC MESSAGESClaude Code两个环境变量,或写进
settings.json。查看教程 → - OPENAI RESPONSESCodex在
config.toml里加一个 provider,CLI 和桌面应用通用。查看教程 → - GEMINI 原生接口Gemini CLI认证方式和“受信任文件夹”是两个常见的坑。查看教程 →
- 第三方推理Claude Desktop直连用 Claude 模型,或经 CC Switch 映射成 GPT、DeepSeek。查看教程 →
- SDK · 聊天客户端OpenAI / Anthropic SDK自己写代码,或接入 Cherry Studio 这类聊天客户端。查看教程 →
- 本地网关Magpie多个 Agent 共用一个模型来源,统一看用量。查看教程 →
- 本地网关AstrLink本地令牌、请求记录和隐私检查。查看教程 →
了解 MoeRouter
它是怎么工作的#
同一个模型背后有多条线路。下面几篇说明请求怎么选线路、怎么计费、接口怎么对应。
- ROUTING动态路由低价优先、故障切换、线路休息。附一个可以动手试的演示。了解 →
- AFFINITY会话亲和与缓存同一段对话尽量留在同一条线路上,缓存才能命中。了解 →
- GROUPS分组与倍率default、stable、vertex、google-proxy 各是什么,怎么选。了解 →
- BILLING计费与额度参考价和实际扣费的关系,缓存怎么算,Key 的额度上限。了解 →
- ENDPOINTS接口与协议四种接口各自的地址、认证方式,和模型的对应关系。了解 →
排错