Theo Dõi Sử Dụng Code Claude Theo Thời Gian Thực với Công Cụ Open Source Này

Trong kỷ nguyên "Vibe Coding", các trợ lý lập trình được hỗ trợ bởi AI đã trở thành nền tảng của quy trình phát triển hiện đại. Claude Code của Anthropic nổi bật như một đồng minh đặc biệt mạnh mẽ, có khả năng hiểu các cơ sở mã khổng lồ và tăng tốc các tác vụ lập trình phức tạp. Tuy nhiên, với tất cả sức mạnh của mình, các nhà phát triển thường phải đối mặt với một điểm nghẽn phổ biến và gây khó chịu: bản chất không rõ ràng và không khoan nhượng của giới hạn sử dụng token. Một phiên lập trình chuyên sâu có thể bị dừng lại đột ngột bởi thông báo "phiên đã kết thúc", khiến các nhà phát triển không nắm rõ về mức tiêu thụ của họ.

Giải quyết trực tiếp điểm khó khăn quan trọng này là Claude Code Usage Monitor, một công cụ dòng lệnh mã nguồn mở, được thiết kế đẹp mắt, do nhà phát triển Maciek-roboblog tạo ra. Đây không chỉ đơn thuần là một bộ đếm; đó là một trung tâm điều khiển toàn diện cho các tương tác AI Claude của bạn. Nó cung cấp tính năng theo dõi thời gian thực, thanh tiến trình trực quan, tính toán tốc độ tiêu thụ thông minh và dự đoán thông minh để biến việc quản lý token của bạn từ một trò chơi đoán mò phản ứng thành một lợi thế chủ động, chiến lược. Bài viết này cung cấp hướng dẫn đầy đủ về cách cài đặt, sử dụng và làm chủ tiện ích thiết yếu này.

Tại sao bạn cần Claude Code Usage Monitor

Để hiểu giá trị của công cụ giám sát, trước tiên người ta phải hiểu thách thức mà nó giải quyết. Việc sử dụng Claude Code được quản lý bởi một hệ thống cửa sổ phiên lăn 5 giờ. Một phiên, với giới hạn token tương ứng, bắt đầu bằng tin nhắn đầu tiên của bạn gửi cho Claude và hết hạn chính xác sau năm giờ. Quan trọng là, một nhà phát triển có thể có nhiều phiên hoạt động chồng chéo đồng thời. Nếu bạn bắt đầu một cuộc trò chuyện mới lúc 10:30 sáng, Phiên A bắt đầu. Nếu bạn bắt đầu một cuộc trò chuyện khác lúc 12:15 chiều, Phiên B chạy song song với Phiên A.

Hệ thống này, mặc dù linh hoạt, nhưng khiến việc theo dõi thủ công là gần như không thể. Bạn đang tiến gần đến giới hạn của phiên nào? Tốc độ tiêu thụ token kết hợp của bạn là bao nhiêu? Nếu không có một công cụ chuyên dụng, các nhà phát triển đang làm việc mù mờ, không thể lập kế hoạch công việc hiệu quả và luôn có nguy cơ bị ngắt kết nối giữa chừng, làm gián đoạn sự tập trung và làm giảm năng suất.

Cách cài đặt và thiết lập Claude Code Usage Monitor

💡

Bạn muốn một công cụ kiểm thử API tuyệt vời có thể tạo tài liệu API đẹp mắt?

Bạn muốn một nền tảng tích hợp, tất cả trong một cho đội ngũ phát triển của mình để làm việc cùng nhau với năng suất tối đa?

Apidog đáp ứng mọi yêu cầu của bạn và thay thế Postman với mức giá phải chăng hơn nhiều!

button

Claude Code Usage Monitor được thiết kế để dễ dàng áp dụng, cung cấp cả cách bắt đầu nhanh để thử nghiệm và một thiết lập mạnh mẽ, sẵn sàng cho môi trường làm việc thực tế, rất khuyến khích sử dụng hàng ngày.

Điều kiện tiên quyết

Trước khi bắt đầu, hãy đảm bảo hệ thống của bạn đã cài đặt những thứ sau:

Python 3.6+
Node.js (để cài đặt công cụ CLI cơ bản ccusage)

Bắt đầu nhanh (Chỉ để thử nghiệm)

Để đánh giá nhanh, bạn có thể sử dụng các lệnh sau:Bash

# Install dependencies
npm install -g ccusage
pip install pytz

# Clone and run
git clone https://github.com/Maciek-roboblog/Claude-Code-Usage-Monitor.git
cd Claude-Code-Usage-Monitor
python ccusage_monitor.py

Mặc dù đơn giản, phương pháp này cài đặt các gói trên toàn hệ thống và không lý tưởng cho sự ổn định lâu dài hoặc cách ly dự án.

Thiết lập cho môi trường làm việc thực tế (Khuyến nghị)

