vincequant

Claude Code Monitor

Name: Claude Code Monitor
Author: vincequant

Productivity community

SOURCE https://github.com/vincequant/claude-code-monitor

Description

Real-time monitoring tool for Claude Code CLI usage and network status | 實時監控 Claude Code CLI 使用狀態和網絡連接

Installation

This entry records only its repository, not the path inside it, so there is no exact command to give. Open the source below and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

README

Claude Code Monitor 🚀

![Claude Code](https://img.shields.io/badge/Claude_Code-Monitor-blue?style=for-the-badge&logo=anthropic&logoColor=white) ![Python](https://img.shields.io/badge/Python-3.7+-green?style=for-the-badge&logo=python&logoColor=white) ![License](https://img.shields.io/badge/License-MIT-yellow?style=for-the-badge) ![Platform](https://img.shields.io/badge/Platform-macOS-lightgrey?style=for-the-badge&logo=apple&logoColor=white)

實時監控您的 Claude Code CLI 使用狀態和網絡連接

[English](#english) | [中文](#中文)

🌟 功能特色

🔍 實時監控

網絡狀態檢測: 即時顯示 Claude 服務連接狀態
對話追蹤: 監控當前對話狀態、Token 使用量和費用
智能提醒: 連接狀態變化時自動發送 macOS 桌面通知
自動恢復: 工具失敗時自動更新並恢復監控

📊 數據分析

歷史統計: 查看最近 7 天的使用趨勢
費用計算: 基於實際 Token 使用量精確計算費用
視覺化圖表: 彩色長條圖直觀顯示消費水平
日均分析: 自動計算日均使用量和費用

⚡ 技術優勢

高效能: 3 秒更新間隔，實時響應
準確計費: 採用 --mode calculate 確保費用計算準確性
多重啟動: 支持命令行、腳本和 macOS 應用多種啟動方式
自動環境配置: .command 腳本自動設置 Node.js 環境

📸 預覽

*實時監控介面展示*

🚀 快速開始

系統要求

macOS (用於桌面通知功能)
Python 3.7+
Node.js/npm (用於 ccusage 命令)
Claude Code CLI (已安裝並認證)

安裝步驟

**克隆倉庫**

git clone https://github.com/yourusername/claude-code-monitor.git
cd claude-code-monitor

**安裝依賴**
```
pip3 install -r requirements.txt
```

**確保 Claude Code CLI 已安裝**

# 測試 ccusage 命令
npx ccusage@latest --version

運行方式

方法 1: 直接運行 Python

python3 claude_monitor.py

方法 2: 使用啟動腳本

./start_monitor.sh

方法 3: macOS 雙擊啟動

雙擊 `claude_monitor.command` 文件即可啟動（自動配置環境）

📖 使用指南

監控界面說明

===========================================
         Claude Code 監測器
===========================================

服務狀態:
  Claude 服務: 🟢 正常 (延遲: 45ms)
  連接速度: 156 KB/s
  
當前對話:
  狀態: