什么时候用这个
如果你想:
- 让 Claude Code 调用 DeepSeek 模型,同时保留一键回退到官方配置的能力。
- 想要一个 claude-code-router 这类单客户端路由工具的本地替代方案。
- 在官方 Claude Code 配置和 MuxLayer 配置之间一键切换。
- 用一个 Route Profile,以后随时把 Claude Code 在 DeepSeek、MiMo、Anthropic、GitHub Copilot、Kimi 等 Provider 之间切换。
快速配置
- 从 Releases 下载 MuxLayer 并打开应用。
- 进入 快速配置 或 供应商。
- 添加 DeepSeek Provider,粘贴你的 DeepSeek API Key。
- 在 概览 或 网关 启动网关。默认客户端端点是
http://127.0.0.1:9090。 - 打开 客户端,在 Claude Code 卡片上点 应用配置。
- 在 Claude Code 里发一条测试消息。
- 确认请求出现在 MuxLayer 的 日志 里,Provider 和路由符合预期。
MuxLayer 配置了什么
| Claude Code 侧 | MuxLayer 侧 | DeepSeek 侧 |
|---|---|---|
| Anthropic Messages API | /v1/messages 本地网关路由 |
DeepSeek 的 Anthropic 兼容或 Chat 兼容上游 |
| Claude 模型名 | Model Mapping 或 agentgate 虚拟模型 |
DeepSeek 模型 ID |
| 工具调用和流式输出 | 协议感知路由和追踪 | DeepSeek 专属处理 |
给 claude-code-router 用户的说明
MuxLayer 不是 claude-code-router 的 drop-in 复刻。它是一个桌面控制台,同时支持 Codex、Gemini CLI、OpenCode,覆盖 Provider 故障转移、成本看板、诊断、请求追踪、一键还原客户端配置。
如果你只需要一个小巧的 Claude Code 路由工具,claude-code-router 就够了。如果你想要一个本地模型入口同时服务多个 AI agent 客户端,用 MuxLayer。
排查
| 现象 | 检查 |
|---|---|
| Claude Code 还在调用官方 endpoint | 回到 客户端,重新应用一次 Claude Code 配置。 |
| DeepSeek 返回模型错误 | 检查 Provider 的默认模型和 Model Mapping。 |
| 工具调用失败 | 看请求日志,确认所选上游支持工具调用。 |
| 网关无法连接 | 确认 MuxLayer 在 127.0.0.1:9090 上运行;1420 只是开发用的 UI 端口。 |