Claude API用量监控桌面小组件开发实战：Python+SwiftBar实现成本可视化

1. 项目概述：一个提升Claude使用效率的桌面小工具

最近在折腾AI工具链的时候，发现了一个挺有意思的开源项目，叫claude-usage-widget。这名字听起来就挺直白的，一个用来监控Claude使用情况的桌面小工具。对于像我这样重度依赖Claude进行代码审查、文档撰写和头脑风暴的人来说，这玩意儿简直是刚需。你想想，每次用Claude API，心里都得盘算着：这个月额度还剩多少？这次对话消耗了多少token？别一不小心用超了，或者某个复杂问题问得太深，成本蹭蹭往上涨。这个项目就是来解决这个痛点的。

简单来说，claude-usage-widget是一个可以常驻在你桌面（比如macOS的菜单栏）的小组件。它能实时显示你当前Claude API的使用情况，包括已用额度、剩余额度、各模型调用次数和成本估算。这比每次都去登录Anthropic的官网后台查看要方便太多了，属于那种“用了就回不去”的效率工具。它的核心价值在于将后台的、静态的数据，变成了前台的、动态的、可视化的信息流，让你对AI资源的使用心中有数，从而更合理地进行任务规划和成本控制。

这个项目适合所有通过API使用Claude的开发者、产品经理、内容创作者乃至小型团队。无论你是用Claude来辅助编程、生成营销文案，还是进行数据分析，这个小工具都能帮你避免“盲用”API，实现更精细化的管理和更高效的协作。接下来，我就结合自己的部署和使用经验，把这个项目的里里外外拆解清楚，从设计思路到避坑指南，希望能帮你快速上手，把它变成你AI工作流中的一个得力助手。

2. 核心设计思路与架构解析

2.1 为什么需要一个独立的用量监控工具？

在深入代码之前，我们得先想明白一个问题：Anthropic官方不是有控制台吗？为什么还要额外搞一个工具？这背后其实有几个很实际的考量。

首先，效率断层。官方控制台是一个网页，你需要打开浏览器、登录、找到用量统计页面，这一套操作下来，信息获取路径太长，打断了你当前的工作流。而开发或创作过程往往是高度沉浸和连续的，频繁切换上下文去查用量，非常影响心流状态。这个小工具的设计哲学就是“零打扰”，将关键信息以最轻量、最便捷的方式呈现在你的视野边缘（比如菜单栏），扫一眼就能获取，完全无需中断手头工作。

其次，数据聚合与实时性。官方控制台的数据更新可能有延迟，并且展示的信息维度可能不是你最关心的。claude-usage-widget的核心思路是通过定期轮询（Polling）Anthropic的API，获取最新的用量数据，并按照开发者更易理解的维度进行重组和展示。比如，它可能会将“输入token”和“输出token”分开统计，并乘以实时单价来估算成本，或者按不同的模型（如claude-3-opus、claude-3-sonnet）分别统计调用次数。这种自定义的数据视图，比通用的后台报表更有针对性。

最后，预警与自动化。这是官方控制台不太容易做到的进阶功能。想象一下，当你的API用量达到月度额度的80%时，工具图标变黄；达到90%时变红并发送一个系统通知。这能有效避免额度用超导致的服务中断。claude-usage-widget的架构天然支持这类扩展，因为它是一个持续运行的后台进程，可以轻松集成监控和告警逻辑。

2.2 技术栈选型与架构拆解

浏览项目的源码（通常托管在GitHub），我们可以推断出它的典型技术栈。这类桌面小组件，尤其是针对macOS的，常见的技术方案有几种：

