Tokendoctor: cắt chi phí Claude Code tới 38%

Công nghệ17 tháng 11, 2026·5 phút đọc

Plugin mã nguồn mở Tokendoctor đo chi phí thực tế của Claude Code, phát hiện cấu hình gây tốn token và áp dụng các bản sửa có thể hoàn tác. Tác giả đo được mức tiết kiệm tới 38% khi dùng cửa sổ ngữ cảnh 400K và chuyển tác vụ phụ sang Sonnet.

Tokendoctor: cắt chi phí Claude Code tới 38%

Tokendoctor: cùng Claude Code, chi phí giảm tới 38%

Ảnh minh họa TokendoctorẢnh minh họa Tokendoctor

Một plugin mã nguồn mở vừa công bố cách đo và cắt chi phí dùng Claude Code mà không phải đổi công cụ. Tokendoctor chạy ngay trên máy người dùng, đọc các phiên làm việc thật rồi chỉ ra chỗ nào đang đốt token.

Con số 38% không phải cam kết chung. Tác giả đo trên sáu tuần sử dụng thật, so tháng trước với tuần sau khi đặt cửa sổ 400K và cho các tác vụ phụ dùng Sonnet.

Đo trước, sửa sau

Tokendoctor không bán một "viên thuốc chữa bách bệnh". Theo tài liệu của dự án, nếu các phiên của bạn hiếm khi vượt 400K token thì đổi cửa sổ chẳng giúp gì. Một bản tóm tắt rơi đúng lúc bạn sắp xong việc có khi còn tốn hơn là tiết kiệm.

Vì vậy bước đầu tiên là đo. Lệnh /tokendoctor:sessions phát lại chính các phiên của bạn ở cửa sổ nhỏ hơn, báo mức tiết kiệm tiềm năng cho từng cửa sổ, rồi chỉ ra token đã đi đâu trong 30 ngày gần nhất. Lệnh này chỉ đọc, không thay đổi gì.

Kết quả đo của tác giả:

  • Chi phí mỗi yêu cầu ở luồng chính giảm 38%, ngữ cảnh mỗi yêu cầu từ 412K xuống 219K.
  • Chỉ riêng việc hạ cửa sổ xuống 400K: luồng chính giảm 33%, tổng chi phí giảm 20%.
  • Cơ chế "slide" so với tóm tắt trong cùng một ngày làm việc: rẻ hơn 19%, nhanh hơn 33%.
  • Một tuần làm việc 27 bước trên bộ đo nội bộ: giảm 11 đến 21% chi phí, mọi bài kiểm tra đều qua.

Ba cách sửa chính

Thu hẹp cửa sổ. Lệnh /tokendoctor:optimize chạy 38 kiểm tra dựa trên tài liệu chính thức của Claude Code và áp dụng những thay đổi bạn chọn. Mỗi thay đổi hiện dưới dạng bản so sánh (diff) trước khi ghi.

Slide thay vì tóm tắt. Lệnh /tokendoctor slide on đổi cách xử lý khi ngữ cảnh đầy: thay vì tóm tắt, plugin thay các kết quả công cụ cũ bằng con trỏ ngắn. Toàn bộ câu hỏi, câu trả lời và quyết định giữ nguyên từng chữ, không có khoảng dừng chờ tóm tắt.

Thứ tự bị thay: các lần đọc đã lỗi thời do lần đọc hoặc sửa sau đó cùng file, rồi nội dung mà các lần sửa đã ghi ra đĩa (vì vẫn còn trên đĩa), sau cùng là các kết quả cũ nhất. Phần đuôi gần nhất và kết quả của tác nhân phụ được giữ lại.

Trong một phiên thật cùng kích thước, bản tóm tắt của Claude Code đưa 367K xuống 35K trong 65,3 giây. Slide đưa 368K xuống 36K trong 0,04 giây. Trung bình các bản tóm tắt trong phiên thật của tác giả mất 79 giây.

Hoàn tác mọi thứ. Lệnh /tokendoctor undo liệt kê từng thay đổi plugin đã làm và trả lại bất kỳ thay đổi nào. Không gọi mô hình, không tốn token.

Bảng điều khiển cục bộ của TokendoctorBảng điều khiển cục bộ của Tokendoctor

Bảng điều khiển và chi phí thường trực

Lệnh /tokendoctor:dashboard dựng một file HTML cục bộ, không gọi mạng. Nó thống kê token theo ngày, loại token, mô hình, mức suy luận, luồng chính và từng loại tác nhân phụ, kích thước ngữ cảnh, dự án và giờ.

Chi phí khi cài đặt được tác giả nêu rõ: khoảng 235 token luôn trực chiến cho năm kỹ năng (skill), theo ước tính của claude plugin details. Plugin không có máy chủ MCP. Các công cụ tối ưu nằm sau ToolSearch nên chỉ tên của chúng được liệt kê cho đến khi bạn gọi. Một hook chạy nền khi phiên bắt đầu, không in gì nên không tốn token.

Giới hạn cần biết

Chi phí hiển thị là đô-la theo giá niêm yết trên API của từng mô hình. Với gói Pro hoặc Max, đó là mức giá tương đương nếu chạy trên API, vì Anthropic không công bố cách quy đổi hạn mức gói.

Các phiên trên máy khác và bản ghi đã bị Claude Code dọn dẹp không được tính. Một số yêu cầu Claude Code tính tiền nhưng không ghi vào bản ghi, như yêu cầu tóm tắt, tiêu đề, mô hình nhỏ đọc trang web; các khoản này được ước lượng.

Tài liệu cũng nói thẳng: chưa có bài kiểm tra nào cho thấy slide trả lời tốt hơn hay kém hơn. Nó tiết kiệm thời gian và tiền, không cải thiện chất lượng.

Cách cài

claude plugin marketplace add localixai/tokendoctor
claude plugin install tokendoctor@tokendoctor

Cập nhật bằng claude plugin marketplace update tokendoctor và claude plugin update tokendoctor@tokendoctor, rồi khởi động lại Claude Code. Muốn thử mà không cài, nhân bản kho mã và chạy claude --plugin-dir /path/to/tokendoctor.

Dự án dùng giấy phép MIT và có bộ kiểm thử chạy bằng trình chạy thử tích hợp của Node, không cần thư viện phụ thuộc.

Góc nhìn

Với nhóm phát triển ở Việt Nam đang trả tiền theo API, một plugin đo chi phí theo phiên thật là công cụ đáng thử trước khi vội đổi cách làm việc. Bước đo chỉ đọc nên không rủi ro; chỉ khi thấy số liệu cụ thể mới nên áp dụng thay đổi.

Slide đáng cân nhắc khi làm việc dài và hay chạm ngưỡng ngữ cảnh. Nhưng các bài đo cho thấy lợi ích phụ thuộc vào mô hình và khối lượng công việc, có trường hợp chi phí còn tăng nhẹ. Hãy để dữ liệu trên máy mình quyết định.

Nguồn: github.com · Quy trình biên tập

Chia sẻ:FacebookX