llmgateway

这是什么？适合谁？

llmgateway（fridge1/llmgateway）是一个统一 LLM API 网关：兼容 OpenAI / Anthropic / Gemini 协议，可直接接入 Claude Code、Codex CLI、Cursor、Windsurf，内置计费。

核心价值：用一个统一网关承接多个协议、多个下游工具的模型请求——兼容主流协议、直连主流编程工具、内置计费，把「多供应商 + 多工具」的模型接入收敛到一处。

适合人群：

• 同时用多个编程工具、多个模型供应商的开发者
• 需要统一计费与模型接入管理的团队
• 自建模型网关的集成者

使用前提：可部署网关的服务环境；至少一个模型供应商；一个要接入的编程工具。

准备工作

1. 部署环境：TypeScript 服务，需 Node 环境。
2. 模型供应商：准备一个或多个模型 API。
3. 下游工具：Claude Code / Codex CLI / Cursor / Windsurf 之一。
4. 成本：公开仓库；模型按供应商计费（许可证需确认）。
5. 时间预算：部署 + 接入第一个工具约 20 分钟。

快速上手（3 步）

第一步：部署网关

git clone https://github.com/fridge1/llmgateway
cd llmgateway
npm install   # 部署与配置以 README 为准

第二步：配置供应商与协议

配置模型供应商，并开启需要的协议兼容（OpenAI/Anthropic/Gemini）。

第三步：接入下游工具

把 Claude Code 等工具指向网关地址，开始使用。

成功判定：让一个编程工具通过网关调用到不同协议的模型供应商，并看到计费记录。

初级用法

多协议兼容

兼容 OpenAI / Anthropic / Gemini 协议。

多工具接入

直连 Claude Code、Codex CLI、Cursor、Windsurf。

内置计费

统一记录模型用量与费用。

高级玩法

供应商路由

按规则把请求路由到不同供应商。

用量配额

给不同工具/用户设用量上限。

计费对账

用网关的计费数据做成本分析。

小技巧

1. 先单一供应商跑通：再加多协议多工具。
2. 协议映射要测：各协议字段映射易出兼容问题。
3. 计费先校准：网关计费与实际账单对账。
4. Key 集中管理：统一在网关侧配置。
5. 看许可证：仓库为自定义 license，商用前确认。

常见踩坑

踩坑 1：协议兼容问题

• 现象：下游工具报协议错误。
• 原因：各协议字段映射不完整。
• 解决：逐协议测试，必要时自定义映射。

踩坑 2：计费不准确

• 现象：网关计费与供应商账单对不上。
• 原因：计费规则未校准。
• 解决：用真实账单校准计费规则。

踩坑 3：网关单点故障

• 现象：网关挂了所有工具不可用。
• 原因：未做高可用。
• 解决：关键场景加冗余或降级直连。

踩坑 4：许可证不明

• 现象：商用有法律风险。
• 原因：仓库 license 为自定义（NOASSERTION）。
• 解决：商用前确认授权条款。

踩坑 5：项目极新

• 现象：功能与文档有限。
• 原因：项目 2026-08-28 创建。
• 解决：以 README 为准。

常见问题 FAQ

Q1: 和 my-free-code 这类网关的区别？

A: llmgateway 强调多协议兼容 + 多工具直连 + 内置计费，面向统一接入。

Q2: 支持哪些协议？

A: OpenAI / Anthropic / Gemini 协议，具体见 README。

Q3: 免费吗？

A: 公开仓库，但 license 为自定义，商用需确认；模型费用另计。

Q4: 能计费吗？

A: 内置计费能力，可统一记录用量。

Q5: 适合生产吗？

A: 项目极新，生产使用需自行验证并注意单点故障。

进阶学习建议

掌握基础后，建议深入：

1. 把多个编程工具都指向网关，统一模型接入与计费。
2. 研究供应商路由与配额，实现精细化成本控制。
3. 做网关高可用与降级直连，提升生产可靠性。

参考链接

• 官方仓库

最后更新：2026-08-29 · 作者：MagicNetWorld · 基于公开资料整理，关键数据经 GitHub API 独立实测核验，AI 辅助生成