CodexBar 是什么?

CodexBar 是 macOS 菜单栏、Linux 桌面和 CLI 用量面板,用统一界面读取多种 AI 服务的额度、重置时间、余额、状态与本地成本估算。不同 provider 可能读取官方 API、OAuth、浏览器 cookies、本地 CLI、配置文件或日志,因此同一个百分比背后的来源和权限并不相同。

⭐ 17,819 Stars 🍴 1,459 Forks Swift MIT 作者: steipete
来源:github.com/steipete/CodexBar;https://github.com/steipete/CodexBar/blo… 查看 GitHub 仓库 → 📘 使用教程 →

为什么值得关注

开发者同时使用多个 AI 编码服务后,额度窗口和费用分散在不同控制台。CodexBar 当前 README 列出 78 个 provider,并提供桌面、CLI、通知和本地成本历史。

来源:github.com/steipete/CodexBar

核心功能

多 provider 额度面板

按 provider 展示 session、weekly、monthly 等窗口、重置倒计时、余额和服务状态,并可把多个 provider 合并到一个状态项。

来源:github.com/steipete/CodexBar;https://github.com/steipete/CodexBar/blo…
多种认证与数据来源

按 provider 使用 OAuth、device flow、API key、浏览器 cookies/localStorage、本地 CLI、配置文件或日志;来源可用性和权限要求由各 provider adapter 决定。

来源:github.com/steipete/CodexBar
Usage & Spend 与本地历史

汇总 API 花费、订阅额度和本地日志估算,按 provider、模型、项目或时间展示。官方界面会标记不完整或无法定价的记录,数字仍不等于最终账单。

来源:github.com/steipete/CodexBar
桌面与 CLI

macOS app 带 Sparkle 更新和 widgets;Linux 提供 Qt 桌面端;codexbar CLI 可输出用量与成本,供脚本和 CI 使用。

来源:github.com/steipete/CodexBar;https://github.com/steipete/CodexBar/blo…

技术架构

Swift 6.2 核心把 provider adapter、凭据来源、刷新调度、成本历史和渲染模型分开;macOS app、Widget 和 CLI 共用 CodexBarCore。Provider adapter 可能直接请求 API,也可能启动供应商 CLI、读取浏览器存储或已知日志位置。Codex 历史使用有上限的 WAL SQLite;配置文件保存 provider token 与选项并使用限制性权限。Linux Qt 桌面通过单独 CLI 获取数据,本机 socket 连接 desktop adapter,不需要 HTTP server。

来源:github.com/steipete/CodexBar/blob/main/docs/architecture.md;https://g…

项目知识图谱

知识图谱:项目核心节点(中心)+ 核心功能(内环六边形)+ 关键技术依赖(外环 chip) Sparkle 自动更新与签名 appcastSparkle 自动更… SweetCookieKit 和 macOS Security.framework 处理可选浏览器/Keychain 凭据SweetCookieKit… Swift Crypto、SQLite 与内置 QuickJS provider 插件运行时Swift Crypto、… 多 provider 额度面板 多种认证与数据来源 Usage & Spend 与本地历史Usage & Spend 与本… 桌面与 CLI CodexBar 项目本体 核心功能 关键依赖

技术栈

语言Swift 6.2 核心;macOS SwiftUI;Linux Qt 6 桌面框架Provider adapters + refresh coordinator + SQLite cost store + CLI/WidgetKit
Sparkle 自动更新与签名 appcastSweetCookieKit 和 macOS Security.fram…Swift Crypto、SQLite 与内置 QuickJS prov…
macOS 14+;Linux x86_64/ARM64 的 glibc 或 CLI musl 资产;Homebrew/AUR;MIT 许可
来源:github.com/steipete/CodexBar/blob/main/Package.swift;https://github.c…

快速上手

固定并核对 v0.64.1 release 资产;macOS 可从官方 GitHub Release 或 Homebrew cask 安装。首次启动先在 Advanced 打开 Disable Keychain access,只启用一个能从本地 CLI 或 API key 读取的 provider,不导入浏览器 cookies。核对显示的 source、账号范围、刷新时间和官方控制台数字;确认不需要 Full Disk Access、自动 cookie 导入或 agent-aware 进程检查后,再逐项启用。
来源:github.com/steipete/CodexBar;https://github.com/steipete/CodexBar/rel…

使用场景

适合个人在菜单栏查看多个 AI 服务的剩余额度、重置时间和本地消费趋势,或用 CLI 生成机器可读快照。团队账单、合规审计和付款对账仍应回到各供应商的正式管理后台;浏览器 cookie、管理 API key 和 AWS 凭据等高权限来源应按最小权限逐项开启。

来源:github.com/steipete/CodexBar;https://github.com/steipete/CodexBar/blo…

优势与局限