Để có một thiết lập gọn gàng, ổn định và chuyên nghiệp, việc sử dụng môi trường ảo Python là điều bắt buộc. Nó cách ly các phụ thuộc của dự án, ngăn chặn xung đột với cài đặt Python của hệ thống bạn và giúp dự án dễ dàng di chuyển và tái tạo.

Hướng dẫn từng bước:

Cài đặt ccusage trên toàn hệ thống: Phụ thuộc cốt lõi này lấy dữ liệu sử dụng từ Claude.Bash

npm install -g ccusage

Sao chép kho lưu trữ:Bash

git clone https://github.com/Maciek-roboblog/Claude-Code-Usage-Monitor.git
cd Claude-Code-Usage-Monitor

Tạo môi trường ảo:Bash

# Thao tác này tạo một thư mục 'venv' trong thư mục dự án của bạn
python3 -m venv venv

Kích hoạt môi trường ảo: Bạn phải thực hiện thao tác này mỗi khi bắt đầu một phiên terminal mới để làm việc với dự án.Bash

# Trên Linux/macOS:
source venv/bin/activate

# Trên Windows:
venv\Scripts\activate

Dấu nhắc lệnh của bạn bây giờ sẽ có tiền tố là (venv), cho biết môi trường đang hoạt động.

Cài đặt các phụ thuộc Python: Khi môi trường ảo đã được kích hoạt, cài đặt các gói cần thiết.Bash

pip install pytz

Làm cho script có thể thực thi được (Tùy chọn, cho Linux/macOS):Bash

chmod +x ccusage_monitor.py

Chạy công cụ giám sát:Bash

# Trên Linux/macOS (nếu đã làm cho nó có thể thực thi được):
./ccusage_monitor.py

# Trên tất cả các hệ thống:
python ccusage_monitor.py

Sử dụng hàng ngày và Mẹo chuyên nghiệp

Sau khi thiết lập xong, quy trình làm việc hàng ngày của bạn trở nên đơn giản:Bash

cd Claude-Code-Usage-Monitor
source venv/bin/activate
./ccusage_monitor.py
# Khi xong, chỉ cần gõ:
deactivate

Để đạt hiệu quả tối đa, hãy tạo một bí danh shell. Thêm dòng sau vào tệp ~/.bashrc hoặc ~/.zshrc của bạn:Bash

alias claude-monitor='cd ~/path/to/Claude-Code-Usage-Monitor && source venv/bin/activate && ./ccusage_monitor.py'

Bây giờ, bạn có thể khởi chạy công cụ giám sát từ bất kỳ đâu bằng cách chỉ cần gõ claude-monitor trong terminal của mình.

Làm chủ công cụ giám sát: Sử dụng và cấu hình

Chạy công cụ giám sát đơn giản như việc thực thi script, nhưng sức mạnh thực sự của nó được mở khóa thông qua các tùy chọn dòng lệnh.

Cách sử dụng cơ bản:

Để chạy với cài đặt mặc định (gói Pro, ~7.000 token) và thoát một cách nhẹ nhàng, nhấn Ctrl+C.

Tùy chọn cấu hình:

Chỉ định gói của bạn: Điều chỉnh công cụ giám sát theo cấp độ đăng ký của bạn để có giới hạn chính xác.Bash

# Gói Pro (~7.000 token) - Mặc định
./ccusage_monitor.py --plan pro

# Gói Max5 (~35.000 token)
./ccusage_monitor.py --plan max5

# Gói Max20 (~140.000 token)
./ccusage_monitor.py --plan max20

# Tự động phát hiện từ phiên cao nhất trước đó của bạn
./ccusage_monitor.py --plan custom_max

Tùy chỉnh thời gian đặt lại và múi giờ: Công cụ giám sát mặc định là Europe/Warsaw. Căn chỉnh nó với ngày làm việc địa phương của bạn để lập kế hoạch trực quan hơn.Bash

# Đặt thời gian đặt lại thành 9 giờ sáng theo giờ miền Đông Hoa Kỳ
./ccusage_monitor.py --reset-hour 9 --timezone US/Eastern

# Sử dụng UTC cho việc cộng tác nhóm quốc tế
./ccusage_monitor.py --timezone UTC

Gói	Giới hạn Token	Tốt nhất cho
pro	~7.000	Sử dụng nhẹ, thử nghiệm (mặc định)
max5	~35.000	Phát triển thông thường
max20	~140.000	Sử dụng nhiều, dự án lớn
custom_max	Tự động phát hiện	Người dùng có giới hạn thay đổi/không rõ

Bên dưới lớp vỏ: Các tính năng thông minh và cách chúng hoạt động

Sự tinh tế của công cụ giám sát nằm ở các tính năng backend phức tạp của nó, cung cấp thông tin chi tiết rõ ràng, có thể hành động.

