CliGate：一个本地 AI 控制平面，把所有 AI 模型聚合到本地网关

深夜 11 点，你还在为切换 AI 模型头疼吗？

想象这样一个场景：你正在同时使用 Claude Code 写代码、用 Codex CLI 做代码审查、请 Gemini CLI 帮你分析文档，却发现每个工具都要单独配置 API Key，账单散落在不同平台，调试日志东一块西一块。你想加一个新模型试试？得改一堆配置，还容易搞混。

CliGate 就是来解决这个问题的。它是一个本地 AI 控制平面，核心思路很简单：把 Claude Code、Codex CLI、Gemini CLI、OpenClaw 等主流 AI 工具的 API 请求全部路由到本地的一个网关（默认 localhost:8081），由这个网关统一管理认证、路由、日志和成本。

这个项目目前已经在 GitHub 获得了 118 颗星，虽然规模不大，但功能完整度和代码质量都相当扎实。

它到底是什么？

CliGate 的架构围绕两大核心能力展开：

第一个是"私有助手"（Private Assistant）。这个助手运行在本地，作为常驻进程存在，具备记忆、工具调用、任务调度和渠道分发能力。你可以通过 Web 界面（Dashboard）或者 Telegram、飞书、钉钉等即时通讯工具与它对话，它能记住上下文、执行任务、调度定时工作，并通过 MCP（Model Context Protocol）、Shell 脚本或桌面自动化工具来完成任务。

第二个是"模型代理"（Model Proxy）。这是 CliGate 最核心的功能——一个本地的 API 代理层。它同时兼容 Anthropic Messages、OpenAI Chat Completions、OpenAI Responses、Codex 和 Gemini 五种协议格式，充当"翻译官"的角色，将来自不同工具的请求统一路由到对应的上游提供商。

也就是说，如果你想让 Claude Code 通过 CliGate 转发请求，只需要设置两个环境变量：

export ANTHROPIC_BASE_URL=http://localhost:8081
export ANTHROPIC_API_KEY=你的Key
claude

Codex CLI 同理，只需改一个配置文件。不需要逐个配置每个工具，只要 CliGate 这个入口配置好了，其他所有工具都能自动复用。

背后的故事

从项目的文档和目录结构来看，开发者 Geng Steven（GitHub @GengSteven58767）从一开始就瞄准了一个很具体的需求：在本地环境中统一管理多个 AI Agent 和模型提供商的访问。这类需求在 AI 工具大爆发的背景下变得越来越普遍——用户不再只用一个模型，而是同时部署多个 Agent 协同工作，但每个工具各自为政带来的是碎片化的管理体验。

CliGate 的出现填补了这个空白。它不仅仅是一个简单的反向代理，而是一个具备完整路由策略、账户池、API Key 池和用量追踪功能的控制平面。

项目采用 AGPL-3.0 开源许可证，主分支为 master，当前版本 1.4.2。代码仓库中包含了详尽的中英文文档，包括产品手册、架构设计文档、API 参考、社区指南等，说明开发者在文档上投入了大量精力。

技术细节：它是怎么做到的？

从代码结构来看，CliGate 的技术选型非常务实：

• 后端：基于 Express.js（Node.js），要求 Node ≥ 24
• 前端：纯原生 HTML/CSS/JS，通过 Electron 打包成桌面应用
• 协议翻译：内置完整的 Anthropic/OpenAI/Gemini/Codex 协议转换器（src/translators/ 目录）
• 渠道集成：支持飞书、钉钉、Telegram（src/agent-channels/providers/）
• 桌面自动化：通过 Python 脚本捕获 macOS 屏幕（native/macos-desktop-agent/）
• 测试覆盖：135 个单元测试文件 + 完整的 E2E 测试框架

特别值得注意的是 src/translators/ 目录下的协议转换层。这里实现了多种 AI 协议的请求规范化和响应格式化，使得不同协议格式的请求能够在同一个网关内流转，这是 CliGate 能作为"统一入口"的技术基础。

CliGate Web 控制台主界面

使用门槛：什么人适合用？

入门门槛中等。它提供了两种使用方式：

1. 桌面安装包：下载 Releases 页面中的打包版本，安装后自动启动并打开桌面窗口，完全图形化操作，适合非技术用户。
2. 命令行安装：通过 npm install -g cligate 或 npx cligate@latest start 启动服务，通过 http://localhost:8081 访问 Dashboard，适合开发者。

不过有一个硬性要求：Node.js 24 及以上版本。这个要求相对较高——Node 24 是 2025 年的最新 LTS，许多用户的系统可能还未跟进。

争议与局限

优点显而易见：统一的模型路由解决了多 Agent 管理的碎片化问题；本地优先（local-first）的设计保证了隐私；飞书/钉钉/Telegram 渠道集成对国内用户很友好。

但也有明显的局限：

1. 没有容器化支持。项目中既没有 Dockerfile 也没有 docker-compose.yml，无法通过 Docker 一键部署。对于希望快速尝鲜或者在服务器上长期运行的用户来说，只能通过 npm 直接运行，不够便捷。
2. AGPL-3.0 许可证。如果你基于 CliGate 开发并提供网络服务，必须开源你的修改。这对个人用户无影响，但对企业开发者是一个需要评估的合规风险。
3. Node ≥ 24 的硬性要求。在部分环境中可能需要额外安装或升级 Node 版本。
4. 不支持图片 URL 内嵌。报告中引用的 GitHub 仓库图片无法通过 curl 验证访问（因 CDN 访问限制），实际使用时这些图片可能无法加载。

对话界面

API Key 管理

总结：CliGate 适合你吗？

CliGate 是一个定位清晰、功能完整的本地 AI 网关工具。它的核心价值在于统一管理——把散落在各个 AI 工具中的认证、路由、日志收敛到一个本地控制平面。如果你同时使用两个以上的 AI Agent（比如 Claude Code + Codex CLI），或者希望在自己的机器上搭建一个可控的 AI 路由层，CliGate 值得一试。

但如果你追求的是零配置快速启动（缺少 Docker 支持是个遗憾），或者对许可证有顾虑（AGPL 约束），则需要权衡。

总的来说，这是一个小而美的开源项目，体现了开发者在 AI Agent 生态整合方面的深度思考。随着 AI 工具的持续普及，这类统一网关类工具的价值会越来越凸显。

多账户管理

渠道集成