codexbar

让 Codex Desktop 在多账号 / 多 provider 切换时，继续共用同一个 ~/.codex 历史池。

English | 简体中文

codexbar 是一个面向 macOS 的菜单栏工具。它不重做 Codex，而是把“切账号、切 provider 时最容易把上下文和历史切散”的那一段工作收回来。

2.0.4 新增默认关闭的「额度恢复后自动继续」：确认账号与线程后，等待服务端额度恢复并继续原线程。完整改动见发布说明；本版本同时包含 2.0.3 的上下文设置、用量采集性能与界面改进。

切账号 / 切 provider，不等于把 Codex 原本的 session 池拆成几份。

一眼看懂

• 只保留一个 ~/.codex，不为每个账号单独建一套 CODEX_HOME
• 在菜单栏里管理 OpenAI OAuth、多 OpenAI 兼容 provider、同 provider 多组 API key
• 支持 OpenAI 账号的 手动切换 / 聚合网关 双模式
• 手动切换模式下，可确认账号与线程，在额度恢复后自动继续原线程；默认关闭
• 读取 Codex、Claude Code、OpenCode、DeepSeek Harness、Antigravity 的本地用量；按账号同步 Grok Bot、Grok 网页与 Cursor 的服务端用量，并保留旧版 CSV 导入
• 在菜单栏先选软件，再切换今天 / 本月 / 总计（另有近 7 天 / 近 30 天），以及 Token / 费用视角
• 切换只影响后续新会话，不会把已有历史 session 从共享池子里“切没了”

它主要解决什么问题

如果你经常在不同 OpenAI 账号、不同中转站、或者不同 OpenAI 兼容 provider 之间来回切，通常会遇到几件事：

• 配置切过去了，但上下文像是断了
• 历史 session 还在磁盘里，却因为切账号 / 切 provider 变得不连贯
• 反复手改配置文件很烦，恢复现场也麻烦

产品概览

上面的海报式概览把当前版本最重要的工作流放在一张图里：codexbar 是 macOS 菜单栏里的 Codex Desktop companion，用来在 OpenAI 账号、兼容 provider 和本地 gateway 工作流之间切换，同时继续保留同一个 ~/.codex 会话池。

不拆 ~/.codex，保留同一个会话池

很多“多账号切换”方案会直接给每个账号单独建一套 CODEX_HOME。这样做隔离很强，但代价也很明显：

• 历史被分散到多份目录
• 切换之后很容易觉得“上下文没了”
• 需要在不同账号环境之间来回找 session

• 仍然只保留一个 ~/.codex
• 保留 ~/.codex/sessions 和 ~/.codex/archived_sessions 这一套共享历史池
• 当前激活的 provider / account 会同步到 ~/.codex/config.toml 和 ~/.codex/auth.json
• 切换只影响之后发起的新请求和新会话

现在支持什么

• 多 OpenAI OAuth 账号管理
• 多 OpenAI 兼容 provider 管理
• 同一 provider 下挂多组 API key
• 菜单栏里快速切换 provider / account
• OpenAI 账号的 手动切换 / 聚合网关 双模式
• OpenAI 账号支持按用量排序 / 按手动顺序排序
• 设置页里配置手动激活策略与 Codex.app 路径
• Codex 与其他常用 AI 工具的用量视角
• 明确绑定账号与线程的额度恢复守候、恢复记录和取消入口
• GitHub Releases 运行时版本检测与手动“检查更新”

第三方服务与协议兼容性

内置快捷预设仅保留已确认提供 Responses 接口的 DeepSeek、智谱 GLM、OpenRouter 和 Requesty，新建预设统一使用 Responses。其他服务可在 Custom 中填写地址、密钥、模型和协议（默认 Responses）。移除快捷预设不会删除 用户已经保存的服务和账号；预设仅用于简化填写，不代表所有功能均已通过实机验证。

