meridian

把 Claude Max 订阅用到所有 AI 编程工具里，省心省钱

开源 🏷️定价信息待确认 🔧 仅开源项目，无在线服务，需自行部署编程开发 🍴 复刻 253 🐛 待处理 47 👀 关注 8

GitHub ↗

GitHub 星标 ★ 2193

维护状态活跃

是否开源开源

定价模式 🏷️定价信息待确认

项目预览

项目数据

分类编程开发

开发团队rynfar

GitHubhttps://github.com/rynfar/meridian

定价模式🏷️定价信息待确认

价格说明定价信息待确认

访问状态🔧 仅开源项目，无在线服务，需自行部署

是否开源是

主要语言TypeScript

技术栈/模型ai-agents,ai-coding,aider,anthropic,antigravity,bun,claude,claude-agent-sdk,claude-max,cline,crush-cli,gemini,google-antigravity,jcode,llm,mcp,opencode,opencode-plugin,pi-coding-agent,proxy

GitHub 星标★ 2193

上线时间2026-01-20 00:00:00

代码更新2026-11-10

仓库体积53.4 MB

本站数据更新2026-11-10

维护状态活跃

收录时间2026-08-09

浏览次数6

项目介绍

Meridian 是一个 TypeScript 编写的代理工具，核心功能是让用户通过 Anthropic 官方 SDK 在第三方 AI 编程工具（如 OpenCode、Pi、Droid、Aider、Crush、Cline）中使用 Claude Max 订阅。它解决了 Claude Max 订阅无法直接用于非官方工具的问题，通过桥接 Anthropic 官方 API，将订阅额度映射到这些工具中，从而让用户无需额外付费即可在熟悉的工作流里享受 Claude Max 的模型能力。项目处于成长阶段，GitHub 星标超 1800，技术栈聚焦于 API 代理与协议转换，适合希望最大化利用 Claude Max 订阅的开发者。

Star 增长趋势

本站每日记录该项目 GitHub 星标变化，观测越久曲线越完整

数据来源：GitHub API 逐日快照 · 收录于 2026-08-09 · 当前星标 ★ 2193

技术标签

ai-agents ai-coding aider anthropic antigravity

使用教程

ℹ 本教程由 AI 依据该项目 README 整理，个别步骤可能需要按你的环境微调。

难度：入门约 10 分钟部署方式：命令行工具 7 步

环境要求

Node.js 与 npm（需用 npm install -g 全局安装，README 未标注最低版本）
已订阅 Claude Max（Team/Enterprise 计费策略不同，上下文额度有差异）
操作系统为 macOS、Linux 或 Windows
本机 127.0.0.1 的 3456 端口可用（Meridian 默认监听地址）

安装与启动步骤

1全局安装 Meridian

用 npm 从官方源全局安装 meridian 命令行工具，安装后可直接使用 meridian 命令。若权限报错，可改用 sudo 或在用户级 prefix 下安装。
```
npm install -g @rynfar/meridian
```
2运行 setup 初始化

执行 setup 生成配置文件与客户端插件。不运行 setup，健康检查会显示 plugin 为 not-configured，OpenCode 等请求将没有会话跟踪和子代理模型选择。
```
meridian setup
```
3可选：固定 V2 beta

如需固定到 V2 beta 或指定自定义 opencode 可执行文件路径，可在 setup 时附加参数。路径要替换成你本机实际安装位置。
```
meridian setup --v2 --opencode-bin ~/.local/bin/opencode2
```
4接好 AI 编程工具

把支持 Anthropic 或 OpenAI 协议的工具（OpenCode、Crush、Cline、Aider 等）指向 Meridian 本地代理地址，具体填法见各工具自身文档。
5刷新认证令牌

代理未运行时用 CLI 刷新；代理运行中则用 HTTP 接口刷新。令牌过期会导致请求鉴权失败。
```
meridian refresh-token
```
6HTTP 方式刷新令牌

代理进程正在运行时，可直接请求 auth/refresh 接口刷新令牌，返回结果以实际响应为准。
```
curl -X POST http://127.0.0.1:3456/auth/refresh
```
7查看用量与配额

用配额接口确认账号额度是否充足，排查“额度用尽”类报错时这是第一步。
```
curl http://127.0.0.1:3456/v1/usage/quota
```

关键配置

配置项	必填	说明	示例
`MERIDIAN_SONNET_MODEL`	否	选择 Sonnet 模型档位，设为 sonnet[1m] 启用 1M 上下文（在 Max 上按额外用量计费）	`sonnet[1m]`
`MERIDIAN_1M_CONTEXT_SUPPORT`	否	设为 0 后对所有模型彻底关闭 1M 上下文，Meridian 不再请求扩展窗口	`0`
`MERIDIAN_OPUS_MODEL`	否	单独把 Opus 退回非 1M 档位，不影响 Fable 的 1M 默认	`opus`
`MERIDIAN_FABLE_MODEL`	否	单独把 Fable 退回非 1M 档位，不影响 Opus 的 1M 默认	`fable`

如何确认成功

调用健康检查接口，plugin 字段不再是 not-configured 即 setup 生效；再用 /v1/usage/quota 确认配额可读，即代理已正常工作。

常见问题

Q：工具带 tool 的请求报 400 You're out of extra usage 怎么办？

A：先 GET /v1/usage/quota 排除额度真耗尽；再在 /settings 的 SDK Feature Toggles 里关掉该适配器的客户端系统提示、保留 Claude Code 提示，然后到 issue #516 反馈计划类型。

Q：1M 上下文老是触发限流？

A：Sonnet 在 Max 上默认走 200k，因为 1M 恒按额外用量计费。确需 1M 再设 MERIDIAN_SONNET_MODEL=sonnet[1m]，并清楚计费影响。

Q：健康接口显示 plugin 为 not-configured？

A：说明还没跑过 meridian setup。执行 meridian setup 后重启 OpenCode，会话跟踪和子代理模型选择才会生效。

Q：Opus 的 1M 被要求额外用量？

A：这是 Claude Code 上游的已知问题，属 Anthropic 侧修复范围；Max/Team/Enterprise 订阅本身已包含 Opus 1M，无需额外付费。

注意事项

README 节选未给出各客户端（OpenCode、Cline、Crush 等）的具体配置写法，请以各工具官方文档为准，不要随意填写地址参数。
Meridian 完全基于 Claude Agent SDK 的 query() 调用实现，不拦截 OAuth、不修改二进制，需要有效的 Claude 订阅账号。
Sonnet 1M 在 Max 计划上始终按额外用量计费；Opus 与 Fable 的 1M 默认包含在 Max/Team/Enterprise 内。
Meridian 会自动识别 out of extra usage 错误并回退到 200k 模型、暂停 1M 一小时，但遇到问题仍建议上报 issue。

核心亮点

直接桥接 Anthropic 官方 SDK，兼容性有保障
覆盖多款主流 AI 编程工具，一次配置多处使用
TypeScript 实现，代码可读性和维护性较好

不足之处

依赖 Anthropic API 稳定性，官方策略变动可能影响功能
文档/社区待观察

适用场景

已订阅 Claude Max 但想用 OpenCode 等第三方工具
团队统一使用 Claude Max 但工具链不统一
希望减少多工具 API 费用，集中管理订阅额度

替代项目

claude-code-proxy、anthropic-proxy、one-api

上一篇：vibebin

下一篇：ccNexus