Casbin Gateway

产品简介

Casbin Gateway 是 Apache 软件基金会开源的本地 AI 编程助手流量管理桌面工具。它解决的是同时使用多个 Agent（Claude Code、Codex CLI、Cursor 等）时，API Key 分散、流量无法集中管理的问题。一条命令即可完成安装，安装后自动打开桌面窗口，实时展示每个 Agent 的对话内容、Token 消耗和成本。

核心功能

• 多 Agent 统一管理：自动识别机器上安装的所有主流 AI 编程助手（Claude Code、Codex CLI、Cursor、Windsurf、OpenAgent 等），在一个界面中集中展示运行状态

• API Key 集中托管：将各平台 API Key 统一存储在本地 Gateway 中，Agent 通过本地代理访问上游模型，避免 Key 分散在多个配置文件里

• 对话流量完整录制：完整记录每一次请求，包括系统提示词、用户消息、工具调用和模型响应，可按模型维度统计 Token 消耗和费用

• MCP 服务器管理：内置 MCP 服务器管理功能，可同时配置多个 MCP 并一键分配给不同的 Agent 使用

• Provider 灵活配置：支持 OpenAI 和 Anthropic 兼容的任意 API 地址，包括自定义 base URL，满足中转 API 用户需求

• 代理流量转发：除了管理 Agent 流量外，还支持将所有网页流量通过本地代理转发，实现统一流量管控

• 系统托盘后台运行：通过系统托盘图标运行，状态变更时发送系统通知，随时掌握 Agent 运行状态

技术实现

Casbin Gateway 采用前后端分离架构。后端使用 Go 语言编写，集成 SQLite 本地数据库存储配置和流量记录；前端采用 React 框架构建，提供友好的用户界面。核心技术包括：通过指纹识别自动发现系统中已安装的 Agent 及其版本信息；利用 OSC 133 协议与 Shell 会话建立通信，实时捕获 Agent 状态变化；通过本地 HTTP 代理拦截和转发所有 Agent 流量，记录完整请求内容。

快速上手

第一步，一键安装。Linux/macOS 用户在终端执行官方安装命令，Windows 用户在 PowerShell 中执行对应安装命令，安装完成后 Gateway 自动在后台启动，并打开桌面客户端。

第二步，配置 Provider。打开 Gateway 桌面客户端（默认地址 http://localhost:17000），使用管理员账号登录（默认账号 admin，密码 123），进入 Providers 页面添加 API 提供商，填写 Base URL 和 API Key，并设置支持的模型列表。

第三步，分配 Agent。进入 Agents 页面，为每个 Agent 选择对应的 Provider，复制页面显示的环境变量配置，将其添加到 Agent 的启动命令或系统环境变量中。

适用人群

同时使用多个 AI 编程助手（Claude Code、Codex、Cursor 等）的开发者；需要对团队成员的 AI 使用情况进行审计和成本分析的技术管理者；希望统一托管 API Key、避免 Key 分散在多处的中转 API 用户；需要对 MCP 服务器进行集中配置和分发的团队。