实测 Agent2API 3.4.2:解压 36 毫秒起来,但它的额度不是你能控制的

Agent2API 这个名字最近在两个完全不同的语境里出现:一个是 Go 写的 Dongss/agent2api,把本机装好的 Claude Code、Codex、Cursor 命令行包装成 OpenAI 接口;另一个是 Rust 写的 aimod-cc/Agent2API,把各家 AI 桌面客户端的登录态汇成一个网关。后者从 9 月 11 日建仓到 11 月 9 日攒了 2046 个星,稳定版迭代到 v3.4.2,是这轮讨论的主角,也是这次实测的对象。

它和 LiteLLM、new-api 那类网关的差别在于「收什么」。传统网关收官方 API Key,供应商乐意卖,价格清楚;Agent2API 收的是你本来就在客户端里登录着的账号,把订阅额度翻译给任何支持自定义 base_url 的程序用。这个差别决定了它便宜,也决定了它不稳。

上手门槛:解压即跑,但我劝你先改监听地址

agent2api-server-windows-amd64.zip 下载下来 14.2 MB,SHA256 和官方发布页给的一致。我特意挑了无界面的 server 版来测——它不装系统服务、不需要 Node,解压出 16.9 MB 的主程序,双击就起来了。

三栏数据卡:14.2 MB 压缩包、36 毫秒启动、22 MB 常驻内存
装起来的代价:包体、启动耗时与常驻内存。(图解与图片来源:本机实测,Windows 11 / 无 Docker / 无 Node 运行时,2026 年 11 月)

从进程启动到日志打印「headless 运行中」,时间戳相差 36 毫秒;/health 返回 1.8 毫秒;常驻内存 22,048 K,配置目录 C:UsersAdministrator.agent2api 占 3.2 MB。这是一台机器上一个几乎感觉不到的服务。

但有两处要在动手前知道。一是它默认监听 0.0.0.0,也就是同网段任何人都能打开面板——在你注册管理员之前,管理接口是不校验来源的。二是它会反复往日志里刷「Clash 出口不可用」,本机没装 Clash Verge 时这是正常噪音,不是故障。

免费额度:项目免费,但额度来自你自己的订阅

AGPL-3.0,自己部署、自己改都用不着付钱。真正要算的账在别处:你的额度来自那些客户端账号本身,网关只是把它换了一种输出形式。所以「免费」这个词在这里有两层意思——软件不要钱,调用也不是新花钱,但每一分钱都是你已经付给上游订阅的。

这也正是它的风险来源。客户端改一次风控策略、登录验证方式变一次,本地网关就跟着失效;账号被判异常封禁,整条路由断掉。上游不受你控制,稳定性天花板就在那里。

值不值得:无 Key 时它确实拒绝,但核心功能我测不了

鉴权这块做得比预期严。刚起来时没有管理员、没有网关 Key,/v1/chat/completions 和 /v1/messages 都返回 401,error.code 是 model_api_key_required,提示去「网关 Key」页创建并启用 Key;/v1/models 则返回 200 加一个空的 data 数组。日志里写得很直白:/v1/* 已进入 fail-closed。

三栏数据卡:无 Key 返回 401、模型目录 0 条、默认监听 0.0.0.0
没登录态、没 Key 时的实际行为。(图解与图片来源:本机实测,Agent2API 3.4.2,2026 年 11 月)

必须说清楚这次实测的边界:我没有登录任何一家客户端账号,也不会去动你本机的登录态,所以「把订阅额度转成 API」这个核心功能我没测。能验证的是网关层——安装、启动、鉴权、空目录行为。面板上那些能力,按官方仓库的说法包括统一模型目录、模型映射、账号优先级、负载均衡、会话粘性、失败自动切换,以及按各家自己的时间窗执行的每日签到(Qoder 排在 10:01,ZCode 排在 19:01,没签上的账号再跑一轮补签);额外的 provider 实现是插件另装、不随主程序打包。这些只能算文档事实,不算我的实测结论。

如果你本机同时开着好几个 AI 客户端、又想用一个地址调它们,这台 22 MB 的服务值得一试;如果你只有一个账号,装它只是给自己多加一层凭证管理。

替代方案:把网关的价值和额度分开想

不想碰登录态,就回到正规路线。LiteLLM 这类网关收官方 Key,做统一鉴权、限流、故障切换和记账,上游是买卖关系,条款清楚;OpenRouter 一个 Key 打通多家模型,按 token 加价,适合小团队和原型;Cloudflare AI Gateway 有免费额度,缓存和日志省事。它们的共同点是——模型额度照价买,网关只解决「怎么调得稳」。

Agent2API 解决的是另一个问题:你手里已经有一堆订阅了,怎么把它们拧成一股。这是个真实的需求,但把生产系统建在别人的登录态上,等于把稳定性外包给了上游的风控团队。个人工作台可以用,对外服务请老实用官方 API。

附:本文信息来源

一、一手信息

项目与版本

安装与文档

同名项目的另一种形态

二、媒体报道

  • 开源派《Agent2API 把几十家 AI 客户端塞进一个本地 base_url》(2026-11-10,Star 2046/Fork 534、v3.4.2、签到时刻、与 new-api 的风险结构对比、AGPL-3.0 义务):https://osp.io/archives/14192

其他

  • GitCode 博客《如何在 Cline、Claude Code 等客户端接入 Agent2API》
  • 蝶动 AI 导航的 Agent2API 条目
  • 涛声依旧《AI 反代好工具 — Agent2Api 推荐》

相关阅读

本文为公开信息整理与实测记录,命令、默认值与价格以 Agent2API 官方文档当天状态为准。

原创声明:本文由 618A 情报站整理撰写,基于公开信息与实测记录,转载请注明出处并保留原文链接。

上一篇 上周 AI 圈重大事件(11.9–11.15):定价、换帅、一把密钥
下一篇 AI 快讯(11.16–11.17):英伟达单季破千亿,加州把 OpenAI 告了