Repolode
提交项目
steipete

steipete/CodexBar

macOS 菜单栏应用，实时显示 100 多个 AI 编码与 API 服务的用量额度、重置时间和花费。

在 GitHub 查看官网
Star
22,656
Fork
2,141
未关闭 Issue
59
最近提交
3小时前

这是什么？

CodexBar 是一款轻量的 macOS 菜单栏应用，并提供基于 Qt 的 Linux 桌面版和随附的命令行工具，用于随时查看 AI 编码服务的用量限制。每个服务都会显示会话、每周或每月的用量窗口，并倒计时到下次重置，方便在开始长任务前判断额度是否充足。

支持的服务包括 Codex、Claude、Cursor、Gemini、Copilot、OpenRouter 等数十家平台和多种 API 网关。根据服务不同，它会复用 OAuth 或 API 密钥、浏览器 Cookie、CLI 输出或本地文件进行认证，不保存密码。服务状态轮询会在菜单和图标上显示故障标记。

除了额度显示，它还能查看积分余额、API 类服务的花费图表，以及 Codex 和 Claude 的本地成本统计。脚本和 CI 可以直接调用 `codexbar` 命令行工具，`codexbar serve` 则可为第三方小组件和桌面显示屏提供数据。

核心功能

  • 01按服务显示会话、每周和每月用量窗口，并倒计时到下次重置。
  • 02支持 OAuth、API 密钥、浏览器 Cookie、CLI 输出和本地文件等认证方式。
  • 03在菜单和菜单栏图标上显示服务状态故障标记。
  • 04为 API 类服务绘制花费和用量图表，并统计本地 Codex 和 Claude 成本。
  • 05提供可用于脚本和 CI 的命令行工具，以及 macOS 上的 WidgetKit 小组件。

适用场景

  • 开始长时间编码任务前，查看 Claude 或 Codex 的剩余额度。
  • 在菜单栏中跟踪 OpenAI、OpenRouter 或 LiteLLM 等平台的 API 花费。
  • 通过命令行把用量数据接入桌面显示屏、Stream Deck 或状态栏。
  • 在 macOS 或 Linux 上集中监控多个 AI 编码订阅。

快速上手

  1. 1

    使用 Homebrew 安装 macOS 应用

    brew install --cask codexbar
  2. 2

    打开设置，启用你使用的服务商，并登录其数据源

使用前须知

  • 菜单栏应用仅支持 macOS 14 及以上版本；Linux 使用单独的 Qt 桌面应用。
  • 每个服务商在显示用量前都需要单独登录、提供 API 密钥或浏览器会话。

标签

#ai#menu-bar#macos#usage-monitoring#claude-code#codex#api-spend#swift

常见问题

CodexBar 是什么？
macOS 菜单栏应用，实时显示 100 多个 AI 编码与 API 服务的用量额度、重置时间和花费。 CodexBar 是一款轻量的 macOS 菜单栏应用，并提供基于 Qt 的 Linux 桌面版和随附的命令行工具，用于随时查看 AI 编码服务的用量限制。每个服务都会显示会话、每周或每月的用量窗口，并倒计时到下次重置，方便在开始长任务前判断额度是否充足。
CodexBar 可以免费使用吗？用的什么许可证？
CodexBar 以 MIT 许可证开源。用于商业产品前，请先确认许可证条款。
CodexBar 还在维护吗？
活跃维护中。CodexBar 最近一次提交是在 2026年10月19日。
CodexBar 适合用来做什么？
开始长时间编码任务前，查看 Claude 或 Codex 的剩余额度。 在菜单栏中跟踪 OpenAI、OpenRouter 或 LiteLLM 等平台的 API 花费。 通过命令行把用量数据接入桌面显示屏、Stream Deck 或状态栏。 在 macOS 或 Linux 上集中监控多个 AI 编码订阅。
CodexBar 怎么安装和运行？
使用 Homebrew 安装 macOS 应用: brew install --cask codexbar 打开设置，启用你使用的服务商，并登录其数据源
在哪里获取 CodexBar？
源代码和安装说明在 GitHub 上：https://github.com/steipete/CodexBar

概要由 AI 根据项目 README 生成；GitHub 数据每日更新。

相关项目