Agent;Gate

一个给 Windows 桌面 AI 客户端用的本地 API 密钥管理器和回环网关。

简体中文 · 繁體中文 · 日本語 · English

它解决什么

如果你同时用 Codex、Claude Code、OpenCode 或 Gemini CLI，又有多个官方 API 或中转渠道，最麻烦的通常不是发请求，而是反复改配置、找 Key、确认哪条线路还能用。

Agent;Gate 把这些事情收在一个本地应用里：

• 保存多组 API URL、Key、模型和备用端点。
• 一个网关同时服务多个客户端，每个客户端有自己的路由，可以使用不同密钥。
• 客户端只连接 127.0.0.1，切换密钥时不必反复改客户端配置。
• 用真实 Key 定时发送最小请求，查看可用率、耗时和最近检测记录。
• 实时查看请求状态、TTFB/TTFC、Token 与缓存命中。
• 浏览和删除 Claude Code、Codex、OpenCode 留在本机的会话。

它不是云服务，也不是共享代理。没有账号、服务器或遥测。

客户端支持

“实验性”表示这些客户端的配置格式仍可能变化。Agent;Gate 会尽量只修改自己负责的字段，并在断开接管时恢复，但升级客户端后仍建议先检查一次配置。

渠道状态

自动检测默认每 2 分钟执行，也可以选择 5 或 10 分钟。检测使用固定时钟；点击“立即检测”不会推迟下一次自动检测。

每个渠道都能单独关闭监测、选择检测模型，并从状态页直接切换为当前密钥。

下载

前往 Releases：

要求 Windows 10 1809+ 或 Windows 11，x64。

当前构建没有商业代码签名证书，Windows SmartScreen 可能显示“未知发布者”。可以核对 Release 中的 SHA-256 后选择“更多信息 → 仍要运行”。

快速开始

1. 在“密钥”页新建方案。默认协议是 OpenAI Responses，填写上游 URL、Key 和模型。
2. 选择这个方案要服务的客户端。
3. 在“概览”或“状态”页把方案切换给对应客户端。
4. 点击客户端卡片接管。之后客户端仍按原方式使用，请求会经过本地网关。

断开接管时，Agent;Gate 会恢复自己修改过的配置字段。切换不同方案只更新网关路由，不会打断已经发出的请求。

Claude Code ─┐
Codex ───────┤
OpenCode ────┼──> 127.0.0.1:17863 ──> 各客户端独立路由 ──> 不同上游
Gemini CLI ──┘

数据与安全

• Key 使用 Windows DPAPI 加密，保存于当前 Windows 用户的数据目录。
• 上游 URL 和真实 Key 不写入客户端配置；客户端只保存本地地址和随机本地凭据。
• 网关只监听回环地址，不向局域网开放。
• 动态记录只保存请求元数据，不保存提示词、回复正文或会话内容。
• 会话页直接读取各客户端自己的本地数据库；删除前会展示计划，删除不可恢复。

数据目录：

%APPDATA%\agentgate\data\
├── profiles.json
├── gateway.json
├── gateway-recovery.json
├── settings.json
├── requests.json
└── window-state.json

截图

开发

需要 Node.js 22 和 pnpm。

pnpm install --frozen-lockfile
pnpm test
pnpm dev
pnpm dist
pnpm release

Electron 主进程负责文件写入、DPAPI 和网关；React 渲染进程没有直接文件系统权限。

许可

MIT