1. Swift + AppKit原生开发：性能最好，与系统集成度最高，但开发门槛也高，且跨平台困难。
2. Electron：使用Web技术（HTML/CSS/JS）构建跨平台桌面应用。优点是开发快、生态丰富，缺点是应用体积大、内存占用高。对于一个简单的状态监控工具来说，有点“杀鸡用牛刀”。
3. Python + 图形库（如Tkinter, PyQt）：Python在数据处理和API调用方面有天然优势，结合轻量级GUI库可以快速成型。但打包成独立应用相对麻烦，且原生体验一般。
4. 脚本 + 系统原生小组件：这是我认为最优雅和高效的方案。也是claude-usage-widget最可能采用的路径。具体来说：
   • 后端（数据获取与处理）：使用Python或Node.js脚本，负责定时调用Anthropic的Usage API，解析返回的JSON数据，并进行计算（如成本估算）。
   • 前端（状态显示）：利用操作系统提供的轻量级UI组件。在macOS上，就是BitBar、SwiftBar或xbar这类工具。它们允许你用任何脚本语言（Bash, Python, Ruby, JS等）输出特定格式的文本，这些工具会读取脚本输出并将其渲染成菜单栏项。图标、颜色、下拉菜单都可以通过脚本控制。

从项目的名称和定位来看，采用“Python脚本 + SwiftBar/xbar”方案的概率极大。这个组合的优势非常明显：

• 极简：核心逻辑就是一个Python脚本，几十到百来行代码。
• 高效：系统资源占用极小，就是一个脚本进程加一个原生菜单栏控件。
• 灵活：所有显示逻辑（文本、图标、颜色、菜单项）完全由你的脚本输出决定，定制能力极强。
• 易部署：几乎无需“安装”，配置好脚本路径和运行环境即可。

注意：这里提到的BitBar、SwiftBar、xbar本质是同一类工具的不同迭代或分支。BitBar是开创者，但已停止维护；SwiftBar是其用Swift重写的现代版本，更稳定、功能更强；xbar是另一个活跃分支。在后续的实操中，我们会以功能更完善的SwiftBar为例。

2.3 数据流与核心模块设计

理解了技术栈，我们就能勾勒出这个小工具内部的数据流动图：

1. 配置模块：脚本首先需要读取你的Claude API Key。出于安全考虑，绝不会将API Key硬编码在脚本里。通常的做法是将其存储在系统的环境变量中（如ANTHROPIC_API_KEY），或者一个外部配置文件（如config.json）中，脚本启动时去读取。
2. 数据获取模块：这是核心。脚本会定期（比如每5分钟或10分钟）向Anthropic的API端点（例如https://api.anthropic.com/v1/usage）发起一个HTTP GET请求。请求头中必须包含x-api-key: YOUR_API_KEY用于鉴权。
3. 数据处理模块：API返回的通常是JSON格式的数据，包含了当前周期（通常是当月）的用量摘要。脚本需要解析这个JSON，提取出诸如total_usage（总花费，以美元计）、input_tokens、output_tokens等关键字段。然后，根据Anthropic公开的模型定价表（例如claude-3-opus每百万输入token多少钱，输出token多少钱），可以更精细地估算出各模型的花费占比。
4. 显示渲染模块：这是与SwiftBar交互的部分。脚本需要将处理好的数据，按照SwiftBar规定的格式输出到标准输出（stdout）。这个格式很简单：
   • 第一行：显示在菜单栏的主文本。例如：🟢 $12.34 / $100。
   • 后续行：以---分隔，之后的内容会成为点击菜单栏项后弹出的下拉菜单项。你可以在这里放置更详细的信息，如各模型用量、刷新按钮、甚至打开控制台的链接。

整个架构清晰、解耦，每个模块都可以独立优化或替换。比如，你可以更换数据获取的频率，修改成本计算的公式，或者完全自定义菜单栏显示的风格。

3. 环境准备与核心依赖部署

3.1 前置条件检查

在动手之前，确保你的工作环境满足基本要求。这个项目对系统环境的要求并不高，但以下几个是必须的：

