利用AutoHotkey实现Claude执行状态托盘指示器

背景

在利用 Claude 等 AI 助手进行复杂任务处理时，用户往往面临一个痛点：无法直观地判断 AI 当前是否正在后台运行或生成响应。特别是在通过命令行或自动化脚本调用 AI 时，缺乏明确的视觉反馈会导致用户体验割裂。

本文分享了一种基于 Windows 环境的轻量级解决方案，旨在通过系统托盘图标来实时反映 Claude 的执行状态。该方案利用了 Claude 官方提供的 Hooks（钩子）机制，结合 AutoHotkey (AHK) 脚本，实现了当 Claude 开始执行任务时在任务栏显示红色标识，而在任务结束或用户停止时自动隐藏标识的功能。这不仅提升了交互的直观性，也为自动化工作流的监控提供了简单有效的视觉反馈。

核心内容

该方案的核心逻辑是通过文件状态和进程管理来同步 Claude 的运行状态与系统托盘图标。具体实施步骤如下：

1. 环境准备与资源创建

• 安装 AutoHotkey：首先需要安装 AutoHotkey v2 软件，用于编写和执行自动化脚本。
• 准备图标文件：创建一个名为 red.ico 的红色图标文件，用于在 Claude 运行时显示。
• 创建脚本文件：新建一个名为 cc.ahk 的 AutoHotkey 脚本文件。

2. AutoHotkey 脚本逻辑 (cc.ahk)

该脚本作为状态指示器，主要执行以下操作：

• 初始化：定义停止信号文件 (cc_stop.flag) 和进程 ID 文件 (cc.pid) 的路径。
• 清理与启动：尝试删除旧的标志文件和 PID 文件，并将当前进程 ID 写入 cc.pid。
• 图标设置：使用 TraySetIcon 将系统托盘图标设置为 red.ico，并设置 A_IconHidden := false 确保图标可见。
• 状态监控：设置一个每 500 毫秒执行一次的定时器 CheckStop。
• 停止逻辑：在 CheckStop 函数中，检查是否存在 cc_stop.flag 文件。如果存在，则删除标志文件和 PID 文件，并调用 ExitApp() 退出脚本，从而隐藏托盘图标。

3. Claude Hooks 配置 (~\.claude\settings.json)

通过修改 Claude 的配置文件，利用 Hooks 机制将用户操作与 AutoHotkey 脚本联动：

• UserPromptSubmit 钩子：

  • 触发时机：当用户提交提示词（即开始新一轮对话或任务）时。
  • 执行动作：通过 PowerShell 命令启动 cc.ahk 脚本，并以隐藏窗口模式运行 (-WindowStyle Hidden)。这将激活托盘图标，表示 Claude 即将或正在处理任务。

• Stop 钩子：

  • 触发时机：当用户手动停止 Claude 的执行时。
  • 执行动作：通过 PowerShell 命令在指定路径创建 cc_stop.flag 文件。
  • 联动效果：cc.ahk 脚本检测到该标志文件后，会自动清理环境并退出，从而移除托盘上的红色图标。

4. 自动化生成提示

用户可以直接让 Claude 根据上述逻辑生成完整的脚本和配置代码。提示词示例为：“根据 cc.ahk 和 ~/.claude/settings.json 的 hooks，完成功能，claude 正在执行中时，任务管理器显示 red.ico，claude 执行完毕，任务管理器隐藏 red.ico”。

关键要点

• 状态可视化：通过系统托盘图标的显隐，提供了 Claude 运行状态的即时视觉反馈，解决了黑盒执行的不确定性。
• 双向联动机制：
  • 启动联动：利用 UserPromptSubmit 钩子启动 AHK 脚本，确保每次新任务开始时图标亮起。
  • 停止联动：利用 Stop 钩子生成停止标志文件，由 AHK 脚本轮询检测并退出，实现状态的同步关闭。
• 轻量级实现：无需复杂的后台服务或数据库，仅依赖文件读写和简单的脚本逻辑，资源占用极低。
• 跨组件协作：巧妙结合了 Claude 的 Hooks 系统、AutoHotkey 的 GUI/托盘管理能力以及 PowerShell 的进程控制能力，实现了多工具间的无缝协作。
• 路径配置注意：在实际应用中，需确保 settings.json 中 PowerShell 命令指向的 cc.ahk 和 red.ico 路径与实际文件路径一致，否则脚本将无法正确启动或显示图标。

意义与影响

这一技巧虽然看似微小，但对于提升 AI 辅助编程和自动化工作流的体验具有重要意义：

1. 增强用户掌控感：在长时间运行的 AI 任务中，明确的视觉反馈让用户能够清晰地感知系统状态，减少等待焦虑，提升对自动化流程的信任度。
2. 降低调试成本：对于开发者而言，通过简单的图标状态即可快速判断 AI 进程是否卡死或未响应，无需频繁打开任务管理器或日志文件进行排查。
3. 启发自动化设计思路：该方案展示了如何利用现有工具的 Hooks 机制与外部脚本进行深度集成，为构建更复杂的 AI 代理（Agent）监控和反馈系统提供了可复用的设计模式。
4. 推广无代码/低代码集成：通过 AutoHotkey 和配置文件即可实现功能，降低了非专业程序员接入 AI 自动化流程的门槛，促进了 AI 工具在日常办公场景中的普及。