优势

  • 一个界面覆盖大量 provider,并保留每种来源的独立适配逻辑
  • 默认在设备上解析已知位置,不要求把所有记录上传到统一云服务
  • 官方文档详细说明 Keychain 提示、浏览器 cookie 与 provider CLI 的权限边界
  • macOS、Linux 桌面和 CLI 共享核心,release 资产提供校验和

局限

  • 大量 provider 依赖非统一 API、浏览器会话或本地文件,上游改版会造成失效或口径变化
  • API key、cookie、OAuth 与云管理凭据集中在一个进程和配置中,会扩大本机失陷影响
  • 禁用 CodexBar Keychain access 不能约束它启动的 provider CLI 自己访问凭据
  • 本地成本是估算,缺失模型价格、继承会话或不完整日志会造成偏差
  • Full Disk Access、浏览器解密和 agent-aware 进程检查都属于可选高权限能力,应按需开启
  • main 已进入 0.64.2 Unreleased,不能把 main 文档的所有功能直接套到已安装的 0.64.1
来源:github.com/steipete/CodexBar

最新版本

官方 Sparkle appcast 与 CHANGELOG 显示 v0.64.1 于 2026-09-22 发布,修复 provider、Linux、Kimi 和菜单栏显示等问题。main 的 version.env 已为 0.64.2,CHANGELOG 标为 Unreleased,因此本页不把 0.64.2 的改动当作已交付功能。

来源:github.com/steipete/CodexBar/blob/main/appcast.xml;https://github.com…

实测与证据

status: docs_and_source_checked_not_installed  |  checked_at: 2026-09-23  |  environment: 阅读官方 README、v0.64.1 appcast/CHANGELOG、Providers、Architecture、Configuration、Keychain、CLI、Linux 安装、Package.swift 和许可证;浅克隆 2026-09-22 的官方 main。未安装 app 或 CLI。  |  limitations: 没有验证签名、公证、Homebrew、Provider 登录、Keychain、cookie 解密、API 请求、用量和成本准确性、更新器、Linux desktop、CLI、plugins 或本地历史性能。  |  observed_output: 官方 appcast 指向 v0.64.1 发布资产,CHANGELOG 日期为 2026-09-22;main version.env 已为 0.64.2 Unreleased。README 当前列出 78 个 provider,并声明浏览器 cookies 为 opt-in、provider token 存在限制权限的配置文件。

来源:github.com/steipete/CodexBar;https://github.com/steipete/CodexBar/blo…

同类项目对比

相比 AgentsView,CodexBar 侧重跨 provider 的额度、重置、余额和本地成本显示;AgentsView 侧重长期归档多种编码 Agent 的完整会话、全文搜索、API 与 MCP。只想看剩余额度和账单趋势时 CodexBar 更直接;要搜索历史对话和项目记录时 AgentsView 更合适。两者都会集中读取敏感本地资料,应分别限制数据源。

来源:github.com/steipete/CodexBar;https://github.com/kenn-io/agentsview

总结评价

CodexBar 适合愿意逐项审查 provider 数据源的个人用户。首次应固定 v0.64.1,只启用一个低权限来源,禁用 Keychain、cookie 自动导入和 agent-aware 检查,并与官方控制台对照;只有来源和口径都清楚后,才逐步增加 provider。

来源:github.com/steipete/CodexBar;https://github.com/steipete/CodexBar/blo…

常见问题

CodexBar 会把所有 AI 账号上传到自己的云端吗?

官方描述是默认在设备上解析已知位置,并直接调用相应 provider。不同 adapter 仍会联系对应供应商;浏览器 cookie、OAuth、API key 和本地日志的路径要逐项查看,不能把所有 provider 当成同一种数据流。

CodexBar 为什么会请求 Keychain 或 Full Disk Access?

Chromium cookie 解密可能需要浏览器 Safe Storage,Safari 存储可能需要 Full Disk Access;Claude 的显式凭据修复也可能读 Keychain。没有使用这些来源时应保持关闭。

Disable Keychain access 能阻止所有凭据读取吗?

不能。它阻止 CodexBar 自己调用 Security.framework 和浏览器解密,但 CodexBar 启动的供应商 CLI 仍按该 CLI 自己的规则访问凭据。

CodexBar 显示的成本可以直接用来报销吗?

不建议。部分数字来自本地日志和价格表估算,缺失记录、模型映射、缓存与供应商价格变化都会造成偏差。付款和报销应以正式账单为准。

CodexBar v0.64.1 和 main 的功能为什么不同?

v0.64.1 是已发布版本;main 已进入 0.64.2 Unreleased。文档与源码可能先于本机安装包,判断功能时应同时核对 app 版本、对应 tag 与 changelog。

资料与核验范围
本文依据项目公开资料整理。版本、安装命令和功能边界可能随上游更新,请以所列来源和项目当前版本为准。 资料核对时间: 2026-09-23 13:55.

参考材料:README、GitHub API、依赖文件