Giám sát thời gian thực: Công cụ làm mới sau mỗi 3 giây với màn hình mượt mà, không nhấp nháy, cho bạn cái nhìn trực tiếp về mức tiêu thụ token của mình.
Thanh tiến trình trực quan: Các thanh được mã hóa màu cho tiến trình token và thời gian cung cấp sự hiểu biết ngay lập tức, trực quan về trạng thái của bạn. Màu xanh lá cây nghĩa là bạn an toàn, màu vàng là cảnh báo và màu đỏ cho biết bạn sắp hết giới hạn.
Dự đoán thông minh: Công cụ giám sát không chỉ hiển thị mức sử dụng hiện tại; nó phân tích mức tiêu thụ token của bạn trong giờ qua để tính toán "tốc độ tiêu thụ". Dựa trên tốc độ này, nó dự đoán liệu bạn có hết token trước khi phiên được đặt lại hay không và hiển thị cảnh báo.
Chuyển đổi gói thông minh: Nếu bạn chạy công cụ giám sát trên gói pro mặc định nhưng mức sử dụng của bạn vượt quá giới hạn ~7.000 token, công cụ đủ thông minh để nhận ra. Nó sẽ tự động chuyển sang chế độ custom_max, quét lịch sử của bạn để tìm giới hạn cao hơn thực tế của bạn và tiếp tục giám sát một cách liền mạch, thông báo cho bạn về sự thay đổi.

Quy trình làm việc thực tế và Các phương pháp hay nhất

Tích hợp công cụ giám sát vào thói quen phát triển của bạn để tối đa hóa lợi ích của nó.

Các tình huống phổ biến:

Nhà phát triển buổi sáng: Bắt đầu ngày mới bằng cách căn chỉnh công cụ giám sát với lịch làm việc của bạn. Bash

# Căn chỉnh việc đặt lại với thời gian bắt đầu lúc 9 giờ sáng ở New York
./ccusage_monitor.py --plan max5 --reset-hour 9 --timezone America/New_York

Người dùng nặng với giới hạn thay đổi: Nếu bạn không chắc chắn về giới hạn token chính xác của mình, hãy để công cụ giám sát tìm ra cho bạn. Bash

# Tự động phát hiện mức sử dụng cao nhất trước đó của bạn
./ccusage_monitor.py --plan custom_max

Người tích hợp quy trình làm việc: Chạy công cụ giám sát trong một cửa sổ tmux hoặc screen chuyên dụng để giám sát liên tục mà bạn có thể đính kèm vào bất cứ lúc nào. Bash

tmux new-session -d -s claude-monitor './ccusage_monitor.py --plan max20'
# Kiểm tra trạng thái sau
tmux attach -t claude-monitor

Các phương pháp hay nhất:

Bắt đầu sớm: Khởi chạy công cụ giám sát khi bắt đầu phiên lập trình của bạn để có theo dõi và dự đoán chính xác nhất.
Sử dụng môi trường ảo: Đây là phương pháp hay nhất số 1 để có trải nghiệm ổn định, không xung đột.
Giám sát tốc độ tiêu thụ của bạn: Nếu bạn thấy tốc độ tăng đột biến, hãy cân nhắc các tác vụ ít tốn token hơn khi bạn tiến gần đến giới hạn của mình. Lập kế hoạch cho các tác vụ tái cấu trúc lớn hoặc tạo mã khi bạn có một phiên mới.
Đặt múi giờ của bạn: Luôn sử dụng cờ --timezone để có dự đoán thời gian đặt lại chính xác, căn chỉnh với thời gian làm việc của bạn.

Khắc phục sự cố

Nếu bạn gặp lỗi No active session found, đây là các bước để giải quyết nó:

Khởi tạo một phiên: Truy cập giao diện web của Claude và gửi ít nhất hai tin nhắn. Thao tác này đảm bảo một phiên được khởi tạo và ghi lại đúng cách.
Chỉ định đường dẫn cấu hình (Nếu cần): Trong những trường hợp hiếm gặp, đường dẫn đến cấu hình của Claude có thể không chuẩn. Bạn có thể chỉ định thủ công: Bash

CLAUDE_CONFIG_DIR=~/.config/claude ./ccusage_monitor.py

Kết luận: Nắm quyền kiểm soát quy trình làm việc AI của bạn

Claude Code Usage Monitor là một ví dụ mạnh mẽ về cách các công cụ mã nguồn mở, được cộng đồng thúc đẩy có thể giải quyết các vấn đề thực tế mà các nhà phát triển gặp phải hàng ngày. Nó nâng người dùng từ một nạn nhân thụ động của các giới hạn không rõ ràng trở thành một chỉ huy có quyền kiểm soát quy trình làm việc của riêng họ. Bằng cách cung cấp sự rõ ràng, khả năng dự đoán và kiểm soát, công cụ này cho phép bạn khai thác toàn bộ sức mạnh của Claude Code mà không lo sợ bị gián đoạn liên tục. Đây là một tiện ích thiết yếu cho bất kỳ nhà phát triển nghiêm túc nào muốn tích hợp AI một cách liền mạch và hiệu quả vào công việc của mình.

💡

button