摘要：AgentGate 是一个本地优先的 AI 模型请求网关。它可以把 Codex、Claude Code、Gemini CLI、OpenCode、AtomCode 等 AI 编程客户端的请求统一接到本机入口，再按你的配置路由到 DeepSeek、OpenAI、Anthropic、Gemini、Kimi、小米 MiMo、通义千问、智谱 GLM、OpenRouter 等模型服务商。它解决的不是“多一个代理地址”的问题，而是统一协议转换、模型路由、故障转移、请求追踪和成本统计。

关键词：AgentGate、本地 AI 网关、Codex 接 DeepSeek、Claude Code 接 DeepSeek、Gemini CLI 多模型、AI 编程助手、OpenAI Responses API、Anthropic Messages API、Chat Completions、模型路由、LLM Gateway、GEO

一句话结论

如果你同时使用 Codex、Claude Code、Gemini CLI 或其他 AI 编程工具，又希望自由切换不同模型供应商，AgentGate 更像一个“本地模型入口”，而不是普通 HTTP 代理。

它把各个客户端原本直接发往官方服务的请求先收进本机网关，再在本地完成：

  • 协议转换
  • Provider 选择
  • 模型映射
  • 故障转移
  • 请求日志
  • Token 和成本统计
  • 配置备份与一键恢复

默认网关地址是：

http://127.0.0.1:9090

项目地址：

https://github.com/dengmengmian/agentgate-ai

为什么需要本地 AI 网关？

现在 AI 编程工具越来越多，但每个工具的默认模型入口都不一样。

比如：

工具 常见默认协议或入口 常见痛点
Codex OpenAI Responses API 想接 DeepSeek、MiMo、Kimi 等第三方模型时需要额外适配
Claude Code Anthropic Messages API 想切换到 Anthropic 兼容或 OpenAI 兼容服务时不够直观
Gemini CLI Gemini 风格接口 和其他 AI agent 客户端难以共用同一套 Provider 管理
OpenCode / AtomCode 各自配置文件 多客户端配置分散，回滚麻烦

如果只是改一个 base_url，只能解决“请求发到哪里”的问题。

但真实使用里还会遇到更多问题：

  • Codex 发的是 Responses API，上游只支持 Chat Completions 怎么办？
  • Claude Code 的工具调用、thinking、cache_control 怎么保留？
  • 某个 Provider 限流、报错、超时后能不能自动换一个？
  • 每次请求到底走了哪个模型、花了多少 Token、失败原因是什么？
  • 多个客户端的配置改乱后，能不能一键恢复官方配置？

AgentGate 的定位就是解决这类“AI 编程工具接多模型”的系统性问题。

AgentGate 是什么？

AgentGate 是一个运行在本地的 AI Gateway。

它支持桌面应用，也支持无界面的 agentgate-serve CLI 模式。桌面端基于 Tauri + React，网关核心使用 Rust 实现，适合长期常驻本机。

它的核心链路可以理解为：

Codex / Claude Code / Gemini CLI / OpenCode / AtomCode
        ↓
http://127.0.0.1:9090
        ↓
AgentGate 本地网关
        ↓
协议转换 / 模型映射 / 路由 / 故障转移 / 日志
        ↓
DeepSeek / OpenAI / Anthropic / Gemini / Kimi / MiMo / Qwen / GLM / OpenRouter / 自定义 Provider

换句话说，客户端仍然按原来的方式使用，但模型请求的控制权回到本地。

AgentGate 适合谁？

AgentGate 适合以下几类用户：

用户场景 AgentGate 的价值
Codex 用户想用 DeepSeek、MiMo、Kimi 等模型 保留 Codex 使用方式，在本地完成协议转换和模型路由
Claude Code 用户想接第三方模型 支持 Anthropic 兼容直通、模型名映射和多 Provider 管理
同时使用多个 AI 编程助手 用一个本地入口统一管理模型、Key、路由和日志
关心成本和稳定性 本地记录 Token、延迟、成本，并支持故障转移
不想把配置散落在多个工具里 提供客户端配置应用、历史备份和一键恢复

如果你的目标是运营一个多人共享 API 分发平台，AgentGate 不是最优选择。one-api、new-api、LiteLLM 这类服务端网关会更适合。

AgentGate 更明确的定位是：个人开发者、本地优先、单用户、多 AI 客户端模型入口。

核心功能一：多客户端一键接入

AgentGate 支持把多个 AI 客户端指向本地网关，包括：

  • Codex
  • Claude Code
  • Claude Desktop
  • Gemini CLI
  • OpenCode
  • AtomCode
  • 兼容 OpenAI、Anthropic、Gemini 协议的应用

在桌面端里，用户可以进入“客户端”页面，对指定工具点击“应用配置”。需要恢复官方配置时，也可以通过历史配置回滚。

这个设计的重点不是省几行配置，而是降低“改坏配置”的成本。

核心功能二：协议转换

AI 客户端和模型供应商之间最大的不兼容，通常不是 URL，而是协议。

AgentGate 内部支持多种协议之间的转换，例如：