已保存的 Chat Completions 配置不会被自动改写。预设更新仅影响新建服务；已有配置仍按 原协议工作。首次识别旧 Chat 服务时会提示检查兼容性；在 Providers 中点击“查看兼容性”， 可预览官方地址和模型的变化，确认后原地切换到 Responses，保留全部账号与密钥。 未知中转地址不会被自动替换，需先核对服务商能力。

| 预设 | Responses 基址 | 默认模型 | 官方文档 | | --- | --- | --- | --- | | DeepSeek | https://api.deepseek.com | deepseek-flash | Responses 指南 | | 智谱 GLM | https://open.bigmodel.cn/api/v1 | glm-5.3 | Responses 兼容指南 | | OpenRouter | https://openrouter.ai/api/v1 | 按账号目录选择 | Responses API | | Requesty | https://router.requesty.ai/v1 | openai-responses/gpt-5 | Responses API |

以上于 2026-09-28 核对官方文档。Responses 接口可用不代表功能与 OpenAI 完全一致； 例如 DeepSeek 对托管工具和 custom 工具有明确限制，Requesty 的 OpenAI 原生 Responses 模型使用 openai-responses/ 前缀。DeepSeek 官方 Responses 的 custom 工具目前仅支持 apply_patch；exec 等其他名称会返回 400，联网搜索等部分内置工具也不受支持。 新建 DeepSeek 配置或添加账号时，会在保存前说明这项限制；可继续保存或返回修改。 OpenRouter 继续使用现有的 Responses 转发服务， 不经过 Chat Completions 转换网关。

第三方服务使用 Codex 官方的独立 model_providers 配置：每个服务有自己的 codexbar.<服务 ID>、API 地址和认证字段。切换时同时选择服务与模型；普通第三方 切换不会把 API Key 写入 auth.json，也不会覆盖现有的 OpenAI 登录备份。 如果明确配置了固定 OAuth 登录身份，仍按该身份保留原有登录流程。

• Responses API：直接连接服务商提供的 Responses 接口。
• Chat Completions：通过本机转换网关连接。保存成功后会提示协议兼容性差异，

• 转换网关支持普通 function 和 custom 工具的调用/结果转换。custom 的 grammar

• 当前转换网关不支持 namespace 和托管式 web_search 工具。如果 Codex 默认携带

桌面应用不依赖终端环境变量导出密钥，因此使用官方支持的 provider 专属 experimental_bearer_token 字段；生成的 config.toml 权限为仅当前用户可读写 （0600），其中包含敏感认证信息，分享配置前需要脱敏。删除服务或更换凭据时， 会同步更新受管配置；手工维护的其他 provider、profile、MCP 配置和 model_catalog_json 模型目录引用会保留。

切回 OpenAI 时会恢复 OpenAI 的请求目标和对应认证。已有会话可能继续使用此前的 配置；切换服务后建议新开会话。第三方协议兼容不代表所有 Codex 功能均受支持。

用量来源与视角

菜单栏的「用量」卡片可以按软件、近 7 天 / 近 30 天 / 全部、Token / 费用切换；「全部工具」汇总已读取的来源。各软件保留独立的用量记录，切换 Codex 账号或 provider 不会把其他软件的记录算到 Codex 里。选择「全部」时，累计值覆盖已读取的历史记录，详情图仍展示最近 30 天。

| 软件 | 用量来源 | | --- | --- | | Codex | 本机 ~/.codex/sessions 与 ~/.codex/archived_sessions | | Claude Code | 本机 Claude Code 会话记录 | | OpenCode | 本机 OpenCode 数据库或旧版记录；额度只读取 OpenCode 自己的 OpenCode Go / 接入服务 | | DeepSeek Harness | 本机 DSH 会话记录 | | Antigravity | 本机会话 JSONL 与 SQLite 生成元数据中的 Token 计数；不可读取的旧历史标为不完整 | | Grok | 复用已有 Cursor 账号登录，读取统一账单明细，包含同账号其他设备上的 Grok Bot、Grok 网页和 Cursor 用量 |

