meridian

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

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

开源 unknown 编程开发

访问官网 ↗ GitHub ↗ 文档 ↗

GitHub 星标 ★ 2042

维护状态活跃

是否开源是

定价模式 unknown

项目数据

分类编程开发

开发团队rynfar

所属国家

官网地址

GitHubhttps://github.com/rynfar/meridian

定价模式unknown

价格说明定价信息待确认

访问状态

是否开源是

开源协议

主要语言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 星标★ 2042

30天Star增速

HF 下载量

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

最近更新2026-09-23 00:00:00

维护状态活跃

中文支持

访问方式

移动端支持

综合评分

收录时间2026-08-09

浏览次数4

使用教程

难度：入门约 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

项目介绍

meridian 是基础设施领域的开源项目，由 rynfar 开发，是 2026 年新上线的项目。

在全站 13,014 个收录项目中，它的 GitHub 星标数（2,042）位列前 30%，在基础设施分类中处于中上游。

近 42 天，它的 GitHub 星标从 1,836 增加到 2,042，净增 206。

项目目前处于活跃维护状态，最近一次代码更新于 2026-09-23。

它主要面向的使用场景是：已订阅ClaudeMax但想用OpenCode等第三方工具。同类可对比的替代方案包括 claude-code-proxy、anthropic-proxy、one-api。

上一篇：vibebin

下一篇：ccNexus