1. 操作系统：由于我们主要围绕macOS的菜单栏组件展开，因此你需要一台macOS设备。理论上，Linux桌面环境（如GNOME, KDE）也有类似argos这样的工具可以实现相同效果，但本指南以macOS+SwiftBar为主流场景进行说明。Windows系统虽然也有TaskbarX等工具，但生态和易用性上差异较大，不是本项目的最佳实践平台。
2. Claude API访问权限与密钥：这是工具的数据源头。你需要注册Anthropic的开发者账户，并在其控制台中创建一个API Key。请妥善保管这个Key，它就像你的密码，一旦泄露，他人就可以用你的额度调用API。创建好后，建议立即将其添加到环境变量。
3. Python环境：大多数macOS系统都预装了Python 3。打开终端（Terminal），输入python3 --version检查。建议版本在3.8以上。如果没有，可以通过Homebrew (brew install python) 或官方安装包进行安装。
4. Homebrew（推荐）：macOS上强大的包管理器，能让我们一键安装SwiftBar等工具。如果还没安装，可以访问其官网获取安装命令。

3.2 核心工具SwiftBar的安装与配置

SwiftBar是我们将脚本“可视化”到菜单栏的桥梁。它的安装非常简单。

打开终端，使用Homebrew安装：

brew install swiftbar

安装完成后，你可以在应用程序文件夹里找到它，或者直接在Spotlight搜索“SwiftBar”启动。第一次启动时，系统可能会提示需要辅助功能权限，以便在菜单栏绘图，务必点击“打开”或“允许”。

SwiftBar的核心工作方式是监控一个特定的插件文件夹（通常位于~/Library/Application Support/SwiftBar/Plugins），并执行该文件夹下的脚本。脚本的文件名（不含后缀）就会成为菜单栏显示的名称。脚本需要具有可执行权限。

一个最简单的测试插件可以是这样的：创建一个文件~/Library/Application Support/SwiftBar/Plugins/hello.10s.sh，内容为：

#!/bin/bash echo "Hello World"

然后赋予它执行权限：chmod +x hello.10s.sh。文件名中的.10s是SwiftBar的魔法注释，表示每10秒刷新一次。保存后，SwiftBar会自动检测到新插件，并在菜单栏显示“Hello World”。点击SwiftBar图标，你也能在插件列表里看到和管理它。

3.3 API密钥的安全存储

绝对不能将API Key写在脚本里然后上传到任何地方（包括GitHub）。我们采用环境变量法，这是最通用和安全的方式之一。

打开你的终端配置文件。如果你用的是默认的bash，文件是~/.bash_profile；如果是zsh（macOS Catalina及以后默认），文件是~/.zshrc。用文本编辑器（如nano或vim）打开它。

nano ~/.zshrc

在文件末尾添加一行：

export ANTHROPIC_API_KEY="你的实际API密钥"

保存并退出编辑器。然后让配置生效：

source ~/.zshrc

验证是否设置成功：

echo $ANTHROPIC_API_KEY

如果正确显示了你的密钥（中间几位被隐藏），说明设置成功。这样，你的Python脚本就可以通过os.environ.get('ANTHROPIC_API_KEY')来安全地读取这个密钥了。

实操心得：除了环境变量，对于更复杂的配置（比如多个API Key、自定义刷新频率、成本阈值），可以创建一个独立的config.yaml或config.json文件，将其放在插件目录外，并在脚本中读取。同时，务必在.gitignore文件中忽略这个配置文件，防止误提交。

4. 核心脚本编写与功能实现

4.1 解剖一个基础的用量获取脚本

现在，我们来编写最核心的Python脚本。这个脚本的任务就是：获取数据、处理数据、格式化输出。我们将其命名为claude_usage.5m.py，放在SwiftBar的插件目录下，.5m表示每5分钟运行一次。

首先，脚本需要引入必要的库：

#!/usr/bin/env python3 # -*- coding: utf-8 -*- import os import requests import json from datetime import datetime

#!/usr/bin/env python3这行叫做shebang，告诉系统用Python 3来执行这个脚本。

第一步，获取API Key并设置请求头：

def main(): api_key = os.environ.get("ANTHROPIC_API_KEY") if not api_key: # 如果环境变量未设置，则在SwiftBar下拉菜单中显示错误 print("❌ API Key Missing") print("---") print("Please set ANTHROPIC_API_KEY env var | color=red") return headers = { "x-api-key": api_key, "anthropic-version": "2023-06-01", # 使用合适的API版本 "Content-Type": "application/json" }