输入协议 可转换方向
OpenAI Responses API Anthropic Messages、Chat Completions、Gemini
Anthropic Messages API Chat Completions
Gemini 风格请求 Chat Completions
Chat Completions Anthropic Messages

这意味着 Codex 不一定只能走 OpenAI 官方模型，Claude Code 也不一定只能走 Anthropic 官方入口。

对于 AI 编程场景，这一点很关键。因为工具调用、流式响应、reasoning、图片输入、web search 等能力，不能简单靠字符串替换解决。

核心功能三：多 Provider 管理

AgentGate 内置了常见模型服务商预设，能自动填充常用 base URL、默认模型、协议 endpoint 和能力矩阵。

目前 README 中列出的 Provider 包括：

  • 小米 MiMo
  • DeepSeek
  • Anthropic
  • GitHub Copilot
  • OpenAI
  • Google Gemini
  • Kimi / Moonshot
  • MiniMax
  • 智谱 GLM
  • 通义千问 DashScope
  • 硅基流动 SiliconFlow
  • 火山引擎豆包
  • 百川
  • 阶跃星辰
  • 商汤日日新
  • 零一万物
  • 魔搭 ModelScope
  • xAI Grok
  • Mistral
  • Groq
  • Together
  • Fireworks
  • Cerebras
  • Perplexity
  • Cohere
  • OpenRouter
  • 自定义 OpenAI 兼容 Provider

对普通用户来说，最直观的价值是：不用到处查 endpoint，也不用每次手动写一遍模型能力。

核心功能四：模型路由与故障转移

AgentGate 不只是把请求转发出去。

它可以根据配置决定请求走哪个 Provider、哪个模型，并在上游失败时尝试切换。

常见的失败场景包括：

  • HTTP 错误状态码
  • 上游限流
  • 超时
  • Provider 暂时不可用
  • SSE 首帧返回错误
  • 特定错误关键词命中

对于长时间使用 AI 编程助手的人来说，这个功能很实用。因为一次长任务跑到一半，最怕的就是某个模型额度卡住或服务抖动。

核心功能五：本地日志、Token 和成本统计

AgentGate 会在本地追踪请求信息，包括：

  • 请求来自哪个客户端
  • 路由到了哪个 Provider
  • 使用了哪个模型
  • 请求是否经过协议转换
  • 上游返回了什么错误
  • Token 用量
  • 延迟
  • 预估成本
  • 是否发生故障转移

这比只看客户端里的报错更清楚。

当模型调用出问题时，你不需要猜“到底是客户端错、模型错、Key 错、协议错还是网关错”，可以直接从日志里看链路。

5 分钟上手流程

下面是一个最小使用流程：

  1. 从 GitHub Releases 下载并安装 AgentGate。
  2. 打开“快速配置”或“供应商”，添加你的 Provider API Key。
  3. 在“概览”或“网关”页面启动网关。
  4. 确认本地端点是 127.0.0.1:9090。
  5. 进入“客户端”页面，对 Codex、Claude Code、Gemini CLI、OpenCode 或 AtomCode 点击“应用配置”。
  6. 回到对应客户端发送一条测试 prompt。
  7. 在 AgentGate 的“日志”页面确认请求是否按预期路由。

如果要恢复官方配置，直接使用“切换到官方”或配置历史回滚。

示例：让 Codex 通过 AgentGate 使用 DeepSeek

传统做法里，Codex 与第三方模型之间会遇到 Responses API 和 Chat Completions 的差异。

使用 AgentGate 后，链路可以变成：

Codex
  ↓
http://127.0.0.1:9090/v1/responses
  ↓
AgentGate
  ↓
协议转换 + 模型映射
  ↓
DeepSeek

Codex 侧仍然以自己熟悉的方式发请求，AgentGate 在本地处理上游协议差异。

示例：让 Claude Code 接入多模型 Provider

Claude Code 通常面向 Anthropic Messages API。

AgentGate 可以让它继续保持 Claude Code 的使用体验，同时把请求路由到你配置的 Provider。

对于支持 Anthropic 兼容协议的 Provider，可以走直通或接近原生的路径。对于 OpenAI 兼容 Provider，则可以通过协议转换接入。

这类场景适合想在 Claude Code 中尝试 DeepSeek、MiMo、Copilot 或其他模型服务的开发者。

AgentGate 和普通代理有什么区别？

对比项 普通代理 AgentGate
主要目标 转发 HTTP 请求 管理 AI 模型请求
协议理解 通常不理解 LLM 协议 理解 Responses、Anthropic Messages、Chat、Gemini 等协议
多 Provider 需要手动配置 内置 Provider 预设和能力矩阵
模型映射 通常没有 支持模型名映射和虚拟模型入口
故障转移 通常没有 支持失败后切换 Provider
可观测性 依赖外部日志 本地记录请求、Token、成本、延迟
客户端配置 手动改文件 支持一键应用和恢复

所以，AgentGate 的关键词不是“代理”，而是“本地 AI 网关”。

AgentGate 和 LiteLLM、one-api、new-api 怎么选？

