MoeRouter 文档 获取 API Key

选择接入方式

按你的情况选一条接入路线,并记住各客户端的接口地址写法:哪些要带 /v1,哪些不带。

更新于 2026-11-15 阅读约 2 分钟

本页目录
  1. 先选一条路线
  2. 接口地址:最容易填错的地方
  3. 模型和客户端要配对
  4. 各客户端教程

先选一条路线#

你的情况 推荐路线 要常驻后台吗
第一次用,想最快配好 Claude Code、Codex 或 Gemini CLI CC Switch 一键导入 不需要
只用一两个工具,愿意自己改配置文件 手动配置:Claude Code、Codex、Gemini CLI 不需要
想在 Claude Desktop 里用 GPT、DeepSeek 等非 Claude 模型 Claude Desktop + CC Switch 模型映射 需要,CC Switch 保持运行
自己写代码,或者用 Cherry Studio 这类聊天客户端 SDK 与聊天客户端 不需要
多个 Agent 共用一个模型来源,想统一看用量 Magpie 需要
想要本地令牌、请求记录和隐私检查 AstrLink 需要

不想看教程?用配置生成器选好客户端和模型,直接复制配置。

同一个客户端只选一个“管理者”

CC Switch、Magpie、AstrLink 和手动编辑改的是同一批配置文件,例如 ~/.claude/settings.json、~/.codex/config.toml。轮流用多个工具时,以最后写入的内容为准。排查问题先看文件里最终是什么。

接口地址:最容易填错的地方#

MoeRouter 只有一个根地址 https://moerouter.com。区别在于要不要自己加 /v1:有的客户端会自动拼接后面的路径,有的不会。

客户端或字段 填写 说明
Claude Code 的 ANTHROPIC_BASE_URL https://moerouter.com 不带 /v1,客户端自己拼 /v1/messages
Claude Desktop 的 Gateway base URL https://moerouter.com 同上
Gemini CLI 的 GOOGLE_GEMINI_BASE_URL https://moerouter.com 不带 /v1beta
Codex 的 base_url https://moerouter.com/v1 要带 /v1,客户端拼 /responses
OpenAI SDK、大多数聊天客户端 https://moerouter.com/v1 要带 /v1
Anthropic SDK 的 base_url https://moerouter.com 不带 /v1

不要把完整的 /v1/messages、/v1/responses 填进地址栏。CC Switch 和 Magpie 有自己的字段规则,对应的教程里另有说明。

模型和客户端要配对#

客户端用什么接口,模型就必须支持什么接口。模型支持的接口写在模型广场每张卡片的“端点”一栏。

客户端 用的接口 模型需要有的端点
Claude Code、Claude Desktop Anthropic Messages anthropic
Codex OpenAI Responses openai-response
Gemini CLI Gemini 原生接口 gemini
OpenAI SDK、聊天客户端 OpenAI Chat Completions openai

用错接口时会收到 404 和一句提示,告诉你这个模型该用哪个接口,见报错对照表。

各客户端教程#

↑↓ 选择Enter 打开可以直接粘贴报错原文