这里做了错误处理。如果没找到API Key，菜单栏会显示一个红叉，并且在下拉菜单中给出提示。这比脚本直接崩溃抛出异常的用户体验要好得多。

第二步，发起请求获取用量数据：

try: # Anthropic的用量API端点（请查阅最新文档确认） response = requests.get("https://api.anthropic.com/v1/usage", headers=headers, timeout=10) response.raise_for_status() # 如果状态码不是200，抛出异常 usage_data = response.json() except requests.exceptions.RequestException as e: print("🌐 Network Error") print("---") print(f"Failed to fetch data: {e} | color=orange") return except json.JSONDecodeError: print("📄 Data Error") print("---") print("Invalid response from API | color=orange") return

网络请求总是可能失败的，所以必须用try-except包裹。我们处理了网络超时、HTTP错误以及返回数据不是合法JSON的情况，并在界面上给出友好的错误提示。

第三步，解析和计算关键指标：假设API返回的数据结构如下（具体字段请以Anthropic官方文档为准）：

{ "total_usage": 15.78, "input_tokens": 1250000, "output_tokens": 450000, "monthly_limit": 100.0 }

我们的脚本可以这样解析：

total_usage = usage_data.get("total_usage", 0) # 本月已用金额（美元） monthly_limit = usage_data.get("monthly_limit", 100) # 月度额度，默认为100 input_tokens = usage_data.get("input_tokens", 0) output_tokens = usage_data.get("output_tokens", 0) # 计算使用百分比和剩余额度 usage_percentage = (total_usage / monthly_limit) * 100 if monthly_limit > 0 else 0 remaining = monthly_limit - total_usage # 简单的成本估算（假设一个平均单价，更复杂的可以按模型细分） # 注意：这里仅为示例，实际成本应由Anthropic的total_usage字段直接提供或根据详细日志计算 avg_input_cost_per_million = 15.0 # 示例单价：$15 per million input tokens avg_output_cost_per_million = 75.0 # 示例单价：$75 per million output tokens estimated_cost = (input_tokens / 1_000_000) * avg_input_cost_per_million + (output_tokens / 1_000_000) * avg_output_cost_per_million

这里有一个关键点：total_usage字段通常是Anthropic直接计算好的本月累计费用，是最权威的数据。上面的estimated_cost只是一个示例，展示如何根据token数进行估算。在实际使用中，应以total_usage为准。token数可以用来做更细粒度的分析。

第四步，格式化输出给SwiftBar：这是脚本与SwiftBar交互的“协议”。

# 1. 第一行：菜单栏主显示 # 根据使用率改变图标和颜色 if usage_percentage < 70: icon = "🟢" color = "green" elif usage_percentage < 90: icon = "🟡" color = "orange" else: icon = "🔴" color = "red" # 主显示文本：图标 + 已用金额/总额度 main_text = f"{icon} ${total_usage:.2f} / ${monthly_limit:.0f}" print(main_text) # 2. 分隔符，之后的内容为下拉菜单 print("---") # 3. 下拉菜单项 print(f"Used: ${total_usage:.2f} | color={color}") print(f"Remaining: ${remaining:.2f} | color=green") print(f"Percentage: {usage_percentage:.1f}% | color={color}") print("---") # 菜单内的分隔线 print(f"Input Tokens: {input_tokens:,}") print(f"Output Tokens: {output_tokens:,}") print(f"Estimated Cost (from tokens): ${estimated_cost:.2f} | color=gray") print("---") # 添加一些操作项 print("Refresh Now | bash='' param1='' refresh=true terminal=false") # 点击即刷新 print("Open Anthropic Console | href=https://console.anthropic.com/ color=blue") if __name__ == "__main__": main()

SwiftBar的格式化语法非常直观：

• |后面的内容是属性设置。
• color=可以设置文本颜色。
• href=可以创建一个可点击的链接。
• bash=和refresh=true组合，可以让点击菜单项时重新执行当前脚本（即刷新）。
• 使用---来创建分隔线。

