AI Toolbox 官方账号 vs 自定义渠道：Codex 与 Gemini CLI 订阅用户的进阶实战-育师

【免费下载链接】ai-toolbox

Personal AI Toolbox

项目地址：https://gitcode.com/gh_mirrors/aitoolbo/ai-toolbox

AI Toolbox 是一款跨平台的个人 AI 工具箱桌面应用，可以一站式管理 Codex、Gemini CLI 等 AI 编程助手的配置。对订阅用户来说，它最有价值的功能之一就是：官方账号（订阅登录）与自定义渠道（API Key）双轨管理——ChatGPT Plus/Pro、Google AI Pro 的 OAuth 登录态，和任意中转站的 API Key 配置，可以在同一个界面里保存、切换、查看额度，互不干扰。

为什么必须分清"官方账号"和"自定义渠道"

两条渠道的本质差异在于：

维度	官方账号	自定义渠道
认证方式	OAuth 登录（订阅制）	API Key + Base URL（按量付费）
费用模型	月费订阅，有额度窗口	按 token 计费
配置落点	`auth.json`/`oauth_creds.json`	`config.toml`/`.env`
典型用途	日常主力、额度稳定	备用、多模型、跨协议转发

AI Toolbox 在新增供应商表单顶部提供"渠道"选择行，官方与自定义模式在新建时空白供应商时选择，保存后不可互切，避免把两种凭据混写在一份配置里。这个约束保证了你的订阅登录态永远不会被一条 API Key 配置意外覆盖。

Codex 官方账号：多账号管理与额度透视

Codex 页面把官方账号做成 Google/ChatGPT 官方供应商卡片下的账号列表，而不是一堆散落的配置文件。常用操作只有三步：

一键 OAuth 登录添加账号

点击"OAuth 登录"，浏览器完成授权后，AI Toolbox 会把登录凭据保存为账号快照，并写入 Codex 的auth.json完成应用。多账号场景下，点"切换"即可把目标账号的凭据写回运行时文件，无需手动备份、替换 JSON。

5 小时 / 周 / 月三级额度一目了然

官方账号卡片直接展示后端解析后的额度明细：5 小时窗口、周限、月限的使用百分比、各窗口重置时间，以及重置卡数量。这些数字由后端按 Codex 官方 usage 接口投影，你不用再去猜"这个百分比到底是哪个窗口的"。相关实现见 tauri/src/coding/codex/official_accounts.rs，页面逻辑在 web/features/coding/codex/pages/CodexPage.tsx。

Token 自动保鲜，订阅不"掉线"

已入库的官方账号支持后台周期性刷新：AI Toolbox 会定期用 refresh token 换新 access token，只对当前已应用的账号写回运行时文件。你不会再遇到"明明订阅还有效，CLI 却提示登录过期"的情况。

自定义渠道进阶：模型映射与协议转换

官方额度不够或想用其他模型时，就是自定义渠道登场的时候。

模型目录：一个渠道挂多个模型

供应商卡片的"模型列表"折叠区支持新增、编辑、拖拽排序和批量删除模型，每行可设置显示名、上下文窗口、思考档位，并"设为默认（主模型）"。默认模型会同步写入config.toml，Codex 启动即读，不改变任何全局配置。

协议不匹配？让本机网关代劳

Codex 原生只说 OpenAI Responses 协议。当你的中转只支持 Anthropic Messages 或 OpenAI Chat 时，表单会就地提示"该渠道必须走本地网关做协议转换"。AI Toolbox 的本机代理网关在本机起一个监听端口，负责 Anthropic Messages / OpenAI Chat / OpenAI Responses / Gemini Native 四种协议之间的结构互转，还支持失败重试与 P0/P1 故障切换。网关的各项开关语义详见 docs/proxy-gateway-settings-switches.md，协议转换架构见 docs/gateway-protocol-conversion.md。

关键开关：切换第三方时保留官方登录

这是订阅用户最实用的开关之一：开启后，第三方 API Key 写入config.toml的同时，auth.json里的官方 Codex 登录态原样保留。也就是说你可以在"订阅主力 + 中转兜底"之间来回切，而不用重新走一遍 OAuth 授权。开关入口在 Codex 页的"更多选项"里。

Gemini CLI 官方账号：Google 订阅用户的同款体验

Gemini CLI 页面与 Codex 采用同一套账号管理范式：

账号列表挂在 Google 官方供应商卡片下，支持 OAuth 登录、切换、删除与 Token 复制；
应用官方账号会把凭据快照写回oauth_creds.json，并保持settings.json的认证类型为 OAuth 个人模式；
自定义渠道则走GEMINI_API_KEY+GOOGLE_GEMINI_BASE_URL环境变量，模型切换写入GEMINI_MODEL，官方模式与自定义模式的字段在表单层自动归一化，不会出现"官方模式残留 API Key 字段"的脏配置；
官方账号同样支持用量额度刷新，订阅配额直接显示在卡片上，无需额外开 Tab。

后端实现可参考 tauri/src/coding/gemini_cli/official_accounts.rs，前端页面为 web/features/coding/geminicli/pages/GeminiCliPage.tsx。

让配置"跑起来"：WSL 同步与数据备份

官方账号的凭据快照和自定义渠道配置都保存在 AI Toolbox 的本地数据库中，进阶用户通常还会做两件事：

WSL 同步：Windows 端的 Codex / Gemini CLI 配置、MCP 和 Skills 可以一键同步到 WSL 环境，切换运行环境不用重新配置一遍。
数据备份：支持本地、WebDAV 云端备份，并可开启可选加密。凭据类文件有专门的敏感文件过滤机制，避免订阅 token 明文散落。

备份入口在设置页的"数据备份"卡片，配置详情可参考 tauri/src/settings/backup/ 模块。