CodexBar 中文教程：每个数字先看来源，再看百分比
CodexBar 把大量 AI 服务的额度、重置时间、余额和本地成本放进菜单栏与 CLI。它不是单一官方账单 API：不同 provider 可能读取 OAuth、API key、浏览器 cookie、本地 CLI、配置文件或日志。
1. 固定版本并核对发布来源
macOS 从官方 GitHub Release 或 Homebrew cask 安装；Linux 按官方安装指南选择架构并核对 SHA-256。启动后先确认实际版本，不要根据 main 的截图判断功能是否已经交付。
2. 第一次关闭 Keychain 访问
进入 Settings → Advanced，启用 Disable Keychain access。这会阻止 CodexBar 自己读取或写入 macOS Keychain，也会跳过依赖 Chromium Safe Storage 的 cookie 解密。它不能限制被启动的 Claude 等 provider CLI 自己访问凭据，这条边界要单独记住。
3. 只开启一个低权限来源
先选一个能够从本地 CLI 或单用途 API key 获取数据的 provider，不导入浏览器 cookie，也不授予 Full Disk Access。核对界面展示的账号、source、采样时间、额度窗口与官方控制台。如果身份或 reset 时间对不上，先解决来源范围，不要继续添加 provider。
4. 浏览器 cookie 会扩大权限
Chromium cookie 导入可能触发 Safe Storage Keychain 提示，Safari 存储可能需要 Full Disk Access。官方文档建议只批准与你刚执行动作相符的 item 和 app，不要选择“Allow all applications”。手动 cookie 也属于会话凭据，不应粘贴到工单或聊天记录。
5. 本地成本是估算
CodexBar 能从本地日志建立 Codex、Claude 等成本历史，官方也会标记 partial 或 unpriced 数据。缺失请求、继承会话、模型价格、缓存计算和供应商改价都会造成差异。趋势分析可以使用，付款、报销与预算控制仍要以供应商正式账单为准。
6. Adaptive 模式也有权限差别
普通 Adaptive 只调整刷新节奏；Adaptive (agent-aware) 会在获得许可后查看运行进程列表及命令行，并读取受限的会话元数据。没有明确需求时保留普通模式。隐藏 Agent Sessions 后保留的信息更少，但不等于从未读取。
7. 同类对比：CodexBar 与 AgentsView
相比 AgentsView，CodexBar 侧重额度、重置、余额和费用趋势；AgentsView 侧重长期归档多种编码 Agent 的完整会话、全文搜索、API 与 MCP。只看限额时 CodexBar 更直接；要查历史对话时才需要完整会话库。
8. 验证状态与边界
未验证：签名、公证、Homebrew、provider 登录、Keychain、cookie 解密、API 请求、用量和成本准确性、更新器、Linux desktop、CLI、plugins 与本地历史性能。
这里仅补原教程没有展开的事实和边界。安装命令与操作步骤仍以前文为准。
先判断这个项目是否适合你
近期变化与关注原因
开发者同时使用多个 AI 编码服务后，额度窗口和费用分散在不同控制台。CodexBar 当前 README 列出 78 个 provider，并提供桌面、CLI、通知和本地成本历史。
适合谁用
适合个人在菜单栏查看多个 AI 服务的剩余额度、重置时间和本地消费趋势，或用 CLI 生成机器可读快照。团队账单、合规审计和付款对账仍应回到各供应商的正式管理后台；浏览器 cookie、管理 API key 和 AWS 凭据等高权限来源应按最小权限逐项开启。
采用建议
CodexBar 适合愿意逐项审查 provider 数据源的个人用户。首次应固定 v0.64.1，只启用一个低权限来源，禁用 Keychain、cookie 自动导入和 agent-aware 检查，并与官方控制台对照；只有来源和口径都清楚后，才逐步增加 provider。
原教程未展开的系统信息
核心功能
多 provider 额度面板
按 provider 展示 session、weekly、monthly 等窗口、重置倒计时、余额和服务状态，并可把多个 provider 合并到一个状态项。
Usage & Spend 与本地历史
汇总 API 花费、订阅额度和本地日志估算，按 provider、模型、项目或时间展示。官方界面会标记不完整或无法定价的记录，数字仍不等于最终账单。
桌面与 CLI
macOS app 带 Sparkle 更新和 widgets；Linux 提供 Qt 桌面端；codexbar CLI 可输出用量与成本，供脚本和 CI 使用。
常见问题
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。