vibeproxy

一款让订阅不浪费的 macOS 菜单栏神器：VibeProxy

想象这样一个场景：你每个月为 Claude Code 付费 100 美元，却还要再花 50 美元买一个第三方 AI 编程工具的 API key——两个工具做着几乎一样的事情。这种"双重付费"的尴尬，是大量 AI 开发者共同面临的痛点。

VibeProxy 正是为解决这个矛盾而生。它由 Automaze 团队打造，是一款原生的 macOS 菜单栏应用，通过将现有的 Claude Code、ChatGPT 等订阅账号"桥接"到其他 AI 编程工具（如 Factory Droids）上运行，实现一份订阅、多重用。开发者无需额外购买 API key，一切认证流程在应用内一键完成。

图1：VibeProxy 主界面，在菜单栏即可管理所有 AI 服务连接状态

本项目目前已在 GitHub 获得 3000+ Stars，支持模型涵盖 Claude Code、ChatGPT、Gemini、Kimi、Qwen、Antigravity、Z.AI GLM 等主流服务，并持续保持活跃更新。

项目起源与行业背景

为什么会出现"双重付费"困境？

AI 编程工具生态在 2024-2025 年呈现爆发式增长。Anthropic 推出 Claude Code、OpenAI 推出 Codex CLI，各家科技公司纷纷推出自己的命令行编程助手。然而，这些工具与底层大模型之间存在一个微妙的设计差异：

• Claude Code / ChatGPT 桌面端：以月度订阅形式提供，内置完整的用户认证和计费体系。
• 独立 AI 编程工具（如 Factory Droids）：需要用户自行提供 API key 来调用模型。

对于已经在 Claude Code 上付费的用户而言，用同一个模型去驱动另一个编程工具，意味着重复计费。而 API key 的管理、额度监控、计费追踪，也增加了额外的认知负担。

Automaze 团队敏锐地捕捉到了这个需求，VibeProxy 应运而生。它的核心技术依赖于 CLIProxyAPIPlus 项目，实现 OAuth 认证的透明转发和 Token 管理。

类比理解：就像一个"酒店房卡万能钥匙"

可以把 VibeProxy 理解为一个智能代理路由器：你拥有一张酒店房卡（Claude Code 订阅），VibeProxy 帮你复制出一把万能钥匙，让同一个房间可以被多个锁（不同的 AI 编程工具）打开，而酒店系统依然能准确识别是你的房间在消费资源。

图2：VibeProxy 官方应用图标

开发者背景

项目由 Automaze 团队维护，创始人在社交媒体上活跃，持续推动产品迭代。从 GitHub 提交记录看，项目更新频率较高，持续支持新模型接入（如 GPT-5.1、Gemini 3 Pro 等最新模型），反映出团队对 AI 生态的快速跟进能力。

图3：Automaze 团队 GitHub 头像

核心功能详解

1. 一键 OAuth 认证

VibeProxy 支持以下服务的 OAuth 认证，无需手动填写 API key：Claude Code（Anthropic）、ChatGPT（OpenAI）、Gemini（Google）、Kimi（月之暗面）、Qwen（阿里通义）、Antigravity。

用户只需在菜单栏应用内点击"Connect"，浏览器自动弹出认证窗口，完成后应用自动保存 Token，整个过程不超过 30 秒。对于不支持 OAuth 的服务（如 Z.AI GLM），VibeProxy 也提供了 API Key 管理界面，安全存储密钥。

2. 本地代理服务器

VibeProxy 在本地启动一个轻量级 HTTP 代理服务器（基于 CLIProxyAPIPlus），监听指定端口（默认 localhost:8080）。当用户配置环境变量指向该代理后，AI 编程工具的请求会先经过 VibeProxy 转发。

代理层的核心逻辑：

用户工具 → VibeProxy 代理 → Claude/ChatGPT 订阅 API → 返回结果

这种方式的优势在于完全透明：AI 编程工具不知道自己用的是订阅账号而非直连 API。

3. Vercel AI Gateway 集成（安全增强）

2025 年新引入的功能：支持将 Claude 请求路由经由 Vercel 官方 AI Gateway。这是针对 Claude Max 订阅用户的重要保护机制——直接使用 OAuth Token 有账号风险，通过 Vercel 官方渠道转发则更安全。

4. 多服务状态管理

菜单栏实时显示各服务的连接状态：🟢 已连接（绿色图标）、🟡 认证过期需刷新、⚫ 未配置。用户无需打开应用主界面，在菜单栏即可掌握全局状态。

