🗺️ Công cụ giúp Claude Code giảm 72% token khi đọc codebase lớn
Bạn đang dùng Claude Code hay Cursor mà cảm giác nó "ăn" token như không có ngày mai? Có thể vấn đề không nằm ở prompt của bạn, mà nằm ở cách AI đọc code.
🔍 Vấn đề: AI phải đọc từng file một
Khi bạn hỏi Claude Code về một tính năng trong project lớn, nó phải mở từng file, đọc từng dòng để hiểu cấu trúc. Cứ tưởng tượng bạn vào một thư viện mới và phải đọc từng cuốn sách để tìm quyển mình cần, thay vì dùng mục lục.
Đây là lý do "token bloat" xảy ra. Với codebase lớn, AI phải gọi tool hàng chục lần, đọc hàng chục file, và bạn trả tiền cho mỗi token đó.
🗺️ codegraph là gì?
codegraph là một MCP server chạy hoàn toàn local, có nhiệm vụ pre-index toàn bộ codebase của bạn trước khi AI bắt đầu làm việc. Thay vì để Claude Code tự mò mẫm từng file, bạn đưa cho nó một bản đồ đầy đủ ngay từ đầu.
AI chỉ cần truy vấn codegraph để biết: file nào chứa gì, hàm nào gọi hàm nào, import từ đâu. Không cần đọc file lần lượt nữa.
Dự án này vừa tăng thêm 10,793 stars chỉ trong một tuần trên GitHub Trending, nên chắc chắn có lý do để cộng đồng dev chú ý đến vậy.
📊 Kết quả thực tế
Nhóm dev đã thử nghiệm trực tiếp trên VS Code TypeScript repo, một trong những codebase lớn và phức tạp nhất trong thế giới open source.
Kết quả khá ấn tượng:
- Token giảm từ 1.4M xuống còn 393K, tức là giảm 72%
- Chi phí giảm từ $0.64 xuống $0.42 cho cùng một tác vụ
- Số lần gọi tool giảm tới 94% trong nhiều trường hợp
Bạn không cần làm gì thêm, codegraph tự động sync khi file thay đổi nhờ OS file watchers. Mở editor lên và code như bình thường.
🌐 Hỗ trợ rộng, không cần API key
codegraph hỗ trợ 19+ ngôn ngữ lập trình và 13 framework phổ biến, từ TypeScript, Python, Go, Rust cho đến các framework như React, Django, Laravel.
Điểm đặc biệt là nó 100% chạy local, không gửi code của bạn lên bất kỳ server nào và không cần API key để hoạt động. Với các dev làm việc trên project có code nhạy cảm hoặc private, đây là điều quan trọng.
codegraph tương thích với hầu hết các AI coding agent phổ biến hiện tại: Claude Code, Cursor, Codex, OpenCode, Kiro.
⚙️ Cách dùng
Bạn chỉ cần thêm codegraph vào cấu hình MCP của tool đang dùng. Ví dụ với Claude Code, thêm một entry vào file .mcp.json trong project, trỏ đến server codegraph. Sau đó để nó index lần đầu, mọi thứ còn lại là tự động.
Toàn bộ hướng dẫn cài đặt có trên GitHub tại github.com/colbymchenry/codegraph. Cộng đồng đang active nên nếu gặp vấn đề bạn cũng sẽ tìm được câu trả lời khá nhanh.
Bạn đang dùng AI coding agent với codebase lớn không? Thử codegraph xem token giảm được bao nhiêu và chia sẻ kết quả với mọi người nhé.