Claude Code、OpenCode、DeepSeek Harness 与 Antigravity 由应用在后台只读扫描，本地历史按软件汇总，不把缺少可靠账号身份的记录分配给手动账号。OpenCode 额度读取其 OpenCode Go 或已配置接入服务，不读取 OpenCode 内保存的 OpenAI OAuth 账号额度。Grok（兼容 Cursor 账号）支持自动识别桌面登录和手动添加网站 Cookie／JWT，按稳定用户 ID 分开保存与查询账号用量、额度和套餐；工具用量汇总所有未暂停账号的已知历史，额度仍显示选中的监测账号，不改变 Cursor 桌面端登录。Cursor CSV 导入绑定明确选中的账号，再次导入替换该账号历史，避免重复相加。Antigravity 按生成事件去重合并日志与数据库，输入、输出和缓存 Token 分桶统计；不使用额度百分比推算 Token。账号元数据与历史缓存不含凭据；手动会话和受管凭据单独保存在仅当前用户可读写的文件中，不写入日志。Cursor 个人用量接口未公开，接口变化或同步失败时会保留该账号原有历史并显示失败状态。 Grok 使用统一账单导出接口，每段最多读取 31 天；首次从服务端账号创建时间补齐可查询历史，之后重读最近 31 天并保留较早记录，旧月份暂时失败时保留近期记录与已保存历史，并在后续刷新重试。订阅内的零额外扣费不会冒充零模型成本。展开时主账号固定显示在上方，仅在下方显示其他账号。

Codex 的历史用量使用本机 ~/.codexbar/cost-usage.sqlite 派生索引。应用只读取新增或变化的 JSONL 字节，并以后台分片方式追赶大型历史；扫描期间继续显示上一次可用结果与扫描状态。该索引可安全重建，不会修改原始 session。Codex 本地 session 的 token 口径为 input + cached_input + output；其他软件使用各自记录报告的用量字段。跨软件汇总缓存位于 ~/.codexbar/tool-usage-summary.json，保存按天汇总、模型／会话／项目的用量元数据、来源状态与时间信息，不保存对话正文或登录凭据。

这些数字取决于本机记录、Cursor 用量接口或导出文件的覆盖范围，不代表实时用量或官方账单。某些来源没有提供可信费用时，费用视角会显示已知部分并标明不完整；Token 仍可单独查看。

另外，当前界面还补上了几类更贴近真实日常切换的能力：

• OpenAI 账号支持 手动切换 / 聚合网关 两种使用模式
• 支持在设置页里切换 OpenAI 账号排序方式：按当前用量排序，或按手动顺序展示
• 支持设置手动激活行为：只改配置，或直接拉起新的 Codex 实例；已在运行的实例会继续保留

额度恢复后自动继续

此功能默认关闭。在「会话」页或「设置 → 额度」中选择与 Codex 桌面端相同的当前账号，打开 「额度恢复后自动继续」，再为需要守候的线程点击「确认守候」。首次需明确确认每个 线程的账号归属；线程的创建账号不一定是它当前使用的账号，程序不会自动猜测。 默认的「桌面端当前账号（自动识别）」会显示识别出的账号，并在开启时固定其身份； 也可手动选择对应账号。账号不一致、未登录与聚合模式会分别说明原因。 也可以明确选择一个已经因额度耗尽而停止的线程；不会自动接管其他旧任务。

开启后，Codexbar 在后台识别新的明确额度失败，保存等待记录，并按服务端重置时间 重新查询额度。五小时额度恢复但周额度仍耗尽时会继续等待。恢复通过桌面端自带的 codex queue 回到原线程，保留模型、权限和目录；界面区分「已入队」与「已确认运行」。 取消守候，或检测到手动中断、归档、Goal 暂停或新输入时，旧等待会失效；记录在应用重启后保留， 发送结果不明确时不自动重发。已经提交的消息需在原线程停止，关闭守候不会撤回消息。