4.2 实现进阶功能：多模型统计与成本细分

基础的用量显示已经很有用，但对于使用多个Claude模型（如Opus, Sonnet, Haiku）的用户，我们可能想知道每个模型的花费占比。这需要调用更详细的API，或者自己有本地的调用日志。

方案一：依赖详细的API接口（如果提供）Anthropic可能提供一个更详细的用量接口，返回按模型、按天细分的数据。你需要查阅最新的API文档。如果存在这样的接口，脚本的请求和解析部分会变得更复杂，但展示的信息会丰富得多。

方案二：本地日志分析（更灵活，但需应用配合）这是一个更强大且不依赖Anthropic的解决方案。思路是：让你的所有调用Claude API的应用程序，都将每次请求的模型、输入/输出token数、时间戳记录到一个本地日志文件（或数据库）中。然后，claude_usage_widget脚本去分析这个日志文件。

1. 日志格式设计（例如JSON Lines格式）：

   {"timestamp": "2024-05-27T10:00:00Z", "model": "claude-3-opus-20240229", "input_tokens": 1500, "output_tokens": 300} {"timestamp": "2024-05-27T10:05:00Z", "model": "claude-3-sonnet-20240229", "input_tokens": 800, "output_tokens": 500}

2. 修改脚本，增加日志分析函数：

   def analyze_local_log(log_file_path='~/.claude_api_log.jsonl'): import json from collections import defaultdict from pathlib import Path log_path = Path(log_file_path).expanduser() if not log_path.exists(): return {} model_stats = defaultdict(lambda: {'input': 0, 'output': 0, 'cost': 0.0}) # 假设我们只分析本月的日志 current_month = datetime.now().strftime('%Y-%m') with open(log_path, 'r') as f: for line in f: try: entry = json.loads(line) if entry['timestamp'].startswith(current_month): model = entry['model'] model_stats[model]['input'] += entry['input_tokens'] model_stats[model]['output'] += entry['output_tokens'] # 根据模型计算成本（需要维护一个模型单价字典） cost = calculate_cost(entry['model'], entry['input_tokens'], entry['output_tokens']) model_stats[model]['cost'] += cost except (json.JSONDecodeError, KeyError): continue return model_stats

3. 在输出中整合本地分析结果：

   # 在主函数中调用 local_stats = analyze_local_log() if local_stats: print("---") print("📊 Usage by Model (Local Log)") for model, stats in local_stats.items(): model_display_name = model.replace('claude-3-', '').replace('-20240229', '') print(f"{model_display_name}: ${stats['cost']:.2f} | color=gray font=Menlo size=12") print(f" In: {stats['input']:,} | Out: {stats['output']:,} | color=gray font=Menlo size=10")

这个方案的优点是数据完全自主可控，可以分析任意时间范围，甚至可以统计不同项目或用户的用量。缺点是需要改造你的API调用端来记录日志。

4.3 菜单栏交互与用户体验优化

一个好用的小工具，交互细节很重要。我们可以利用SwiftBar的特性做很多优化：

1. 动态图标与颜色：如上例所示，根据使用百分比切换图标（🟢🟡🔴）和文字颜色，提供强烈的视觉提示。
2. 阈值告警：除了颜色变化，还可以在用量超过一定阈值时，在下拉菜单顶部显示一个醒目的警告信息。

   if usage_percentage > 85: print("⚠️ Usage exceeding 85%! | color=red font=bold") print("---")

3. 快捷操作：在下拉菜单中加入实用操作。
   • 一键刷新：我们已经实现了。
   • 打开控制台：直接链接到Anthropic控制台。
   • 复制额度信息：可以添加一个菜单项，点击后将“已用$X.X，剩余$X.X”复制到剪贴板，方便在聊天或报告里分享。

     import subprocess # ... 在菜单项中 ... copy_text = f"Claude API: Used ${total_usage:.2f}, Remaining ${remaining:.2f}" print(f"Copy Summary | shell='bash' param1='-c' param2='printf \"{copy_text}\" | pbcopy' terminal=false")

     pbcopy是macOS上将文本复制到剪贴板的命令。
