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 的主程序,双击就起来了。

从进程启动到日志打印「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。

必须说清楚这次实测的边界:我没有登录任何一家客户端账号,也不会去动你本机的登录态,所以「把订阅额度转成 API」这个核心功能我没测。能验证的是网关层——安装、启动、鉴权、空目录行为。面板上那些能力,按官方仓库的说法包括统一模型目录、模型映射、账号优先级、负载均衡、会话粘性、失败自动切换,以及按各家自己的时间窗执行的每日签到(Qoder 排在 10:01,ZCode 排在 19:01,没签上的账号再跑一轮补签);额外的 provider 实现是插件另装、不随主程序打包。这些只能算文档事实,不算我的实测结论。
如果你本机同时开着好几个 AI 客户端、又想用一个地址调它们,这台 22 MB 的服务值得一试;如果你只有一个账号,装它只是给自己多加一层凭证管理。
替代方案:把网关的价值和额度分开想
不想碰登录态,就回到正规路线。LiteLLM 这类网关收官方 Key,做统一鉴权、限流、故障切换和记账,上游是买卖关系,条款清楚;OpenRouter 一个 Key 打通多家模型,按 token 加价,适合小团队和原型;Cloudflare AI Gateway 有免费额度,缓存和日志省事。它们的共同点是——模型额度照价买,网关只解决「怎么调得稳」。
Agent2API 解决的是另一个问题:你手里已经有一堆订阅了,怎么把它们拧成一股。这是个真实的需求,但把生产系统建在别人的登录态上,等于把稳定性外包给了上游的风控团队。个人工作台可以用,对外服务请老实用官方 API。
附:本文信息来源
一、一手信息
项目与版本
- Agent2API 官方仓库 README(项目定位、统一接口、Agent 客户端接管、三种部署形态、3065 端口、网关 Key 与凭证安全声明):https://github.com/aimod-cc/Agent2API
- v3.4.2 发布说明(2026-11-05,自定义路由组、请求回放、压缩路由、客户端识别、面板一键更新):https://github.com/aimod-cc/Agent2API/releases/tag/v3.4.2
- v3.5.0-beta.1 发布说明(2026-11-09,WASM 插件隔离、Magpie 与 OpenCode 插件目录、QuWork 接入):https://github.com/aimod-cc/Agent2API/releases/tag/v3.5.0-beta.1
- GitHub Releases API(版本号与发布日期核对,2026-11-17):https://api.github.com/repos/aimod-cc/Agent2API/releases
安装与文档
- 安装部署文档(桌面端、无头服务端、Docker、移动端的完整步骤):https://github.com/aimod-cc/Agent2API/blob/main/docs/install.en.md
- 多语言 README(内置提供商支持矩阵、签到时刻、接口清单):https://github.com/aimod-cc/Agent2API/blob/main/docs/README.en.md
同名项目的另一种形态
- Dongss/agent2api(Go 实现,把本机 Claude Code、Codex、Cursor 命令行暴露成 OpenAI/Anthropic 接口):https://pkg.go.dev/github.com/Dongss/agent2api@v0.1.3
二、媒体报道
- 开源派《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 推荐》
相关阅读
- 实测 LiteLLM 1.109:升级一个网关版本,五处配置要动手,两处会静默失效
- 实测 Docling 2.149:17 页 PDF 转完 143 秒,公式一个都没解出来
- 实测 Ollama 0.40.14:一个 launch 命令,把 18 个编码代理都接了过来
本文为公开信息整理与实测记录,命令、默认值与价格以 Agent2API 官方文档当天状态为准。
原创声明:本文由 618A 情报站整理撰写,基于公开信息与实测记录,转载请注明出处并保留原文链接。