目前支持本机 Codex 桌面主线程和手动切换模式下明确绑定的 OpenAI 账号。聚合网关、 远程线程、内部子代理及无法确认的独立额度类型不自动恢复。需要电脑唤醒、网络可用， 并保持 Codexbar 和 Codex 桌面端运行；电脑睡眠期间不执行，唤醒后重新检查。

本版本的回归与验收范围见发布验证记录。 隔离状态回放不等同于真实额度耗尽、恢复或 Codex 界面「停止」按钮的端到端验收。

版本检测与更新

修复后的客户端运行时会直接扫描 GitHub Releases 列表，选择第一个可安装的正式稳定版本；应用启动时会做非阻塞检查，菜单栏里也可以手动触发“检查更新”。

但要特别说明当前边界：

• 当前稳定版本默认仍是 guided download / install
• 这表示发现新版本后，codexbar 会在菜单和更新状态里显示可用版本，由你继续打开匹配安装包下载链接
• 运行时会跳过 draft、prerelease、以及不带 dmg/zip 资产的 release
• 当前版本不会假装已经支持自动替换旧 app 并自动重启
• release-feed/stable.json 只保留这一次 1.1.8 -> 1.1.9 的兼容桥接，不再是修复后客户端的运行时真相源
• 如果你已经安装了首发 1.1.9，同版本重发不会自动把它识别为可升级；需要手工下载重发 build

• docs/update-feed-rollout.md

适合哪些用户

如果你符合下面这些情况，codexbar 会比较有用：

• 你会同时使用 OpenAI 官方账号和第三方 OpenAI 兼容 provider
• 你同一个 provider 下会维护多组 API key
• 你不想每次切换都手改 config.toml
• 你希望保留同一个 ~/.codex 的历史池和 resume 体验

Star 历史

OpenAI 登录方式

当前 OpenAI 登录采用“浏览器授权 + localhost 回调捕获，必要时可手工粘贴回调”的方式。入口在顶部 额度 → ＋ → 添加 Codex 账号：

1. 选择「添加 Codex 账号」
2. 在浏览器里完成授权
3. 当浏览器跳到 http://localhost:1455/auth/callback?... 时，codexbar 会自动捕获回调
4. codexbar 直接完成 token 交换并导入账号

顶部下拉菜单统一切换「额度、统计、工具、模型、项目、会话、设备、趋势」八个页面，默认打开「额度」。原管理页合并为额度页，原看板主页改名为统计，不再分为管理／看板两种模式，也无需底部导航。可在设置的「页面导航」中调整顺序与显示范围，额度和统计始终保留；原有自定义顺序与统计模块偏好继续沿用。

额度页顶部显示所选时间范围的总 Token、费用估算和数据源状态，可以切换日期和指标。软件以紧凑的平铺分段展示，账号数量并入标题、更新时间并入账号行。总览行的「排序」可调整并保存软件顺序；工具用量页则按当前时段的 Token 从高到低排列，同量时保持原顺序。各软件点击标题即可在本页展开／收起，并记住状态。Codex 收起后仍显示当前账号、额度、模型、推理强度、服务档位和上下文设置；展开只追加其他账号和管理内容，保留 GPT Reserve、重置卡及账号操作。

添加账号与连接中转站统一使用顶部「＋」；已有账号在各软件分段内管理。标题旁的小图表按钮进入该软件的用量详情，「…」菜单保留刷新、自动识别、启用或暂停及 Cursor CSV 导入等操作。目录和 CSV 等配置放在「读取设置」。暂停的软件仍可在额度页启用。

退出应用时，右键单击菜单栏里的 Codexbar 图标，选择「退出 Codexbar」；也支持 Control＋单击。Codex「账号管理」标题旁不再放置「…」菜单，界面语言统一在「设置 → 常规」中调整。

Codex 重置卡到期提醒可点「×」关闭，重启后仍记住，可在「设置 → 面板 → 额度提醒」重新开启。Claude 重置卡单独显示有效库存及到期时间，「使用」会打开 Claude 官方用量页，由用户确认账号后兑换。关闭提醒不会隐藏或消耗卡片。

