ProxyPal

使用您的 AI 订阅（Claude、ChatGPT、Gemini、GitHub Copilot）与任何编码工具配合使用。原生桌面应用，封装了 CLIProxyAPI。

为什么选择 ProxyPal？

您已经为 Claude、ChatGPT 或 GitHub Copilot 付费了，为什么不能在自己最喜欢的编码工具中使用它们呢？

ProxyPal 正是为此而生——一个代理，支持所有 AI 订阅，兼容任意客户端。

功能特性

• 多 AI 提供商：连接 Claude、ChatGPT、Gemini、Qwen、iFlow、Vertex AI，以及自定义的 OpenAI 兼容端点。
• GitHub Copilot 桥接：通过 OpenAI 兼容 API 使用 Copilot 模型。
• Antigravity 支持：通过 Antigravity 代理访问高级思维模型。
• 跨平台适用：支持 Cursor、Cline、Continue、Claude Code、OpenCode 等，以及任何 OpenAI 兼容的客户端。
• 使用分析：跟踪请求数量、令牌消耗、成功率及预估节省金额。
• 请求监控：查看所有 API 请求，包括响应时间和状态码。
• 自动配置：检测已安装的 CLI 客户端并自动完成设置。

快速开始

1. 从 Releases 下载。
2. 启动 ProxyPal 并运行代理服务。
3. 连接您的 AI 账户（OAuth 或认证文件）。
4. 将您的编码工具指向 http://localhost:8317/v1。

macOS 用户

该应用目前尚未使用 Apple 开发者证书签名。如果 macOS 阻止了应用运行，请执行以下命令：

xattr -cr /Applications/ProxyPal.app

支持的平台

平台	架构	状态
macOS	Apple Silicon (ARM64)	✅
macOS	Intel (x64)	✅
Windows	x64	✅
Linux	x64 (.deb)	✅

支持的客户端

兼容 Cursor、Claude Code、OpenCode、Cline、Continue、GitHub Copilot，以及任何 OpenAI 兼容的客户端。

开发环境

pnpm install
pnpm tauri dev

检查命令

pnpm check:ts        # 如果已安装 tsgo，则使用 tsgo；否则使用 tsc --noEmit
pnpm check:parallel  # 包括 check:ts、lint 和 format:check，且并行执行
cd src-tauri && cargo check

可选的 tsgo 设置：

pnpm add -D @typescript/native-preview

可选的 VS Code 设置：

{
  "typescript.experimental.useTsgo": true
}

技术栈：前端采用 SolidJS + TypeScript + Tailwind，后端基于 Rust + Tauri v2，代理层使用 CLIProxyAPI。

贡献指南

1. 每个 PR 只包含一项功能：保持更改聚焦。
2. 提交信息清晰：避免无关更改。
3. 测试您的修改：运行 pnpm tauri dev 并验证。
4. 遵循现有模式：参考类似实现。

添加新代理

• 在 src-tauri/src/lib.rs 中添加检测逻辑。
• 将图标添加到 public/logos/ 目录（使用 currentColor 以适配深色模式）。
• 更新相关组件中的代理列表。
• 测试自动配置流程。

支持我们

如果 ProxyPal 为您节省了时间，请考虑 给我买杯咖啡。

许可证

MIT

---

星标历史

ProxyPal 快速上手指南

ProxyPal 是一款原生桌面应用，旨在打通你的 AI 订阅（如 Claude、ChatGPT、GitHub Copilot 等）与任意编程工具之间的壁垒。它通过本地代理服务器，让所有支持 OpenAI 兼容协议的客户端都能调用你已有的 AI 服务。

环境准备

系统要求

ProxyPal 支持以下平台和架构：

• macOS: Apple Silicon (ARM64) 或 Intel (x64)
• Windows: x64 架构
• Linux: x64 架构 (.deb 包)

前置依赖

• 无需安装额外的运行时环境（如 Node.js 或 Python），应用为独立可执行文件。
• 若需进行二次开发，需安装 pnpm、Rust 及 Tauri 相关工具链。

安装步骤

1. 下载安装包

访问 GitHub Releases 页面，根据你的操作系统下载对应的安装包：

• macOS: .dmg 或 .zip
• Windows: .exe 或 .msi
• Linux: .deb

2. 安装与启动

• Windows/Linux: 运行下载的安装程序并按提示完成安装。
• macOS: 将应用拖入 /Applications 文件夹。

  注意：由于应用尚未签署 Apple 开发者证书，首次启动时可能会被系统拦截。若遇到此情况，请在终端执行以下命令解除限制：

  xattr -cr /Applications/ProxyPal.app
  

  随后即可正常打开应用。

3. （可选）开发环境搭建

如果你希望贡献代码或自行编译：

pnpm install
pnpm tauri dev

基本使用

第一步：启动代理服务

1. 打开 ProxyPal 应用程序。
2. 点击界面上的 Start Proxy 按钮启动本地代理服务。

第二步：配置 AI 账号

在应用界面中连接你的 AI 服务提供商：

• 支持 OAuth 登录或直接导入 Auth 文件。
• 支持的提供商包括：Claude, ChatGPT, Gemini, Qwen, GitHub Copilot, Vertex AI 以及自定义 OpenAI 兼容接口。
• 提示：对于 GitHub Copilot，可通过其桥接功能转换为 OpenAI 兼容格式使用。

第三步：连接编程工具

在你的编程工具（如 Cursor, Cline, Continue, Claude Code, OpenCode 等）中配置 API 端点：

• Base URL: http://localhost:8317/v1
• API Key: 填写任意非空字符串（例如 proxy-pal），具体取决于客户端要求，通常由 ProxyPal 内部处理鉴权。
• Model Name: 填写你在 ProxyPal 中配置的模型名称。

配置完成后，即可在熟悉的编辑器中直接使用你订阅的 AI 模型。

第四步：监控与分析

回到 ProxyPal 仪表盘，你可以实时查看：

• 请求次数与 Token 消耗
• 成功率与响应时间
• 预估节省的费用