Token Meter hiển thị gì về lượng token Claude Code và Codex đã dùng
Bạn có thể theo dõi token Claude Code ngay trong MXterm Pro bằng Token Meter (thêm từ 1.0.19). Nó đọc transcript của Claude Code, Codex, Gemini CLI và omp, rồi báo số token trong 5 giờ và 7 ngày gần nhất. Mặc định đó là lượng đã tiêu, không phải phần trăm gói, trừ Codex: file của Codex có sẵn con số này, chỉ mới bằng lượt gần nhất của bạn. Các công tắc opt-in bổ sung giới hạn Claude (1.0.21, chỉ trên macOS), hạn mức Codex và số dư tài khoản (1.0.22).
Xem lượng token Claude Code đã dùng: Token Meter hiện gì
Khi đã có agent được cài hoặc một key tài khoản đã lưu để hiển thị, Token Meter nằm trong nhóm nút bên phải của thanh tiêu đề và ở đó suốt lúc app mở, nên bạn không cần mở panel để tìm nó.
Thanh này chỉ hiện một con số: hạn mức chặt nhất trong mọi nguồn, tô màu theo mức độ gần chạm ngưỡng. Nếu không có nhà cung cấp nào bạn đã cấu hình công bố hạn mức, chip hiện tổng token 5 giờ của Claude Code, hoặc của Codex khi Claude Code chưa được cài. Khi chưa cài agent nào và chỉ có số dư tài khoản, chip hiện số dư USD thấp nhất.
Bấm vào chip để xem tóm tắt. Mỗi nhà cung cấp bạn đã cài có một dòng hai hàng: hàng đầu là tên và mốc reset quan trọng nhất, hàng hai là thanh 5 giờ và thanh hàng tuần nếu đã biết giới hạn, hoặc lượng tiêu và token của hôm nay nếu chưa biết. Nhà cung cấp bạn ghim trong Cài đặt → Token Meter được liệt kê đầu tiên (mặc định là Claude Code, hoặc không ghim nhà nào).
Mở một dòng để xem chi tiết đầy đủ của agent đó. Dòng liệt kê số token đã dùng trong 5 giờ và 7 ngày gần nhất, viết tắt bằng K, M hoặc B, kèm biểu đồ sparkline 24 giờ gần nhất, mỗi giờ một cột. Các ô chi phí hiện chi phí ước tính của hôm nay và 7 ngày gần nhất theo giá API, kèm ngày cập nhật bảng giá gần nhất.
Phần phân tích 7 ngày gồm input mới, output, cache write, cache read và số lượt. Số liệu tự làm mới ở nền khoảng một lần mỗi phút.
Một agent chỉ xuất hiện nếu đã được cài, nghĩa là thư mục transcript của nó tồn tại. Khi không có agent cục bộ và chưa lưu key tài khoản nào, meter không hiện gì thay vì một đồng hồ trống. Đồng hồ chỉ số 0 nghĩa là bạn chưa dùng gì, và điều đó khác với việc không biết.
Bài liên quanĐiều phối nhiều AI agent song song bằng split pane trong terminalToken Meter đọc agent nào từ ổ đĩa
Với số token, Token Meter chỉ có một nguồn: transcript mà mỗi agent lưu trên ổ đĩa của bạn. Claude Code, Codex, Gemini CLI và omp ghi số token của từng lượt vào đó. Meter không gọi API của nhà cung cấp và không bắt bạn đăng nhập. Không có API key để dán, không có tài khoản để kết nối, và với số token thì không có gì được gửi đi đâu cả.
Danh sách có bốn cái tên vì meter đọc thư mục transcript của Claude Code, Codex, Gemini CLI và omp. Nó không đọc OpenCode, nên không hiện gì cho OpenCode thay vì đoán.
1.0.22 thêm nguồn thứ hai, tách riêng và không phải transcript. Dán API key trong Cài đặt → Token Meter cho bất kỳ sáu nhà cung cấp tài khoản nào, mỗi nhà cung cấp có một dòng riêng, hiện thứ mà chính endpoint của nhà đó báo: số dư, hạn mức gói hoặc mức chi tiêu. Đó là một phép đo khác, với những lưu ý khác. Hãy đọc sự khác nhau giữa mức dùng và số dư trước khi coi các con số này là như nhau.
Cache read token là gì, và vì sao có dòng riêng
Phần lớn token trong một phiên agent dài là cache read: ngữ cảnh agent đã gửi trước đó, được cache của nhà cung cấp trả lại ở mỗi lượt mới. Nếu cộng chung với mọi thứ khác, chúng khiến phiên trông lớn hơn nhiều so với thực tế.
Khi có dòng riêng, cache read không che mất phần còn lại, và bạn thấy được phần còn lại của phiên thực sự là bao nhiêu.
Những gì Token Meter không hiện
Mặc định Token Meter báo lượng đã tiêu: số token đã dùng. Nó không dự đoán bạn còn chạy được bao nhiêu nữa. Transcript của Claude Code không ghi gói đăng ký đang ở mức nào, nên phần trăm của Claude cần một nguồn khác. File phiên của Codex có số đo rate-limit của nó, nhưng chỉ mới bằng lượt Codex gần nhất của bạn. Giờ đây có hai công tắc opt-in cung cấp con số trực tiếp cho mỗi bên.
Với Claude, 1.0.21 thêm Giới hạn gói, hoạt động chỉ trên macOS. Bật nó trong Cài đặt → Token Meter. Khi đó app đọc thông tin đăng nhập đã lưu của Claude Code trong Keychain của macOS qua công cụ security của hệ thống, nên macOS không hỏi mỗi lần. Nó lấy mức dùng gói thật của bạn từ api.anthropic.com, tối đa năm phút một lần.
Với Codex, 1.0.22 thêm Hạn mức Codex trực tiếp. Nó đọc thông tin đăng nhập ChatGPT của Codex từ ~/.codex/auth.json và chỉ gửi tới chatgpt.com để lấy khung 5 giờ và khung hàng tuần hiện tại.
Nó chỉ được thiết kế để đọc file đó. Token hết hạn thì không gửi yêu cầu nào và nhắc bạn chạy codex. Thông tin đăng nhập lưu trong keychain hệ thống thì hoàn toàn không được đọc. Cả hai công tắc đều tắt cho đến khi bạn bật.
Codex là bên có sẵn một con số ngay cả khi công tắc đó tắt. CLI của chính nó ghi số đo rate-limit của gói vào file phiên, nên meter đọc chúng từ cùng những dòng nó vốn đã quét. Số đo đó chỉ mới bằng lượt Codex gần nhất của bạn, và đó là lý do công tắc trực tiếp tồn tại.
Số liệu 5 giờ và 7 ngày là các khung nhìn ngược từ thời điểm hiện tại. "Đã dùng trong 5 giờ qua" đúng là ý nghĩa của con số. Nó không nói gì về mức gói của bạn cho phép.
Token Meter dành cho ai
Token Meter sinh ra cho việc chạy Claude Code và Codex song song, trong các split pane hoặc cùng nhau trong Control Room (trước đây là War Room). Nó cho biết agent nào đang ngốn token mà không cần chuyển vào từng CLI để hỏi. Nếu bạn chỉ thỉnh thoảng chạy một agent, Token Meter cho bạn biết thêm được rất ít. Xem thêm trang Token Meter và tài liệu Token Meter.
Terminal đa pane, Command Recipes (Cmd+J), và Control Room (trước đây là War Room) đa agent: miễn phí để bắt đầu.
Đã có MXterm Pro? Đọc hướng dẫn cài đặt →
Chưa dùng MXterm Pro? Xem bảng giá →
Câu hỏi thường gặp
Có từ 1.0.19 và đã được mở rộng dần: 1.0.21 thêm giới hạn gói Claude, 1.0.22 thêm hạn mức Codex trực tiếp và các nhà cung cấp tài khoản. Với số token, không có gì phải bật. Trên macOS, nếu đã cài Claude Code hoặc Codex, meter tự xuất hiện trên thanh tiêu đề; trên Windows thì chưa được xác minh.
Bấm meter trên thanh tiêu đề rồi mở dòng của Claude Code. Dòng đó hiện số token đã dùng trong 5 giờ và 7 ngày gần nhất, kèm biểu đồ sparkline 24 giờ, mỗi giờ một cột. Các ô chi phí hiện chi phí ước tính theo giá API, kèm ngày cập nhật bảng giá gần nhất. Bảng chia 7 ngày gồm input mới, output, cache write, cache read và số lượt. Codex có đủ những thứ này khi đã được cài.
Claude Code, Codex, Gemini CLI và omp, mỗi cái chỉ khi đã được cài. Số token của chúng được đọc từ ổ đĩa: meter quét thư mục transcript và không đọc OpenCode. Ngoài ra, 1.0.22 cho phép thêm sáu nhà cung cấp tài khoản thành các dòng tài khoản bằng cách dán API key. Các dòng đó báo số dư, hạn mức gói hoặc mức chi tiêu, không phải token từ transcript.
Với Claude thì chỉ khi bạn bật. Codex hiện con số này từ file phiên ngay cả khi công tắc tắt. Giới hạn gói (chỉ trên macOS) trong Cài đặt → Token Meter hiện phần trăm thật của gói Claude từ api.anthropic.com, dùng thông tin đăng nhập đã lưu của Claude Code đọc qua công cụ security của hệ thống, nên macOS không hỏi. Hạn mức Codex trực tiếp lấy con số mới của Codex qua chatgpt.com. Cả hai đều tắt mặc định.
Không, với số token. Chúng đến từ các transcript mà Claude Code và Codex vốn đã ghi trên máy bạn, không cần API key hay tài khoản, và transcript vẫn nằm trên máy. Các công tắc opt-in chỉ gửi thông tin đăng nhập hoặc key tới đúng nhà cung cấp được nêu tên. Giới hạn gói Claude liên hệ api.anthropic.com, hạn mức Codex trực tiếp liên hệ chatgpt.com, và key của nhà cung cấp tài khoản chỉ đi tới endpoint riêng của nhà cung cấp đó.
Trong phiên dài, phần lớn token là cache read, và cộng chúng vào mọi thứ khác khiến phiên trông lớn hơn nhiều so với thực tế. Một dòng riêng cho thấy phần còn lại của phiên là bao nhiêu.