4. 自定义刷新频率：脚本文件名中的.5m、.1h控制了基础频率。你还可以在脚本内部根据情况动态调整。比如，在办公时间（9-18点）每5分钟刷新一次，其他时间每30分钟刷新一次。

   current_hour = datetime.now().hour if 9 <= current_hour < 18: refresh_interval = 300 # 5分钟，单位秒 else: refresh_interval = 1800 # 30分钟 # SwiftBar可以通过在输出第一行前加特定注释来改变频率，但更简单的方法是设置不同的文件名。 # 更动态的方法需要SwiftBar插件支持或调用其API，这里不展开。

5. 部署、调试与自动化运行

5.1 脚本的放置与权限设置

写好Python脚本后（假设命名为claude_usage.5m.py），我们需要将其放到SwiftBar能识别的位置，并确保它可以执行。

1. 找到插件目录：打开SwiftBar，在菜单栏点击其图标，选择“Preferences...”，在设置窗口中可以看到“Plugin Folder”的路径。通常是~/Library/Application Support/SwiftBar/Plugins。
2. 复制脚本：将你的claude_usage.5m.py文件复制到上述插件目录中。
3. 赋予执行权限：打开终端，执行：

   chmod +x ~/Library/Application\ Support/SwiftBar/Plugins/claude_usage.5m.py

   chmod +x命令给文件添加了“可执行”权限，这是必须的一步。
4. 重启SwiftBar：通常SwiftBar会自动检测新插件。如果没有立即出现，可以点击SwiftBar图标，选择“Refresh All Plugins”，或者退出并重新启动SwiftBar应用。

现在，你应该能在菜单栏看到你的小工具了。如果显示的是文本而不是图标，可能是因为脚本第一行输出的就是文本。如果显示一个问号或错误图标，说明脚本执行出错了。

5.2 调试与日志查看

脚本没有按预期工作？别急，调试是必经之路。

1. 直接在终端运行脚本：这是最直接的调试方法。在终端中，先切换到插件目录，然后直接运行你的脚本：

   cd ~/Library/Application\ Support/SwiftBar/Plugins ./claude_usage.5m.py

   观察输出是否符合SwiftBar的格式要求（第一行是主文本，然后是---，然后是菜单项）。同时，任何Python的异常信息也会打印在终端里，这是定位错误的关键。

2. 检查SwiftBar的错误日志：SwiftBar自身也会记录插件运行的错误。点击菜单栏图标，选择“Open Plugin Folder”，在同级目录下可能会找到Logs文件夹，里面有运行日志。或者，在SwiftBar的偏好设置中，也可能有打开日志的选项。

3. 常见错误：

   • 权限错误：Permission denied。确保已执行chmod +x。
   • Python环境问题：/usr/bin/env: python3: No such file or directory。确保Python 3已正确安装且在PATH中。有时可能需要指定完整路径，如#!/usr/local/bin/python3。
   • 模块未找到：ModuleNotFoundError: No module named 'requests'。你需要安装脚本依赖的Python库。在终端运行pip3 install requests。
   • API Key未设置：脚本中读取环境变量失败。确保你已经在正确的shell配置文件（.zshrc或.bash_profile）中设置了ANTHROPIC_API_KEY，并且已经source了该文件。特别注意：GUI应用（如SwiftBar）启动时加载的环境变量可能和你的终端环境不同。最可靠的方法是，在SwiftBar的插件脚本中，通过读取一个配置文件来获取API Key，而不是完全依赖环境变量。或者，你可以将环境变量设置在全局位置，如/etc/launchd.conf或通过launchctl setenv，但这更复杂。对于SwiftBar，一个简单粗暴但有效的方法是：在脚本开头，通过读取一个仅所有者可读的配置文件来获取密钥。

5.3 实现开机自启动与后台常驻

我们希望这个小工具能开机自动运行，并且稳定地在后台工作。

对于SwiftBar本身：

