让 MiniMax Code 使用你已有的 AI 订阅，而不是再买一份 API Key。
mcode-passport 是一个本地、开源的订阅连接器。它借鉴 OpenCodex 的 OAuth、provider adapter、本地 daemon、配置注入和可回滚设计，但把边界收得更小：不接管 MiniMax Code，不上传凭据，也不要求修改 MiniMax Code 源码。
当前版本是
0.1.1alpha，三个 connector 均保持 experimental。OpenAI Codex 已通过真实 refresh、stream 与 tool-call E2E，但 CLI 新登录仍待人工验收；Claude Pro / Max 与 GitHub Copilot 尚缺真实订阅 E2E。第三方订阅的使用范围最终由各服务商的条款、套餐与账号策略决定。
MiniMax Code 的自定义 provider 面向 API Key，而订阅登录通常使用 OAuth，并且每家还有不同的刷新、header 和 endpoint 规则。只把 access token 写进 config.yaml 并不可靠：token 会过期，GitHub Copilot 的 endpoint 还会随凭据变化。
mcode-passport 在本机补上这层差异：
MiniMax Code
-> custom_provider (OpenAI-compatible, loopback only)
-> mcode-passport gateway
-> provider-owned OAuth / refresh / headers / endpoint
-> OpenAI Codex | Anthropic | GitHub Copilot
- 服务只监听
127.0.0.1。 - MiniMax Code 与网关之间使用随机 256-bit token。
- OAuth refresh token 存在本机，Unix 权限为
0600。 - 不提供云端中转，不上传 prompt、代码或凭据，不含遥测。
- 修改
config.yaml前保留原始基线，restore可以精确恢复。
| Provider | CLI id | 状态 | 说明 |
|---|---|---|---|
| OpenAI Codex | openai-codex |
experimental | 真实 refresh、stream 与 tool call 已验证；CLI 新登录仍待人工验收 |
| Claude Pro / Max | anthropic |
experimental | Anthropic 对任意第三方 harness 的订阅使用没有通用承诺；可能受账号策略限制 |
| GitHub Copilot | github-copilot |
experimental | 已实现 Copilot OAuth、token refresh 和动态 endpoint，但尚缺维护者账号的真实 E2E；请确认你的套餐与 GitHub 政策允许 |
要求 Node.js >=22.19.0。
从 GitHub 安装：
npm install -g github:hetaoBackend/mcode-passport从源码运行：
git clone https://github.com/hetaoBackend/mcode-passport.git
cd mcode-passport
npm install
npm run check
npm install -g .先查看 provider 和未登录的完整目录：
mcode-passport providers
mcode-passport catalog openai-codex一次完成登录、MiniMax Code 配置和本地网关启动：
mcode-passport connect openai-codex --model gpt-5.4然后重启 MiniMax Code，模型会以 OpenAI Codex 自定义 provider 出现。若不想立刻切换默认模型，可以省略 --model，之后再选择：
mcode-passport use openai-codex/gpt-5.4其他订阅：
mcode-passport catalog anthropic
mcode-passport connect anthropic --model <model-id>
mcode-passport catalog github-copilot
mcode-passport connect github-copilot --model <model-id>默认操作 ~/.minimax/config.yaml。开发 profile 或独立安装可显式指定数据目录：
mcode-passport connect openai-codex --model gpt-5.4 --data-dir /path/to/profileproviders 列出订阅连接器
catalog <provider> 列出 provider adapter 的完整静态目录
models <provider> 登录后列出当前账号实际可用的模型
connect <provider> 登录、安装配置并启动网关
login|logout <provider> 只管理 OAuth 登录
install <provider> 只写入 MiniMax Code custom_provider
use <provider>/<model> 切换 MiniMax Code 默认模型
start|stop|status 管理本地网关
doctor 输出不含密钥的诊断信息
restore 精确恢复首次安装前的 config.yaml
serve 前台运行网关，适合调试
默认位于 ~/.minimax/mcode-passport/：
provider-auth.json：OAuth 凭据，原子写入并使用跨进程文件锁。settings.json：loopback host、port 与本地 gateway token。gateway.pid：后台进程标识，仅作状态信息；停止由带鉴权的本地管理接口完成。gateway.log：后台网关日志。
MiniMax Code 配置备份放在原配置旁边，命名为 config.yaml.mcode-passport.<timestamp>.bak。连续安装多家 provider 仍保留第一次修改前的同一份基线。
- 这是社区项目，与 MiniMax、OpenAI、Anthropic、GitHub 均无官方隶属关系。
- 不绕过套餐额度、地区限制、风控或服务商策略。
- MiniMax Code 当前 custom provider 路径只支持
openai-completions与anthropic-messages；本项目选择前者作为稳定的本地兼容边界。 - 图片输入只接受 MiniMax Code 发送的 base64 data URL；网关不会代替用户下载远程图片。
- 模型目录来自所依赖的 provider adapter 版本。升级后运行
models查看实时可用项。 restore只恢复 MiniMax Code 配置，不删除 OAuth 登录；如需移除凭据，请运行logout。
npm install
npm test
npm run typecheck
npm run build设计细节见 docs/architecture.md，当前验证证据见 docs/validation.md，官方政策来源与项目判断见 docs/provider-policy.md，安全边界与漏洞报告方式见 SECURITY.md。
- OpenCodex：OAuth 聚合、provider adapter、daemon 与配置注入方面的先行经验。
- pi-ai：provider-owned transport、OAuth refresh 与统一消息流。
本项目只借鉴架构经验，没有复制 OpenCodex 源码。
MIT