claude-monitor

Claude Monitor — 性能诊断

概述

监控 Claude Code 和本地系统的性能。诊断运行缓慢问题，测量 CPU／RAM／磁盘使用情况，检查 API 延迟，并生成系统健康报告。

何时使用此技能

• 用户提到“慢”或相关话题
• 用户提到“运行缓慢”或相关话题
• 用户提到“卡顿”或相关话题
• 用户提到“卡”或相关话题
• 用户提到“卡住”或相关话题
• 用户提到“Claude 很慢”或相关话题

何时不要使用此技能

• 任务与 Claude Monitor 无关
• 更简单、更具体的工具可以处理该请求
• 用户需要的是通用帮助，无需领域专业知识

工作原理

用于诊断和解决 Claude Code 与系统运行缓慢问题的技能。 判断瓶颈是本地（PC）还是远程（Claude API），并建议纠正措施。

何时使用

• 用户抱怨 Claude Code 运行缓慢或卡住
• 切换对话会话时加载缓慢
• Claude 回复耗时很长
• 使用 Claude Code 时 PC 似乎运行缓慢
• 用户提到性能、卡顿或运行缓慢

1. 快速诊断（Health_Check.Py）

初步本地诊断（将 替换为已安装目录；使用 --quick 可避免访问网络）：

python3 "<skill-dir>/scripts/health_check.py"

脚本会在约 3 秒内分析：

• CPU：当前使用率及各核心使用率。>80% = 可能存在瓶颈
• RAM：总量、已用量、可用量。>85% = 内存压力
• 浏览器：各浏览器进程及 RAM 使用量。总计 >5GB = 标签页过多
• Claude Code：进程及 RAM 使用量
• 磁盘：剩余空间。<10% = 影响交换空间／性能
• 网络：到 Claude API 端点的延迟
• 诊断：自动分类问题并提供建议

2. 解读结果

脚本会返回包含 diagnosis 的 JSON，其中包括：

• bottleneck：”cpu“ | ”ram“ | ”browsers“ | ”disk“ | ”network“ | ”claude_api“ | ”ok“
• severity：”critical“ | ”warning“ | ”ok“
• suggestions：建议操作列表
• summary：向用户展示的葡萄牙语摘要

向用户展示 summary，并询问是否执行建议。

3. 自动纠正措施

根据诊断结果，向用户提供以下选项：

如果 CPU 使用率高（>80%）：

• 列出 CPU 使用率最高的进程
• 建议关闭不必要的高负载进程
• 检查 Windows Update 是否在后台运行

如果浏览器占用过多（>5GB RAM 或 >40 个进程）：

python3 "<skill-dir>/scripts/health_check.py" --browsers-detail

显示各浏览器的 RAM 使用量，并建议关闭哪些浏览器。未经用户明确许可，绝不关闭任何进程。

如果磁盘空间不足（>85%）：

• 显示占用空间最大的文件夹
• 建议清理 Temp、浏览器缓存和回收站

如果网络缓慢（延迟 >500ms）：

• 测试与 api.anthropic.com 的连接
• 建议检查 VPN、代理或 WiFi 连接

4. 持续监控（可选）

如果用户希望在后台进行监控：

python3 "<skill-dir>/scripts/monitor.py" --interval 30 --duration 300

参数：

• --interval：每次采样之间的秒数（默认值：30）
• --duration：总时长，单位为秒（默认值：300 = 5 分钟）
• --output：日志文件路径（默认值：monitor_log.json）
• --alert-cpu：触发警报的 CPU 阈值（默认值：80）
• --alert-ram：触发警报的 RAM 使用率阈值（默认值：85）

监控器会定期保存快照，并在结束时生成报告，其中包括：

• CPU 和 RAM 峰值
• 趋势（改善／恶化／稳定）
• 检测到的警报事件
• 最终建议

5. Claude API 基准测试（可选）

用于测试运行缓慢是否由 API 导致：

python3 "<skill-dir>/scripts/api_bench.py"

测量外部端点的 DNS、TCP 和 TLS 握手耗时；不测量本地进程、HTTP 响应或 API 推理时间。使用健康检查的 --quick 选项可避免访问网络。 与典型耗时进行比较，并指出是否在预期范围内。

参考阈值

指标	正常	警告	严重
CPU %	<60%	60-85%	>85%
已用 RAM %	<70%	70-85%	>85%
浏览器 RAM	<3 GB	3-6 GB	>6 GB
浏览器进程	<30	30-60	>60
可用磁盘空间	>15%	10-15%	<10%
网络延迟	<200ms	200-500ms	>500ms

给用户的提示

提供诊断结果时，请附上以下上下文提示：

• 标签页多 = CPU/RAM 占用高：每个浏览器标签页都是一个独立进程。 标签页与进程之间的关系会因浏览器和站点隔离方式而异。
• Claude Code 资源占用较高：Claude Code CLI 和桌面应用是不同的；进程名称和 RSS 无法说明其架构，也不能代表普遍适用的正常范围。 但如果你在使用多个会话时占用超过 6 GB，可以考虑关闭旧会话。
• 切换会话缓慢：通常是由 CPU 占用高或多个进程争用资源导致的。 会话需要加载对话历史记录，如果 CPU 繁忙，加载就会变慢。
• 磁盘空间几乎耗尽：会影响交换空间（虚拟内存）的速度，并可能导致 整体运行缓慢。

依赖项

• Python 3.10+
• psutil，需在隔离环境中显式安装，并审查版本
• 无需 API 密钥

最佳实践

• 提供清晰、具体的项目背景和需求
• 将建议应用到生产代码前，先逐一审查
• 与其他互补技能结合使用，以进行全面分析

常见问题

• 将此技能用于超出其专业领域的任务
• 未结合具体情况理解便直接采纳建议
• 未提供足够的项目背景，导致分析不准确

限制

• 仅在任务明确符合上述范围时使用此技能。
• 不要将输出视为对特定环境验证、测试或专家审查的替代。
• 如果缺少必要的输入、权限、安全边界或成功标准，请暂停并要求澄清。