claude-proxy

About

一个本地 HTTPS MITM 代理、API 翻译器和多模型聚合器，专为拥有 Gemini Enterprise（谷歌企业版）或 Google One AI Premium（个人版）的用户设计，将免费或企业级 Code Assist、Vertex AI、Antigravity 令牌无缝接入 Claude Code、opencode 或任何自研 Agent 工具中。 🚀 v1.0.0 — 打通谷歌顶配令牌与顶级智能体生态的最后一百米 自立项以来，claude-proxy 致力于解决一个核心痛点：许多开发者和企业拥有海量且免费的 Gemini 额度（如 Google Workspace Enterprise 订阅自带的 Gemini 商业配额，或个人 Google One Premium 权益），但这些额度被限制在谷歌自家的 Cloud Code Assist 等封闭生态中。目前市面上最强大的编程智能体生态（如 Claude Code、opencode 等）却无法直接享用这些高价值的令牌。 claude-proxy 采用 Rust 编写，通过本地 HTTPS MITM 拦截、协议无损翻译、全自动凭据管理和革命性的 SmartCrusher 大上下文压缩，彻底推倒了生态高墙。 1. 🔐 OAuth 凭据静默缓存与无感 re-auth 恢复 问题：谷歌的 OAuth Token 具备严格的时效性（通常为 1 小时）。一旦令牌过期或被注销，上游会直接报错 invalidgrant，导致正在运行的自动化 Agent 任务彻底崩溃，需要用户手动繁琐地重新跑 GCP / CLI 登录流。 解决：我设计并实现了精密的 ReauthGuard 与 REAUTHPROMISE 线程安全的凭据异步管理机制： 静默缓存与无缝续期：在本地安全地缓存 Google OAuth Token 并做磁盘持久化，极大地避免了高频请求谷歌认证服务器带来的显著网络延迟。 全自动浏览器接管：当上游返回 invalidgrant 凭证过期时，代理自动挂起当前正在等待的客户端请求，静默唤起浏览器完成一次 Google SSO 同步，自动把新鲜的 ADC（Application Default Credentials）写入系统，并对刚才挂起的 in-flight 请求进行透明无感重试，客户端完全不会感知到中间发生了认证失效。 2. 🔄 全协议无损翻译器（Anthropic / OpenAI ↔ Gemini） 问题：Claude Code 只懂 Anthropic Messages 协议（/v1/messages）；opencode 依赖 native Gemini 协议（/v1beta/models）；而普通的 LLM 客户端则首选 OpenAI /v1/chat/completions。想用一个谷歌底座驱动所有工具，传统的单一转换网关根本不够用。 解决：在本地网关层实现了高保真的多协议双向翻译机制： Anthropic 协议转换：在 MITM 终止层拦截 api.anthropic.com 的请求，智能提取 payload 转换为 native Gemini 格式并路由至 Code Assist 或 Antigravity 节点（甚至支持将 Antigravity 自有的 claude-sonnet-4-6 还原给客户端）。非前缀请求自动直通真实 Anthropic API，绝不影响普通 Claude 用量。 opencode 深度支持：完美支持 /v1beta 路由，作为 @ai-sdk/google 的 HTTP 本地 Origin，实现超低延迟的模型列表获取与 SSE 流式生成。 OpenAI 聚合分发：在 plain-HTTP 模式下提供 OpenAI Aggregator，根据模型前缀将 /v1/chat/completions 分发至多个不同的兼容后端，支持灵活的上游 Header 与 Key 注入。 3. 🗜️ SmartCrusher 智能内容压缩引擎 问题：在编程 Agent 中，经常需要将大段的代码或大型工具输出（如包含上千行日志的 JSON 数组）传给模型。直接将未压缩的庞大 Payload 传入会迅速烧干 Token 额度，甚至触发模型上下文超限。 解决：内置了专门针对大模型输入优化的 SmartCrusher 压缩引擎： 哈希去重与分块：对大型 JSON 数据块进行结构化哈希，识别并去重冗余节点。 BM25 关联度评分：利用经典信息检索的 BM25 算法对上下文内容做自适应重要性评分，保留与当前问题和上下文关联度最高的核心语义，舍弃无效噪点。 自适应动态截断：在逼近 Token 上限时进行平滑的自适应压缩，既能保证模型的逻辑连贯性，又将 Payload 体积强力缩减数倍，极大地节约了上游额度。 4. 📍 Map Local 规则级本地 Mock 管线 问题：现代 AI 客户端在启动或运行时极其嘈杂。比如 Claude Code 在每次运行时会偷偷发送遥测数据（telemetry）、频繁去服务器查询最新版本并发出 Vertex AI 的 maxtokens: 1 空载预热，拖慢启动时间且浪费资源。 解决：建立了首屈一指的 Map Local 本地规则引擎与短路设计： 通配符路由 Mock：支持在 config.toml 中配置 [[maplocal]] 拦截规则。允许配置 fnmatch 风格通配符（如 mock 响应、外部 json 配置文件或空 body，完美屏蔽遥测和强制更新。 文件热重载：若配置了文件路径作为响应源，代理会在每次请求时动态实时读取，修改 mock 文件无需重启代理服务，即时生效。 预热一秒直回：在 OAuth 层之上优先短路拦截 Vertex 预热特征请求，零毫秒返回 Mock 从而避免触及谷歌额度瓶颈。 5. 📦 自签名 TLS MITM 与后台守护进程化 问题：实现针对 HTTPS 端点（如 Anthropic 官方域名）的透明拦截，必须进行安全且高性能的本地 TLS 终结。如果证书配置不周全，会导致 cargo 或 macOS keychain 等强校验器报错。 解决： 规范的本地 CA：基于 rcgen 生成内置 keyCertSign 等专业扩展属性的本地根证书及动态叶子证书。完美通过 cargo 等严格 TLS 验证，彻底告别证书信任难题。 后台守护管理：内置一键式 daemonize 命令（claude-proxy start/stop/restart），PID 追踪与生命周期全自动管理，日志实时输出至 ~/.config/claude-proxy/log/，实现对开发者无打扰的后台静默守护。 📦 核心功能一览 1. 极速登录体验 支持 claude-proxy login gemini 或 antigravity，全自动浏览器 SSO 流程，提供 --no-browser 手动回写保底方案，适用于无图形界面的服务器/SSH 环境。 2. 双通道多协议桥接 无论是 @ai-sdk/google 的 Gemini，还是 Claude Code 的 api.anthropic.com 或是通用 OpenAI 端点，全部汇聚于本地 127.0.0.1:7777 统一分发转换。 3. 企业代理无缝透传 支持检测 upstreamproxy 配置，同时在内部认证 and 请求链路中智能规避 HTTPSPROXY 自循环死锁。对于 Zscaler 等 corporate SSL 拦截环境友好兼容。 4. 强大的 SmartCrusher 上下文榨汁机 动态、安全、高度智能地将巨大的 JSON Payload 压缩到原来的几分之一，大幅提升编程智能体在大代码库下的推理成功率并节省代金券。 5. 强大的 Map Local 与诊断头 所有经过 Map Local 或本地处理的响应均带有 X-Map-Local: true 或 X-Map-Local-Source 头，方便一目了然地区分本地 Stub 还是谷歌真机返回。 🧗 使用方式 bash macOS 通过 Homebrew 快速安装 brew install aero/tap/claude-proxy 或者直接通过源码编译 cargo build --release 导入 CA 证书使 Node.js / Cargo 信任本地 MITM export NODEEXTRACACERTS=~/Library/Application\ Support/claude-proxy/ca.crt export CARGOHTTPCAINFO=~/Library/Application\ Support/claude-proxy/ca.crt export HTTPSPROXY= 在后台启动代理进程（默认 7777 端口） claude-proxy start 登录你的谷歌/Antigravity 账号（任选其一，自动同步凭证） claude-proxy login gemini

Discovery history

1. 阮一峰周刊·用户投稿

   Jul 3, 2026 · 1 observations