| 软件 | 原生接入与查询 | | --- | --- | | Codex | 保留 OAuth 多账号、逐账号额度与重置卡、路由和第三方中转站管理 | | Cursor | 桌面账号自动识别，Cookie／JWT 手动添加；独立查询各账号用量、套餐与额度，可改名、暂停、选择看板账号、更新或删除手动凭据 | | Claude Code | 浏览器 OAuth 登录及授权码回退；本机 OAuth 或已有 OAuth token/sessionKey/Cookie；自动读取组织、订阅额度和重置卡；普通 API Key 不含订阅额度 | | OpenCode | 自动识别 Go 接入；命名连接支持 Go API Key 和／或网站 Cookie，可改名、排序、暂停、移动凭据与删除，分别查询 Go 额度或网站余额 | | DeepSeek Harness | 保留本地服务余额快照；识别明确绑定官方服务的环境 Key，也可保存／清除官方 DeepSeek API Key 查询余额 | | Antigravity | 本机账号识别与多账号管理；显示服务端额度窗口，本地 Token 历史独立汇总 |

Antigravity 的 OAuth 客户端配置不随源码或构建产物分发。登录和令牌刷新需要在本机 ~/.codexbar/antigravity-oauth-client.json 提供 client_id、client_secret 两个字段，文件必须由当前用户拥有且权限为 0600；也可同时提供 CODEXBAR_ANTIGRAVITY_CLIENT_ID 和 CODEXBAR_ANTIGRAVITY_CLIENT_SECRET 环境变量。配置缺失、权限过宽或只提供一个环境变量时会明确报错，不使用内置备用值。不要将真实客户端配置加入仓库。

DSH 的历史余额快照与实时 API 查询分开显示。新旧 DeepSeek 服务标识仅在凭据来源身份相同的情况下归并；金额相同不会被当成同一账号。快照的「重读快照」保留原始更新时间，实时余额需要明确绑定官方地址的 Key。自动发现的 DSH 来源可「隐藏此来源」并随时恢复，不会删除 DSH 的配置、凭据或历史快照。

账号接入与查询逻辑适配 Token Monitor 的现成实现，源码与安装包保留 MIT 归属和许可证，详见 第三方声明。各服务的认证和额度范围不同，余额不换算为订阅百分比，软件共享的本地历史也不冒充某个连接的账单。

成本与账单说明

这里展示的是本地记录与导入数据的用量视角，不是官方账单页面的精确账单。

需要特别说明：

• token 数量更适合作为稳定指标
• Codex 金额基于模型价格表估算；其他软件的金额取自其本地记录、Cursor 用量接口或导出，缺失时不会补造价格
• 设置页会自动列出 Codex 本地 session 中出现过的历史模型，你可以直接为这些模型设置 input / cached input / output 单价
• Codex 中未配置价格的模型默认按 0 成本处理，但 token 汇总仍会正常显示
• 首次建立大型历史索引时会在后台逐步追赶；未知或扫描中状态不会被当作真实 0 展示
• 对自定义 OpenAI 兼容 provider，显示的金额不一定等于真实供应商扣费

项目边界

当前版本重点是：

• 多账号管理
• 多 provider 切换
• 共享 ~/.codex 会话池
• 本地 usage / 成本统计

运行环境

• macOS 13+
• Codex Desktop / CLI
• Xcode 15+（如果你要本地编译）

本地构建

git clone https://github.com/lizhelang/codexbar.git
cd codexbar
open codexbar.xcodeproj

然后：

1. 在 Xcode 里选择自己的签名团队
2. 构建并运行 codexbar target

致谢

这个项目参考了以下 MIT 许可证项目的思路、实现或界面设计：

• xmasdong/codexbar
• steipete/CodexBar
• Javis603/token-monitor（菜单与设置界面的视觉层级参考）

• THIRD_PARTY_NOTICES.md

License

MIT