先选一条路线#
| 你的情况 | 推荐路线 | 要常驻后台吗 |
|---|---|---|
| 第一次用,想最快配好 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 和一句提示,告诉你这个模型该用哪个接口,见报错对照表。