Metapi OAuth 管理教程3 步浏览器授权接入 Codex、Claude、Gemini CLI、Antigravity【免费下载链接】metapi把你在各处注册的 New API / One API / OneHub / DoneHub / Veloera / AnyRouter / Sub2API 等站点 汇聚成 一个 API Key、一个入口自动发现模型、智能路由、成本最优项目地址: https://gitcode.com/gh_mirrors/meta/metapiMetapi 的「OAuth 管理」功能让你不用手填 API Key、Access Token 或 Cookie仅通过浏览器授权就能把 Codex、Claude、Gemini CLI、Antigravity 这类 provider 官方账号接入同一个网关最终汇聚成一个 API Key、一个入口。本文带你 3 步完成接入并附上常见的排障方法。为什么这类上游要走 OAuth 而不是 API KeyMetapi 支持多种上游接入方式判断标准很简单你拿到的是什么适合的方式典型场景站点后台地址 账号密码站点管理 / 账号管理New API、One API、DoneHub、AnyRouter、Sub2API一段 API KeyAPI Key 管理OpenAI-compatible、Claude-compatible 网关provider 官方登录授权OAuth 管理Codex、Claude、Gemini CLI、AntigravityOAuth 连接的特点✅ 使用浏览器授权而不是手填用户名密码✅ 授权成功后Metapi 会自动创建或复用对应 provider 的宿主站点✅ 账号按 OAuth 连接保存后续刷新、重绑都走同一套流程四个内置 provider 一览来源providers.tsProvider自动创建的站点名备注CodexChatGPT Codex OAuth直接用 Codex 账号授权ClaudeAnthropic Claude OAuth直接用 Claude / Anthropic 账号授权Gemini CLIGoogle Gemini CLI OAuth可选输入 Project IDAntigravityGoogle Antigravity OAuth复用 Antigravity 账号授权 这类站点是 OAuth 账号在 Metapi 里的「宿主站点」不要把它理解成又多了一个可签到的面板站。开始前的 2 个准备准备 1确认网络能访问 OAuth 端点如果你的服务器访问外网受限可先配置全局SYSTEM_PROXY_URL或在 OAuth 启动 / 重绑时指定单次代理。相关环境变量见 docs/configuration.md 的「OAuth 与 Provider 登录」一节。准备 2远程部署提前想好回调方式OAuth 默认使用 Metapi 本机的 loopback 回调地址如127.0.0.1端口。如果 Metapi 跑在远程服务器上、浏览器跑在本地电脑有两种通行做法SSH 隧道按页面给出的命令把回调端口转发到远端手动回填 callback URL浏览器已完成授权但回调没打通时把最终回调地址贴回管理页3 步浏览器授权教程步骤 1打开「OAuth 管理」页面进入管理后台左侧菜单「OAuth 管理」。它是一个和「站点管理」「账号管理」并列的独立页面不是站点编辑器里的隐藏选项。页面会加载 provider 列表和已有连接对应源码为 OAuthManagement.tsx。步骤 2点击要连接的 provider启动授权会话点击目标 provider 后Metapi 会发起一个 OAuth 会话并弹出授权窗口同时给出 授权链接️ 本机回调端口⏱️ 手动回填等待时间 远程访问时的 SSH 隧道命令模板Gemini CLI 授权时如需要可在此处填入 Project ID。步骤 3在 provider 页面完成授权确认两层结果在弹出的浏览器窗口中完成登录授权。Metapi 会轮询会话状态pending等待回调→success授权成功→error需检查回调或网络。成功后通常会看到两层结果「OAuth 管理」页里出现新的连接记录「站点管理」页里出现对应 provider 的站点行接入完成后这些账号即可参与统一路由与代理仪表盘会集中展示各通道的调用情况授权卡住了用手动回填 callback URL这是新手最常见的坑浏览器里授权成功了但 Metapi 页面一直停在「等待授权完成」。优先怀疑回调链路没通如果是远程服务器先按页面提示建立 SSH 隧道不方便建隧道时直接手动回填复制浏览器地址栏里最终形如...?code...state...的回调 URL回到「OAuth 管理」粘贴到手动回填区域提交如果 provider 页面最终没有code/state参数说明授权本身还没成功需要重新走一遍授权相关处理逻辑见 localCallbackServer.ts。授权之后自动刷新与重新绑定接入只是开始Metapi 会持续维护这些 OAuth 连接自动刷新内置刷新调度器按 provider 分别设定提前量如 Claude 提前 4 小时、Codex 提前 5 天刷新 access token无需人工干预实现见 oauthRefreshScheduler.ts重新授权连接失效或换绑账号时在连接上点击「重新授权」即可走同一套流程路由分组多个 OAuth 账号可组成路由单元按轮询或粘滞策略分流脚本化如需自动化可调用GET /api/oauth/providers、POST /api/oauth/providers/:provider/start、POST /api/oauth/connections/:accountId/rebind等管理接口常见问题快速自查Qprovider 显示「当前不可用」通常是回调监听器不可用。依次检查服务是否刚启动但回调监听失败、端口是否被占用、当前环境是否缺少必要的 OAuth 配置。QOAuth 连接需要系统代理吗有可能尤其是国内服务器访问 OpenAI / Anthropic / Google OAuth 端点时。优先使用全局SYSTEM_PROXY_URL或 OAuth 启动 / 重绑时指定单次代理。QOAuth 成功后为什么站点管理里多了一行站点这是预期行为。Metapi 需要一个明确的站点记录来承载账号所属平台、路由与通道归属、后续重绑 / 刷新逻辑。它不代表你又新增了一个普通面板站点。相关资源完整 OAuth 文档docs/oauth.mdOAuth 后端服务源码src/server/services/oauth/上游接入对比docs/upstream-integration.md配置与环境变量docs/configuration.md按上面的 3 步走完后你的 Codex、Claude、Gemini CLI、Antigravity 账号就都已并入 Metapi 的统一入口——之后新增一个 OAuth 账号也只需重复这三步而已。【免费下载链接】metapi把你在各处注册的 New API / One API / OneHub / DoneHub / Veloera / AnyRouter / Sub2API 等站点 汇聚成 一个 API Key、一个入口自动发现模型、智能路由、成本最优项目地址: https://gitcode.com/gh_mirrors/meta/metapi创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考