Meridian：订阅账号的本地 API 桥

项目简介

Meridian 是一个本地 API 桥：它让 Pi、OpenCode 等受支持的编码客户端，使用你自己的 Claude 与 Antigravity 订阅来发请求。你在本地启动服务，然后在浏览器或可选的 Mac 应用里管理供应商、请求与用量。

其中 Claude 请求通过 Anthropic 的 Agent SDK 执行，Antigravity 请求通过 Google 官方、已登录的 agy CLI 执行。账号权限、模型可用性和订阅限额依然生效。

主要功能

Claude（已发布 · Claude Agent SDK）

• 持久会话、prompt 缓存与多账号 profile
• headless 运行于 macOS、Linux 和 Windows

Antigravity（预览 · v1.74.0+ · 官方 agy CLI）

• 流式输出、客户端工具调用、会话复用与已保存回答的恢复
• 支持增量文本、并行工具批次、审批、提问、取消，以及客户端自有的插件/委派
• 模型与输出选择：可用的模型/强度变体、强制工具、经校验的结构化输出
• 客户端 API：Anthropic Messages、OpenAI Chat Completions，以及有文档说明的 Responses 子集
• 附件：图片与公开 HTTPS 图片 URL；文档、语音、视频通过本地转换处理
• 连续性：热会话复用、已完成会话恢复、历史重放，以及已保存回答与工具 ID 的有限恢复
• 供应商管理：Web 与 macOS 配置界面，分别显示配额/状态

桌面应用

可选的 Mac 应用用于管理本地服务、版本、插件和诊断信息。Providers 页面可在 Claude 与 Antigravity 之间切换，两者的账号和配额窗口彼此独立；请求历史便于排查失败与活动情况。桌面预览面向 Apple Silicon 上的 macOS，可从 GitHub Releases 下载签名并公证的 DMG 或 ZIP。npm 包不会安装 Electron，headless 使用方式仍然保留，Docker、Nix 和现有服务管理器都能运行同一个服务器。

安装与使用

Claude 后端快速开始

先安装 Node.js 22+，然后：

npm install -g @rynfar/meridian
claude login
meridian

打开 http://127.0.0.1:3456。使用 OpenCode V1 时，运行 meridian setup 后重启 OpenCode；Pi 及其他客户端请参考客户端配置指南。API-key 保护与 Windows 设置见配置文档，Docker 与 Nix 部署见部署文档。

试用 Antigravity（预览）

已验证的组合为 agy 1.2.7、Pi 0.72.1 或 OpenCode V1 1.18.31，以及 Apple Silicon 上的 macOS。先安装 Node.js 22+ 与官方 Antigravity CLI，运行 agy 登录订阅账号，并在其设置中关闭付费超额额度。然后：

npm install -g @rynfar/[email protected]

MERIDIAN_BACKEND=antigravity \
MERIDIAN_AGY_ALLOW_TOOL_BRIDGE=1 \
MERIDIAN_AGY_STATE_PATH="$HOME/.local/state/meridian/antigravity.sqlite" \
MERIDIAN_PORT=3457 \
meridian

打开 http://127.0.0.1:3457/providers 使用 Connect Pi / OpenCode，或按 CLI 配置说明 操作。工具桥让客户端以自身权限执行工具；SQLite 路径用于在服务重启后保留状态，但不保证恢复未完成的操作。

注意事项

• Antigravity 仍处于 preview 阶段，Linux/Windows 的登录验证尚未完成。
• 活动任务重新挂载、以及不确定工具结果的自动对账仍未完成；部分供应商专属插件、托管工具/文件契约和客户端版本还需要适配器与验收测试。
• CLI 不暴露精确的输出 token 上限、数值化思考预算、采样控制或全部原生媒体/推理能力，Meridian 也无法通过包装层补上这些保证；上游 CLI 故障仍可能中断一轮对话。
• Antigravity 的生成始终在已登录的 CLI 上完成，没有 Google API-key 或模型 SDK 的兜底路径。
• 项目基于 MIT 许可；Claude 与 Antigravity 为各自所有者的商标。

---

本作品整理自 GitHub 开源项目 rynfar/meridian，原作者 @rynfar。中文介绍由 AI 根据项目 README 整理，以原仓库为准。