统一代理网关,通过协议翻译使 Claude Code CLI 和 Cursor IDE 能够接入 Antigravity、Codex 等多种 AI 后端,支持多账号池化、会话管理与内置诊断面板。
定位#
Agent Vibes 是一个统一代理网关,解决 Claude Code CLI 和 Cursor IDE 的 AI 请求被锁定在各自原生后端的问题,使用户能在不购买付费计划的情况下利用 Antigravity、Codex 等免费或替代 AI 后端。
协议翻译与客户端兼容#
- Claude Code CLI:支持 Anthropic Messages API(SSE)协议接入,设置
ANTHROPIC_BASE_URL=https://localhost:8000即可指向本地代理。 - Cursor IDE:原生实现 Cursor 的 ConnectRPC/gRPC agent 通道,包含完整的 streaming tool loop 和 tool protocol 映射(非简单转发)。
- HTTPS 拦截:通过 mkcert 本地 CA + hosts DNS 重定向 + 端口转发实现 Cursor 流量劫持。
后端路由与模型支持#
- Antigravity IDE:worker-native 方式运行 Antigravity 运行时模块,保持 Cloud Code 请求协议合规。
- Codex CLI:OpenAI 兼容 API,支持 GPT / O 系列模型。
- Claude-Compatible API:Anthropic 兼容
/v1/messages端点,支持第三方密钥。 - 路由决策基于后端可用性和模型能力。
账号池与配额管理#
- 原生 worker / 进程池,多账号轮转。
- 后端账号状态管理、冷却机制(账号级 + 模型级)。
- Google / Codex 配额视图与速率限制视图。
会话与工具链#
- 会话状态管理、上下文压缩 / 投影 / 摘要。
- 工具完整性处理、知识库支持与语义搜索。
- MCP 工具集成。
运维与诊断#
- 内置 Dashboard(Overview、Accounts、Analytics、Settings、Diagnostics、Logs)。
- OAuth / Token 导入、手动 JSON 编辑。
- 内置诊断检查:proxy bypass、SSL 证书、DNS 解析、流量转发、bridge 健康、端到端 TLS (H2)、后端账号验证。
安装方式#
环境要求:Node.js ≥ 24, npm ≥ 11
VSIX 扩展安装(推荐):从 GitHub Releases 下载对应平台 VSIX,当前版本 v0.1.17,兼容 Cursor 3.3.16。安装后重启 Cursor,扩展自动启动代理并引导首次配置。
从源码构建:
git clone https://github.com/funny-vibes/agent-vibes.git
cd agent-vibes && npm install && npm run build && npm link
mkcert -install && agent-vibes cert
agent-vibes forward hosts && agent-vibes forward on
agent-vibes
后端账号同步:
agent-vibes sync --ide # Antigravity IDE
agent-vibes sync --tools # Antigravity Manager
agent-vibes sync --claude # Claude 兼容 API
agent-vibes sync --codex # Codex CLI
架构#
Clients: Claude Code CLI (Anthropic SSE) / Cursor IDE (ConnectRPC/gRPC)
▼
Agent Vibes Proxy Server
Gemini → Antigravity IDE (Cloud Code)
Claude → Claude-Compatible API / Antigravity
GPT → Codex CLI / OpenAI-compatible API
基于 Turborepo monorepo + NestJS (TypeScript) 构建。Cursor 协议层为原生 ConnectRPC/gRPC 实现;Antigravity 集成采用 worker-native 方式。Claude Code CLI 和 Codex CLI 集成基于 CLIProxyAPI 在 NestJS 架构上重建。
风险与限制#
- ⚠️ 项目声明仅供教育与研究目的,使用代理可能导致 Antigravity 账号被封禁。
- 主要在 macOS 上开发和测试,Linux/Windows 支持已实现但未充分测试。
- dev 分支正在基于 Claude Code 源架构进行大规模重构,不推荐用于生产编码任务。
- 当前版本兼容 Cursor 3.3.16,旧版本(v0.1.10 之前)存在已知缺陷。