5. 模型别名映射

不同服务商对同一模型的命名存在差异（如 claude-3-5-sonnet 对应不同别名），VibeProxy 内置了 ModelAliasMapper.swift 模块，自动处理这些映射，确保请求能正确路由到对应模型。

技术架构解析

从源码结构来看，VibeProxy 采用标准 Swift + SwiftUI 构建，模块化设计清晰：

模块	职责
AppDelegate.swift	macOS 菜单栏及窗口生命周期管理
ServerManager.swift	本地代理服务进程的启动/停止/状态监控
SettingsView.swift	SwiftUI 主设置界面
AuthStatus.swift	监听认证文件变化，自动刷新 Token
ConfigComposer.swift	动态生成 CLIProxyAPIPlus 配置文件
ProviderCatalog.swift	支持服务商的目录与元数据
CustomProviders.swift	自定义 Provider 扩展机制
TunnelManager.swift	Vercel AI Gateway 隧道管理
ZAIAPIKeyStore.swift	Z.AI GLM API Key 安全存储

这是一个高度模块化的设计，每个功能域都有清晰的边界，便于维护和扩展。

部署与上手

安装方式（macOS 原生）

VibeProxy 仅支持 macOS，不提供 Docker 或 Web UI，属于原生桌面应用。安装步骤：

1. 推荐方式：使用 Homebrew 一键安装

   brew install --cask vibeproxy
   

2. 备选方式：从 GitHub Releases 下载 .app 包，手动拖入 Applications 文件夹。

3. 构建源码（适合开发者）：

   git clone https://github.com/automazeio/vibeproxy
   cd vibeproxy
   make
   

   Makefile 包含完整的资源打包和签名流程。

硬件需求

• 操作系统：macOS（Intel 和 Apple Silicon 均支持）
• 内存：最低 512MB RAM（代理服务极轻量）
• 磁盘：约 200MB
• GPU：不需要

与 AI 编程工具集成

以 Factory Droids 为例：

1. 在 VibeProxy 中点击 Connect，完成 Claude Code OAuth 认证。
2. 假设本地代理运行在 http://localhost:8080。
3. 配置环境变量：

   export https_proxy=http://localhost:8080
   export HTTP_PROXY=http://localhost:8080
   

4. 启动 Factory Droids，即可使用已认证的 Claude Code 订阅。

VibeProxy 提供了详细的 FACTORY_SETUP.md 和 AMPCODE_SETUP.md 文档，针对不同工具的配置有专项说明。

局限与注意事项

⚠️ 订阅服务的合规性

将订阅账号用于第三方工具可能触及各平台的服务条款。Anthropic、OpenAI 等厂商的订阅协议通常限制账号共享或非官方方式调用。VibeProxy 官方也明确提示用户注意这一点。对于企业用户，建议咨询合规团队。

⚠️ OAuth Token 安全

OAuth Token 以文件形式存储在本地（~/.config/vibeproxy/ 等路径），本地安全取决于系统账号安全。建议对 Mac 设置强密码和 FileVault 加密。

⚠️ macOS 独占

目前没有 Windows 或 Linux 版本，对于跨平台开发者来说使用场景受限。如果团队使用多种操作系统，VibeProxy 无法作为统一的解决方案。

行业意义与发展趋势

VibeProxy 的出现反映了一个更深层的趋势：AI 订阅经济的碎片化。当市场上出现数十种 AI 编程工具，每种都绑定自己的订阅体系时，用户面临的选择困境日益加剧。

从技术角度看，VibeProxy 代表的"订阅代理"模式，本质上是一种服务编排（Service Orchestration） 思想——在用户与服务之间插入一个智能路由层，按需分发请求。这与 Vercel AI Gateway、Portkey、Cloudflare AI Gateway 等企业级方案的思路一脉相承，只是面向的终端用户不同。

从用户价值角度看，VibeProxy 直接帮用户省下了真金白银：一个典型的 Claude Max 用户（$100/月）如果用 VibeProxy 替代额外的 API 消费，每年可节省数百至数千美元。

该项目目前 3000+ Stars、持续迭代、GitHub 提交活跃，在 AI 工具辅助赛道中属于小而美的精品项目。随着 Claude Max、Gemini Advanced 等高价位订阅用户群体扩大，对这类"订阅复用"工具的需求可能进一步增长。

---

本报告基于 GitHub 最新源码（2026年6月）和公开文档生成，部分功能细节以官方文档为准。