English | 简体中文
将 Google Antigravity CLI (agy) 配额转换为标准兼容的 OpenAI、Anthropic (Claude) 与 Gemini 原生 API 服务。
支持真流式思考输出、多工具调用过程可视化、三档权限安全模式、多账号智能轮询与双语管理后台。
- 🚀 全协议无缝兼容:
- OpenAI 兼容接口:
POST /v1/chat/completions(支持流式与非流式)及/v1/models - Anthropic 兼容接口:
POST /v1/messages - Gemini 原生接口:
POST /v1beta/models/{model}:generateContent
- OpenAI 兼容接口:
- 🧠 真流式思考(Reasoning / Thinking)输出:
- 增量分发思考过程,完整适配 OpenAI
delta.reasoning_content/delta.reasoning、Anthropicthinking_delta及 Gemini 原生思考字段; - 原生支持 Gemini 3.8 Flash / Pro 等最新思考模型,自动适配
--effort参数(low / medium / high),杜绝 502 崩溃。
- 增量分发思考过程,完整适配 OpenAI
- ⚙️ 工具调用过程实时可视化:
- 自动捕获 CLI 底层工具执行事件(如运行命令、读写文件、网络搜索等),并实时格式化注入到思考流中(如
⚙️ [调用工具] ...和↳ 完成); - 彻底解决类似 Trae、Cursor、Cline 等长任务 Coding Agent 假死或等待超时的问题。
- 自动捕获 CLI 底层工具执行事件(如运行命令、读写文件、网络搜索等),并实时格式化注入到思考流中(如
- 🛡️ 三档权限控制模式(Permission Mode):
skip(默认):全自动无人值守模式(--dangerously-skip-permissions),避免无交互环境下被 CLI 权限弹窗挂起;accept-edits:仅自动接受文件编辑修改;plan:只读规划模式,保护工作目录不受修改;- 支持在管理后台设置中动态切换并实时生效。
- 🌐 双语管理控制台(Admin UI i18n):
- 内置现代化管理面板,支持中文 / English 一键无缝切换并记忆偏好;
- 提供多账号管理、请求统计(1天 / 7天 / 30天 Token 消耗与模型分布)、额度实时查询、出站代理池检测与配置管理。
- 🔄 多账号智能轮询与冷却隔离:
- 隔离独立主目录(Home),多账号支持并发调用;
- 遇限流或异常自动冷却并无缝切换至下一可用账号。
- 🌐 出站代理池(Egress Proxy Pool):
- 支持配置 HTTP / Socks5 代理池,避免请求被单一 IP 限流。
| 请求路径 | 协议标准 | 说明 |
|---|---|---|
POST /v1/chat/completions |
OpenAI | 对话补全,支持 stream: true/false,返回思考过程 |
POST /v1/messages |
Anthropic | Claude 格式接口,支持思考块 |
POST /v1beta/models/{m}:generateContent |
Gemini | Google Gemini 原生 API 端点 |
GET /v1/models |
OpenAI | 模型列表查询 |
GET /healthz |
通用 | 服务健康检查 |
GET /admin/ui |
管理后台 | Web 管理面板(本机直接访问,远程需携带 API Key) |
默认监听端口:127.0.0.1:1413(或在 config.json 中配置)。默认客户端 API Key:sk-agy-local。
- 确保已安装 Node.js (>= 18)。
- 安装并登录官方 Antigravity CLI(
agy),确保本地能够正常执行 CLI 命令。
git clone https://github.com/tinytinycn/agy-proxy.git
cd agy-proxy
npm installcp config.json.example config.json
cp accounts.json.example accounts.json
cp proxies.txt.example proxies.txtnode server.js启动成功后,浏览器打开管理后台:http://127.0.0.1:1413/admin/ui
可以将本代理接入各种流行的 AI 编辑器或客户端(如 Trae、Cursor、Cline、NextChat、Cherry Studio 等)。
- 打开设置中的 Model / Custom OpenAI API;
- 配置参数:
- API Base URL:
http://127.0.0.1:1413/v1 - API Key:
sk-agy-local(或您在config.json中设置的apiKey) - Model Name:
gemini-3.8-flash、gemini-3.8-pro或gemini-3.7-flash
- API Base URL:
- 效果体验:
- 思考链(Thinking)将以折叠块形式正常流式展开;
- 模型在执行复杂任务时,调用的工具进展会实时显示在思考流中,不会出现无响应超时。
curl http://127.0.0.1:1413/v1/chat/completions \
-H "Content-Type: application/json" \
-H "Authorization: Bearer sk-agy-local" \
-d '{
"model": "gemini-3.8-flash",
"messages": [{"role": "user", "content": "9.11 和 9.9 哪个数字大?简要说明"}]
}'curl http://127.0.0.1:1413/v1/chat/completions \
-H "Content-Type: application/json" \
-H "Authorization: Bearer sk-agy-local" \
-d '{
"model": "gemini-3.8-flash",
"stream": true,
"messages": [{"role": "user", "content": "写一个快速排序算法"}]
}'{
"apiKey": "sk-agy-local",
"rotation": "rotate",
"maxAccountRetries": 4,
"cooldownMs": 60000,
"defaultModel": "gemini-3.8-flash",
"permissionMode": "skip",
"adminAuth": false,
"listenHost": "127.0.0.1",
"listenPort": 1413,
"maxInflight": 8,
"egress": {
"mode": "rotate",
"enabled": false,
"failThreshold": 3
}
}| 字段 | 类型 | 说明 |
|---|---|---|
apiKey |
string | 客户端调用 /v1/* 所需的 Bearer Token |
permissionMode |
string | CLI 权限模式:skip(全自动跳过,推荐)、accept-edits、plan |
rotation |
string | 账号轮询策略:rotate(按顺序轮换) |
cooldownMs |
number | 账号遇到限流或异常后的冷却时间(毫秒) |
defaultModel |
string | 未指定模型时的默认模型 |
listenHost |
string | 监听 IP(本机为 127.0.0.1,开放远程请设为 0.0.0.0) |
listenPort |
number | 监听端口(默认 1413) |
在无图形界面的云服务器上部署运行:
export AGY_PROXY_HOST=0.0.0.0
export AGY_PROXY_PORT=1413
export AGY_BIN=/home/ubuntu/.local/bin/agy # CLI 执行文件路径
# 使用 PM2 守护进程运行
npm install -g pm2
pm2 start server.js --name "agy-proxy"- 远程访问后台管理面板:
http://<VPS_IP>:1413/admin/ui?key=sk-agy-local - Linux 账号隔离:系统自动为每个账号在
homes/下创建独立的HOME目录,支持真正的无锁多账号并发。
├── server.js # HTTP 网关,处理 OpenAI / Anthropic / Gemini 路由与流式转换
├── agy_cli.js # CLI 子进程调用包装,流式标签解析与工具事件拦截
├── accounts.js # 多账号管理、并发锁与轮询调度
├── proxies.js # 出站 HTTP/Socks5 代理池
├── auth.js # 账号登录与 OAuth 授权流程
├── quota.js # 账号余额与配额查询
├── usage.js # 1天 / 7天 / 30天 请求与 Token 统计
├── dashboard.html # 管理后台 UI(含中英文 i18n 支持)
└── config.json # 代理服务配置文件
本项目基于 MIT License 协议发布。