VibeProxy：macOS 订阅代理菜单栏应用

项目简介

VibeProxy 是一款原生 macOS 菜单栏应用。它让你直接使用已有的 Claude Code、ChatGPT、Gemini、Kimi、Qwen、Antigravity、Z.AI GLM 订阅，去驱动 Factory Droids、Amp CLI 等 AI 编程工具，无需再单独购买 API Key。

它基于 CLIProxyAPI 构建，自动处理 OAuth 认证、令牌管理和 API 路由：一次点击完成认证，即可开始写代码。

主要功能

• 原生 macOS 体验：使用 SwiftUI 编写的界面，外观与 macOS 系统风格一致。
• 一键管理服务器：在菜单栏中启动或停止代理服务器，菜单栏图标实时显示运行状态。
• 便捷认证：在应用内对 Codex、Claude Code、Gemini、Kimi、Qwen、Antigravity 进行 OAuth 认证，并通过 API Key 接入 Z.AI GLM。
• Vercel AI Gateway：可将 Claude 请求经由 Vercel 官方 AI Gateway 转发，以更安全的方式使用 Claude Max 订阅。
• 多账号支持：同一供应商可连接多个账号，自动轮询分配，遇到限流时自动故障转移。
• 供应商优先级：按需启用或禁用供应商来控制可用模型，修改后热重载生效。
• 实时状态与凭据检测：显示连接状态，自动识别认证凭据，凭据文件增删时实时刷新。
• 自动更新：自 v1.6 起每天检查更新，通过 Sparkle 自动安装。
• 自包含：服务器二进制、配置和静态文件全部打包在 .app 内。

安装与使用

系统要求：macOS 13.0（Ventura）或更高版本。

1. 打开 Releases 页面。
2. 按机型下载：Apple Silicon（M1/M2/M3/M4）选 VibeProxy-arm64.zip，Intel 选 VibeProxy-x86_64.zip。
3. 解压后把 VibeProxy.app 拖入 /Applications 并启动。

应用已代码签名并公证，安装时不会有 Gatekeeper 警告。

首次启动：点击菜单栏图标 → 选择 Open Settings → 服务器会自动启动 → 对 Claude Code、Codex、Gemini、Kimi、Qwen、Antigravity 点击 Connect 完成 OAuth 认证；Z.AI GLM 则点击 Add Account 粘贴 API Key，凭据保存在 ~/.cli-proxy-api/。

OAuth 认证时浏览器会打开授权页面，完成后 VibeProxy 自动检测凭据并更新状态。

高级配置：可在 ~/.cli-proxy-api/config.yaml 中写 CLIProxyAPI 覆盖项，VibeProxy 会将其与内置默认值合并，生成 ~/.cli-proxy-api/merged-config.yaml 运行时配置并自动重载。请只编辑 config.yaml，不要直接改 merged-config.yaml。例如让 gpt-* 模型默认输出简洁回复：

payload:
  default:
    - models:
        - name: "gpt-*"
      protocol: "codex"
      params:
        "text.verbosity": "low"

Codex 配置：Codex 从 ~/.codex/config.toml 读取配置，VibeProxy 提供 OpenAI 兼容端点。最简写法是覆盖默认端点：

base_url = "http://127.0.0.1:8317/v1"

也可以添加具名 provider 并选用：

model_provider = "cliproxyapi"

[model_providers.cliproxyapi]
name = "cliproxyapi"
base_url = "http://127.0.0.1:8317/v1"
wire_api = "responses"

端口 8317 默认只绑定 127.0.0.1；若在设置中开启 LAN 访问，请把 127.0.0.1 换成该机器的局域网 IP。

注意事项

• Intel 构建版本尚未经过测试，官方欢迎用户反馈使用情况。
• 使用 Codex 的具名 provider 写法时，Codex 的原生 ChatGPT 界面（Quick Chat、More details、Computer history）会失效或不可用；若依赖这些功能，请使用最简的 base_url 覆盖写法。该问题记录在 #544，目前仍在排查中。
• 从源码构建的详细步骤见仓库中的 INSTALLATION.md；运行完整 Swift 测试需要完整 Xcode 工具链（仅 Command Line Tools 不含 XCTest），命令为 make test。
• 项目采用 MIT 许可证。

本作品整理自 GitHub 开源项目 automazeio/vibeproxy，原作者 @automazeio，许可证 MIT。中文介绍由 AI 根据项目 README 整理，以原仓库为准。