ProxyPilot：让 Xcode 接入任意大模型

项目简介

ProxyPilot 是一个 macOS 工具，它在本机启动一个兼容 OpenAI 接口的本地代理并翻译请求，让 Xcode 的 Intelligence 和 Agent Mode 能用上非原生支持的 LLM 服务商。Xcode 内置智能功能只原生支持少数几家服务商，借助 ProxyPilot，可以把任意 OpenAI 兼容服务商（或 Anthropic API）接入 Xcode Intelligence 的 Claude Agent 框架。

项目提供图形界面、CLI，以及十多个 MCP 工具，并带有每次会话可审计的遥测信息（缓存命中率、TTFT 等）。

主要功能

• 菜单栏模式：常驻状态图标，支持启动/停止代理、打开设置、退出。
• 多服务商：15 家上游服务商，包含 Google Gemini 直连。
• Anthropic API 翻译：POST /v1/messages 转换为 OpenAI 格式，支持缓冲与流式响应。
• SSE 流式：/v1/chat/completions 完整支持 stream: true。
• Xcode Agent 配置：一键安装 Xcode 中的 Claude Agent，使其经由 ProxyPilot 路由。
• 本地模型免密钥：Ollama、LM Studio、9Router 无需 API Key。
• 首次引导与预检：带一键修复动作的引导式检查。
• 诊断包导出：脱敏日志、环境清单与可复制的支持摘要。
• 看门狗自动恢复：检测意外停止并以退避策略重试启动。
• 登录自启：通过 SMAppService 注册（在设置中开关）。
• 安全限制：请求数与并发上限，超限返回明确的 413/429。
• CLI 与 MCP：proxypilot start、stop、status、models、logs，以及 proxypilot serve --mcp 提供 MCP 服务端供 AI Agent 集成。

支持的服务商

云端（需要 API Key）：z.ai、OpenRouter、OpenAI、xAI (Grok)、Chutes、Groq、Google (Gemini)、DeepSeek、Mistral、MiniMax、MiniMax CN、Qwen。

本地或本地助手（无需 API Key）：9Router、Ollama、LM Studio。

支持的接口

方法	路径	格式	说明
GET	/v1/models	OpenAI	模型列表（始终免认证）
POST	/v1/chat/completions	OpenAI	对话补全（缓冲 + 流式）
POST	/v1/messages	Anthropic	翻译为 OpenAI 上游（缓冲 + 流式）

安装与使用

前置条件：macOS 15+、已启用 Intelligence 的 Xcode，针对 Apple Silicon 优化。

从源码构建需先阅读 BUILDING.md 配置 bundle identifier 与可选集成（Sparkle、PostHog），项目自带的是占位值。项目使用 XcodeGen 生成 Xcode 工程：

brew install xcodegen
zsh scripts/update_xcodeproj.sh
open ProxyPilot.xcodeproj

然后构建并运行 ProxyPilot-macOS scheme。也可以构建 Release 版并安装到 /Applications/ProxyPilot.app：

zsh scripts/build_and_install.sh

CLI 构建与一键配置 Xcode Agent：

cd ProxyPilotCLI
swift build -c release
.build/release/proxypilot setup xcode

Xcode 侧配置

1. 在 ProxyPilot 中选择服务商，需要时填入 API Key，然后点击 Start。
2. 云端服务商：使用 ProxyPilot Agent 或界面中带凭据的 Internet Hosted 字段；本地凭据由程序自动生成与管理。
3. 使用 Ollama、LM Studio 等免凭据的本地服务商时，在 Xcode 中选择 Locally Hosted，端口填 4000。

注意事项

• 模型发现只在 loopback 上可用；云端推理需要本地凭据；来自浏览器来源的推理请求会被拒绝。
• 实验性的 GitHub Copilot 集成已在 v1.15.1 移除，独立安装的辅助组件不受影响。
• 项目采用 AGPL-3.0 许可：可自由使用、修改与分发（包括通过网络提供服务），但需以相同许可证公开源码、保留原始版权与许可声明，并说明所做修改。
• 新增或删除 Swift 文件后需重新运行 zsh scripts/update_xcodeproj.sh；ProxyPilotCore 有独立测试套件，可在其目录下执行 swift test。
• 架构上分为 ProxyPilot（SwiftUI 应用）、ProxyPilotCore（跨平台共享代理引擎）、ProxyPilotCLI（CLI + MCP 服务端）与 ProxyPilotTests。

---

本作品整理自 GitHub 开源项目 masterofthechaos/ProxyPilot-public，原作者 @masterofthechaos，许可证 AGPL-3.0。中文介绍由 AI 根据项目 README 整理，以原仓库为准。