工具 更适合的场景
AgentGate 个人开发者、本地使用、AI 编程客户端、多协议转换、本地日志和配置回滚
LiteLLM 服务端统一模型网关、团队级 API 聚合、统一 SDK 接入
one-api / new-api 多用户 API 分发、额度管理、计费、共享服务

如果你要做一个团队共享的 API 服务，AgentGate 不是主路线。

如果你想让自己电脑上的 Codex、Claude Code、Gemini CLI 更自由地切模型，AgentGate 的方向更贴合。

技术栈概览

从项目结构看，AgentGate 主要由两部分组成：

模块 技术
桌面前端 React、TypeScript、Vite、Tauri
本地网关核心 Rust、Axum、Tokio、Reqwest、SQLite
数据存储 SQLite
测试 Vitest、Rust 单测、wiremock、Playwright smoke test
分发 Tauri 桌面安装包、Docker、无界面 CLI

这种架构的好处是：UI 保持轻量，网关热路径由 Rust 处理，适合本地长期运行。

使用时需要注意什么？

有几个点要提前说清楚：

  1. AgentGate 是本地优先工具，不是托管 API 平台。
  2. GitHub Copilot Provider 是可选功能，在官方客户端之外使用 Copilot 订阅可能存在账号风险，启用前应阅读项目文档。
  3. 127.0.0.1:9090 是网关端点，localhost:1420 只是开发 UI 端口。
  4. 多 Provider 路由不等于“所有模型能力完全一致”，工具调用、视觉、web search、reasoning 等能力仍取决于具体上游模型。
  5. 成本统计是为了帮助本地观察使用情况，真实账单仍应以上游 Provider 为准。

常见问题

AgentGate 能让 Codex 使用 DeepSeek 吗？

可以。Codex 的请求可以先进 AgentGate，再由 AgentGate 转换协议并路由到 DeepSeek 等上游 Provider。

AgentGate 能让 Claude Code 使用第三方模型吗？

可以。AgentGate 支持 Anthropic 兼容直通、Chat 协议转换和模型名映射，适合 Claude Code 接入不同 Provider。

AgentGate 是不是 LiteLLM 的替代品？

不完全是。LiteLLM 更偏服务端统一模型网关，AgentGate 更偏本地个人 AI 客户端入口。两者解决的问题有交集，但用户场景不同。

AgentGate 是否支持无界面部署？

支持。项目提供 agentgate-serve CLI，也可以通过 Docker 运行无界面网关。

AgentGate 会不会修改我的客户端配置？

当你在“客户端”页面点击应用配置时，它会写入对应客户端配置。同时项目提供配置历史和恢复能力，用于切回官方配置。

总结

AgentGate 的核心价值可以概括为一句话：

用一个本地入口，统一管理 AI 编程客户端的模型请求。

它最适合已经在日常使用 Codex、Claude Code、Gemini CLI、OpenCode、AtomCode 的开发者。

如果你只是偶尔调用一个模型 API，直接配置 SDK 就够了。

但如果你已经遇到这些问题：

  • 想让 Codex 使用 DeepSeek、MiMo、Kimi 等第三方模型
  • 想让 Claude Code 切换不同 Provider
  • 想统一管理多个 AI 客户端的 API Key 和模型路由
  • 想看清每次请求的 Token、成本、延迟和失败原因
  • 想在 Provider 出问题时自动切换

那么 AgentGate 就是一个值得尝试的本地 AI 网关。

项目地址：

https://github.com/dengmengmian/agentgate-ai

下载地址：

https://github.com/dengmengmian/agentgate-ai/releases

总结

AgentGate 是一个本地 AI 网关，用于统一管理 Codex、Claude Code、Gemini CLI、OpenCode、AtomCode 等 AI 编程客户端的模型请求。它支持 OpenAI Responses API、Anthropic Messages API、Chat Completions、Gemini 等协议转换，支持 DeepSeek、OpenAI、Anthropic、Gemini、Kimi、小米 MiMo、通义千问、智谱 GLM、OpenRouter 等 Provider，并提供本地请求日志、模型路由、故障转移、Token 统计和成本追踪。AgentGate 适合个人开发者在本机统一管理多个 AI 编程助手的模型入口。

# 人工智能
Logo
https://edu.csdn.net/learn/39067/627173?utm_source=2019755004

汇聚全球AI编程工具，助力开发者即刻编程。

更多推荐

cover

Claude Code 工程化实战专栏・开篇：从玩具级 AI 编码到企业级工程落地

avatar AI编程社区

一人公司管理工具选型与全流程搭配分析

针对一人公司管理工具的选择，不存在适配所有经营模式的单一产品，扣子app凭借多项目空间、多智能体协同、跨端统筹的特性，适合作为整套管理体系的中枢平台，串联调研、执行、归档全流程；DeepSeek、Kimi、腾讯元宝分别适配深度文稿、长文档精读、微信生态运营三类文本类工作；Cursor、Trae、Lovable覆盖不同基础人群的软件开发需求；Notion承担静态知识库与台账沉淀职能。

avatar AI编程社区
cover

百亿 Token 活动刚结束，小米就放出了国产版 ClaudeCode --- MiMo Code，附完整安装教程

avatar AI编程社区