1. 打开“系统设置” -> “通用” -> “登录项”。
2. 点击“允许在后台”下方的“+”号。
3. 在应用程序中找到并添加“SwiftBar”。 这样，每次你登录macOS时，SwiftBar就会自动启动。

对于脚本的稳定性： 脚本本身是SwiftBar调用的，SwiftBar会负责按照你设定的频率（通过文件名中的时间间隔）定期运行它。你不需要自己写定时任务（如cron）。SwiftBar会管理脚本的生命周期。如果脚本运行崩溃，SwiftBar会在下次刷新时再次尝试运行它。

注意事项：虽然SwiftBar很稳定，但你的脚本如果存在未处理的异常（比如网络突然中断导致requests超时抛出异常），可能会导致当次运行没有输出，菜单栏显示为空或错误。因此，脚本内完善的异常处理至关重要，必须确保在任何错误情况下，都能输出一个有效的、对用户友好的状态信息到标准输出，而不是让Python异常堆栈信息污染输出导致SwiftBar解析失败。

6. 常见问题排查与进阶技巧

6.1 问题排查速查表

6.2 进阶技巧与个性化定制

1. 多账户支持：如果你有多个Anthropic账户（比如工作和个人），可以轻松扩展。在配置文件中存储多个API Key和别名，然后在脚本中轮流查询或让用户在下拉菜单中选择要显示的账户。

   # config.json { "accounts": [ {"name": "Work", "api_key": "key1"}, {"name": "Personal", "api_key": "key2"} ] }

   在菜单栏主显示当前账户，下拉菜单中提供一个“Switch Account”的子菜单，点击后切换活动账户并刷新。

2. 成本预测：基于本月已过天数和已用额度，简单预测本月总花费是否会超支。

   from datetime import datetime, timedelta now = datetime.now() first_day_of_month = datetime(now.year, now.month, 1) days_passed = (now - first_day_of_month).days + 1 total_days_in_month = (datetime(now.year, now.month + 1, 1) - timedelta(days=1)).day if now.month != 12 else 31 daily_avg = total_usage / days_passed projected = daily_avg * total_days_in_month print(f"Projected Monthly: ${projected:.2f} | color={'red' if projected > monthly_limit else 'gray'}")

3. 与系统通知中心集成：当用量超过阈值时，发送一个本地系统通知，这样即使你没看菜单栏也能知道。

   if usage_percentage > 90: # 使用macOS的osascript命令发送通知 title = "Claude API Alert" message = f"Usage is at {usage_percentage:.1f}%! Remaining: ${remaining:.2f}" os.system(f"osascript -e 'display notification \"{message}\" with title \"{title}\"'")

4. 数据持久化与简单图表：将每次获取的用量数据（时间戳、已用额度）追加到一个CSV文件中。然后，可以写一个单独的脚本（或集成到主脚本中，以另一个菜单项触发），用matplotlib生成一个本月用量趋势图，并保存为图片。在下拉菜单中添加一个“Show Chart”项，点击后用预览打开图片。这需要额外的依赖，但可视化效果更直观。

6.3 安全最佳实践重申

最后，必须再次强调安全，因为API Key就是钱。

• 永远不要硬编码：绝对不要将API Key直接写在脚本的源代码里。
• 使用配置文件并设置严格权限：将密钥存储在用户主目录下的一个配置文件中（如~/.config/claude_widget/config），并将该文件的权限设置为仅所有者可读可写 (chmod 600)。
• 忽略配置文件：如果你的脚本和配置在同一个Git仓库下，务必在.gitignore文件中添加你的配置文件名，防止误提交到公开仓库。
• 定期轮换密钥：如果可行，定期在Anthropic控制台生成新的API Key并更新配置文件，禁用旧的Key。

这个claude-usage-widget项目，本质上是一个思维的火花，它展示了如何用简单的工具链（Python + SwiftBar）解决一个具体的效率痛点。它的代码可能不长，但蕴含的思路——主动获取、近场展示、预警提示——却可以应用到很多其他场景，比如监控服务器状态、跟踪股票价格、显示待办事项等等。