让 Codex Desktop 在多账号 / 多 provider 切换时，继续共用同一个 ~/.codex 历史池。
English | 简体中文
codexbar 是一个面向 macOS 的菜单栏工具。它不重做 Codex，而是把“切账号、切 provider 时最容易把上下文和历史切散”的那一段工作收回来。
2.0.1 的完整改动见发布说明，包含统一页面导航、额度页和多工具账号管理。
切账号 / 切 provider，不等于把 Codex 原本的 session 池拆成几份。
- 只保留一个
~/.codex，不为每个账号单独建一套CODEX_HOME - 在菜单栏里管理 OpenAI OAuth、多 OpenAI 兼容 provider、同 provider 多组 API key
- 支持 OpenAI 账号的 手动切换 / 聚合网关 双模式
- 读取 Codex、Claude Code、OpenCode、DeepSeek Harness 的本地用量；自动同步 Cursor 用量，并保留 CSV 导入
- 在菜单栏先选软件，再切换今天 / 本月 / 总计（另有近 7 天 / 近 30 天），以及 Token / 费用视角
- 切换只影响后续新会话，不会把已有历史 session 从共享池子里“切没了”
如果你经常在不同 OpenAI 账号、不同中转站、或者不同 OpenAI 兼容 provider 之间来回切，通常会遇到几件事：
- 配置切过去了，但上下文像是断了
- 历史 session 还在磁盘里，却因为切账号 / 切 provider 变得不连贯
- 反复手改配置文件很烦，恢复现场也麻烦
codexbar 解决的不是“再造一个 Codex”，而是把这条切换链路变成一个更稳、更快、更少丢上下文的菜单栏工作流。
上面的海报式概览把当前版本最重要的工作流放在一张图里：codexbar 是 macOS 菜单栏里的 Codex Desktop companion，用来在 OpenAI 账号、兼容 provider 和本地 gateway 工作流之间切换，同时继续保留同一个 ~/.codex 会话池。
很多“多账号切换”方案会直接给每个账号单独建一套 CODEX_HOME。这样做隔离很强，但代价也很明显：
- 历史被分散到多份目录
- 切换之后很容易觉得“上下文没了”
- 需要在不同账号环境之间来回找 session
codexbar 选的是另一条路：
- 仍然只保留一个
~/.codex - 保留
~/.codex/sessions和~/.codex/archived_sessions这一套共享历史池 - 当前激活的 provider / account 会同步到
~/.codex/config.toml和~/.codex/auth.json - 切换只影响之后发起的新请求和新会话
这也是它最核心的价值：切账号 / 切 provider，不等于把 Codex 原本的历史池拆掉。
- 多 OpenAI OAuth 账号管理
- 多 OpenAI 兼容 provider 管理
- 同一 provider 下挂多组 API key
- 菜单栏里快速切换 provider / account
- OpenAI 账号的 手动切换 / 聚合网关 双模式
- OpenAI 账号 CSV 导入 / 导出
- 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：通过本机转换网关连接。保存成功后会提示协议兼容性差异， 建议优先选择原生 Responses 接口。工具调用、流式输出和高级功能的可用性仍取决于 服务商和模型；未支持的工具类型会明确报错。
- 转换网关支持普通 function 和 custom 工具的调用/结果转换。custom 的 grammar
要求会作为说明传递给上游，Chat Completions 无法提供相同的语法约束保证。
普通回复中展示的命令或
<tool_call>文字不会被自动当成工具执行。 - 当前转换网关不支持
namespace和托管式web_search工具。如果 Codex 默认携带 这些工具，整个请求会明确报错，即使本轮只打算执行普通命令。关闭多代理和联网搜索 后的基础工具往返已通过隔离 CLI 验证；这不代表默认配置或第三方真实模型已全面兼容。
桌面应用不依赖终端环境变量导出密钥，因此使用官方支持的 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 会话记录 |
| Cursor | 读取本机 Cursor 登录状态，向 Cursor 用量接口同步；也可从 Usage 页面导出 CSV 手动导入 |
Claude Code、OpenCode 与 DeepSeek Harness 由应用在后台只读扫描，本地历史按软件汇总，不把缺少可靠账号身份的记录分配给手动账号。OpenCode 额度读取其 OpenCode Go 或已配置接入服务，不读取 OpenCode 内保存的 OpenAI OAuth 账号额度。Cursor 支持自动识别桌面登录和手动添加网站 Cookie／JWT，按稳定用户 ID 分开保存与查询账号用量、额度和套餐；看板显示选中的监测账号，不改变 Cursor 桌面端登录。Cursor CSV 导入绑定明确选中的账号，再次导入替换该账号历史，避免重复相加。账号元数据与历史缓存不含凭据；手动会话和受管凭据单独保存在仅当前用户可读写的文件中，不写入日志。Cursor 个人用量接口未公开，接口变化或同步失败时会保留该账号原有历史并显示失败状态。
Codex 的历史用量使用本机 ~/.codexbar/cost-usage.sqlite 派生索引。应用只读取新增或变化的 JSONL 字节，并以后台分片方式追赶大型历史；扫描期间继续显示上一次可用结果与扫描状态。该索引可安全重建，不会修改原始 session。Codex 本地 session 的 token 口径为 input + cached_input + output；其他软件使用各自记录报告的用量字段。跨软件汇总缓存位于 ~/.codexbar/tool-usage-summary.json，只保存按天的用量汇总、来源状态与时间信息，不保存对话内容或登录凭据。
这些数字取决于本机记录、Cursor 用量接口或导出文件的覆盖范围，不代表实时用量或官方账单。某些来源没有提供可信费用时，费用视角会显示已知部分并标明不完整；Token 仍可单独查看。
另外，当前界面还补上了几类更贴近真实日常切换的能力：
- OpenAI 账号支持 手动切换 / 聚合网关 两种使用模式
- 支持导入 / 导出 OpenAI 账号数据文件，与 Sub2API 格式互通，方便迁移和批量整理
- 支持在设置页里切换 OpenAI 账号排序方式：按当前用量排序，或按手动顺序展示
- 支持设置手动激活行为：只改配置，或直接拉起新的 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
更新 bridge / rollout 约定见：
如果你符合下面这些情况，codexbar 会比较有用：
- 你会同时使用 OpenAI 官方账号和第三方 OpenAI 兼容 provider
- 你同一个 provider 下会维护多组 API key
- 你不想每次切换都手改
config.toml - 你希望保留同一个
~/.codex的历史池和 resume 体验
当前 OpenAI 登录采用“浏览器授权 + localhost 回调捕获，必要时可手工粘贴回调”的方式。入口在顶部 额度 → ＋ → 添加 Codex 账号：
- 选择「添加 Codex 账号」
- 在浏览器里完成授权
- 当浏览器跳到
http://localhost:1455/auth/callback?...时，codexbar 会自动捕获回调 - codexbar 直接完成 token 交换并导入账号
如果自动捕获失败，仍然可以把完整回调 URL 或单独的 code 手工粘贴回窗口。
顶部下拉菜单统一切换「额度、统计、工具、模型、项目、会话、设备、趋势」八个页面，默认打开「额度」。原管理页合并为额度页，原看板主页改名为统计，不再分为管理／看板两种模式，也无需底部导航。可在设置的「页面导航」中调整顺序与显示范围，额度和统计始终保留；原有自定义顺序与统计模块偏好继续沿用。
额度页顶部显示所选时间范围的总 Token、费用估算和数据源状态，可以切换日期和指标。软件以统一分段列表展示，点击「排序」可用上下箭头调整并保存顺序。五个软件均可直接点击标题在本页展开／收起，并记住各自状态。Codex 收起后仍显示当前账号、剩余额度、模型、推理强度、服务档位和上下文设置；展开后展示全部账号、额度窗口、GPT Reserve、重置时间与重置卡数量，保留切换、刷新、重登及删除操作。「连接中转站」在 Codex 收起时也可用，展开后可管理已有第三方服务。
Claude Code、OpenCode、Cursor 和 DeepSeek Harness 也在额度页显示额度、余额及读取状态。展开后在同一软件分段内直接自动识别、添加支持的凭据并管理连接，无需另开账号页面。目录和 CSV 等配置放在「读取设置」。标题旁「…」菜单保留刷新、启用或暂停、Cursor CSV 导入和「查看用量」。暂停的软件仍可在额度页启用。
| 软件 | 原生接入与查询 |
|---|---|
| Codex | 保留 OAuth 多账号、逐账号额度与重置卡、路由和第三方中转站管理 |
| Cursor | 桌面账号自动识别，Cookie／JWT 手动添加；独立查询各账号用量、套餐与额度，可改名、暂停、选择看板账号、更新或删除手动凭据 |
| Claude Code | 自动读取本机 OAuth；也可保存网站 sessionKey 并选择组织，查询网站订阅额度，支持清除后恢复自动发现；API Key 不含官方订阅额度 |
| OpenCode | 自动识别 Go 接入；命名连接支持 Go API Key 和／或网站 Cookie，可改名、排序、暂停、移动凭据与删除，分别查询 Go 额度或网站余额 |
| DeepSeek Harness | 保留本地服务余额快照；识别明确绑定官方服务的环境 Key，也可保存／清除官方 DeepSeek API Key 查询余额 |
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 的价格策略和 OpenAI 官方定价不同，那 README 和界面里显示的美元金额都只能视为近似估算，不应直接当作实际账单。
当前版本重点是：
- 多账号管理
- 多 provider 切换
- 共享
~/.codex会话池 - 本地 usage / 成本统计
它不会内置任何私有 provider、私有 API key、私有账号配置。你需要在自己的环境里自行添加这些内容。
- macOS 13+
- Codex Desktop / CLI
- Xcode 15+（如果你要本地编译）
git clone https://github.com/lizhelang/codexbar.git
cd codexbar
open codexbar.xcodeproj然后：
- 在 Xcode 里选择自己的签名团队
- 构建并运行
codexbartarget
这个项目参考了以下 MIT 许可证项目的思路、实现或界面设计：
- xmasdong/codexbar
- steipete/CodexBar
- Javis603/token-monitor（菜单与设置界面的视觉层级参考）
详细说明见：