订阅账号接入

授权或导入 Codex、Claude 与 Antigravity 订阅账号，了解模型与额度支持范围。

SubLane 当前支持三个订阅渠道。渠道表示认证来源，不等于模型家族：Antigravity 可以提供账号有权访问的 Gemini 等模型，但它不是 Gemini API Key 接入。

渠道	浏览器回调地址	凭据导入	额度显示
Codex	`http://localhost:1455/auth/callback`	嵌套或扁平 Codex `auth.json`	已支持
Claude	`http://localhost:54545/callback`	CLIProxyAPI 扁平 Claude JSON	尚未支持
Antigravity	`http://localhost:51121/oauth-callback`	CLIProxyAPI 扁平 Antigravity JSON	尚未支持

浏览器授权

以管理员身份打开订阅账号页面（Accounts），选择添加账号。
选择服务商、输入名称，启动浏览器授权。
在服务商页面登录并授权。
将浏览器地址栏中完整的 localhost 回调地址复制回 SubLane 对话框。
完成后验证连接，查看账号模型目录。

SubLane 不启动本地回调接收器，因此最后跳到 localhost 时出现连接错误是预期现象。仍应复制该地址，本地和远程部署都使用相同流程。

授权状态绑定当前管理员会话，单次有效，10 分钟后过期。Codex、Claude 使用 PKCE；Antigravity 使用 SDK 的 Google 安装应用授权流程。其他服务商或其他管理员会话的回调会被拒绝。

导入凭据

仅导入管理员主动提交的文件或 JSON，SubLane 不会扫描本地客户端目录。凭据必须属于订阅账号，官方 API Key 不被接受，导入文件里的端点与代理覆盖配置不会生效。

Claude 和 Antigravity 使用匹配服务商 type 的扁平 JSON，需要 access_token、refresh_token、身份信息及 expired（RFC3339）或 expires_at（Unix 秒）。Antigravity 可包含 project_id，缺失项目元数据时会在请求前准备。

导入后使用验证连接操作刷新模型目录。未经成功验证的导入账号显示未验证。重新授权必须保持相同服务商和上游账号身份。

模型选择

使用个人网关密钥请求 GET /v1/models，按返回的原生模型 ID 发起调用。不要自行添加 codex/、claude/ 或 antigravity/ 前缀。相同原生 ID 跨服务商只显示一次，实际调用会在分组内选择声明支持该模型的合格账号。

已有显式服务商前缀请求保持兼容。普通会话一旦绑定账号，不会因账号饱和、禁用或删除而静默切换上游身份。需要切换时应重新开始会话。

接口与兼容性

三个渠道通过执行器支持 OpenAI 兼容 Responses、Chat Completions 的 JSON/SSE，以及 Responses WebSocket。原生 Claude Messages 与 Gemini 生成接口见客户端协议。/v1/responses/compact 仅适用于 Codex。

任意上游模型并不自动拥有 Codex 专属工具或能力。自动化覆盖使用模拟服务商；真实 OAuth、模型工具行为和桌面客户端仍需独立验收。

凭据边界

SubLane 负责授权交换、刷新、加密持久化和账号选择。模型执行器接收已保存的访问令牌；Antigravity 的显式刷新调用会在 SubLane 管理的生命周期内接收刷新令牌。刷新结果先成功写入数据库再用于请求，写入失败时停止请求。

请根据真实工作负载测量资源占用，不把空闲内存观测当作多账号并发或生成期间的保证。实现边界见架构。