Flexgate 文档

本地 Anthropic API 网关：根据请求中的 model 名称，把流量自动路由到不同的 provider，并附带 Claude Code settings.json 的自动管理、多 key fallback、 用量查询和配置同步能力。

解决什么问题

Claude Code 只能配置一个 ANTHROPIC_BASE_URL，所有 tier（opus/sonnet/haiku） 都指向同一个 provider。Flexgate 在本地启动一个 Anthropic 兼容端点，按 model 名称把请求路由到不同 provider：

Claude Code → localhost:8765 → opus  → z.ai (glm-5.1)
                           → sonnet → minimax (MiniMax-M3)
                           → haiku  → minimax (MiniMax-M3)

备注

运行原则：持久化只走 service。 Linux 上的持久化 serve 只由 systemd 用户 服务 flexgate.service 管理。flexgate run 仅用于前台调试。

特性一览

  • 按 model 路由：正则匹配请求中的 model 字段，首个命中生效，支持兜底路由

  • 定时路由：按时间窗口自动切换路由（支持跨夜，如 22:00-06:00）

  • 多 key fallback：同一上游配置多个 key，遇到 401/402/403/429/5xx/529 或连接错误时自动切换到下一个 key

  • 用量查询：flexgate status / flexgate usage 按平台适配器查询每个 key 的实时额度（MiniMax、Kimi Code、z.ai、LiteLLM 等）

  • Claude Code settings 管理：import / apply 双向同步

  • 配置同步：flexgate sync 通过 confsync 服务器加密同步配置

  • 自愈升级：flexgate doctor 体检、flexgate update 一键升级并迁移配置

目录

链接