Bản đồ code giúp Claude đọc ít, review chính xác hơn

TL;DR

Công cụ này xây dựng bản đồ cấu trúc code bằng Tree-sitter, theo dõi thay đổi từng file, rồi chỉ cho Claude biết cần đọc những file nào thay vì quét cả project. Kết quả: giảm trung bình 6.8x token, với project lớn như Next.js giảm tới 49x.

Nói đơn giản: Code của bạn có 27,000 file nhưng chỉ cần đọc 15 file để review một thay đổi.

Bài này dành cho ai?

1. Dev sử dụng Claude Code daily

Vấn đề: Mỗi lần nhờ Claude làm gì đó, nó quét lại cả project → tốn token, chậm, đôi khi sai context

Khi nào cần: Khi project có trên 100 file, hoặc thường xuyên nhờ Claude review code, fix bug, thêm feature

Được gì: Review chính xác hơn, token giảm 6.8x lần, thời gian nhanh hơn

2. Dev build AI coding tools

Vấn đề: Làm sao để AI hiểu code mà không tốn token? Làm sao biết file nào thay đổi sẽ ảnh hưởng file nào khác?

Khi nào cần: Khi đang build code review tool, AI assistant, hoặc bất kỳ tool nào cần hiểu code structure

Được gì: Graph-based approach đã tested, hỗ trợ 12 ngôn ngữ, có cả semantic search

3. Team lead / QA cần review nhiều PR

Vấn đề: Review từng PR mất thời gian, nhưng để AI review thì token tốn quá nhiều

Khi nào cần: Khi team có nhiều PR mỗi ngày, cần tool hỗ trợ review tự động nhưng vẫn chính xác

Được gì: Blast-radius analysis cho biết chính xác thay đổi ảnh hưởng những gì, giảm 80-90% thời gian đọc code không liên quan

Các điểm chính

1. Claude đọc cả project mỗi lần → tốn token vô ích Mặc định Claude Code parse lại toàn bộ codebase mỗi task. Project lớn như Next.js (27,000 file) tốn 739K tokens cho một lần review. → Làm gì: Cài code-review-graph, gõ “Build the code review graph for this project”, Claude sẽ chỉ đọc 15 file liên quan

2. Blast-radius analysis: Biết chính xác thay đổi ảnh hưởng đâu Khi một file thay đổi, graph truy vết tất cả function gọi nó, class phụ thuộc, và test cover nó. Claude đọc danh sách này thay vì quét ngẫu nhiên. → Làm gì: Dùng lệnh /code-review-graph:review-delta để xem blast radius trước khi review

3. Incremental update: Thay đổi 1 file → update trong 2 giây Mỗi lần save file hoặc git commit, graph tự động diff, tìm dependents qua SHA-256 hash, re-parse chỉ file thay đổi. Project 2,900 file update dưới 2 giây. → Làm gì: Chạy code-review-graph watch để graph luôn up-to-date khi làm việc

4. Hỗ trợ 12 ngôn ngữ phổ biến Python, TypeScript, JavaScript, Go, Rust, Java, C#, Ruby, Kotlin, Swift, PHP, C/C++. Mỗi ngôn ngữ có Tree-sitter grammar đầy đủ cho function, class, import, call sites, inheritance, test detection. → Làm gì: Không cần cấu hình gì thêm, cài là chạy được với ngôn ngữ bạn đang xài

5. Benchmark: 6.8x token reduction, review quality tăng Test trên httpx, FastAPI, Next.js. Standard approach: 13,205 tokens. Với graph: 1,928 tokens. Review quality score: 8.8/10 vs 7.2/10. → Làm gì: Đây là số liệu thật từ production repos, có thể yên tâm áp dụng

Quick Start

Cài đặt qua Claude Code plugin (khuyên dùng):

claude plugin marketplace add tirth8205/code-review-graph
claude plugin install code-review-graph@code-review-graph

Hoặc qua pip:

pip install code-review-graph
code-review-graph install

Restart Claude Code sau khi cài xong. Cần Python 3.10+ và uv.

Sau đó mở project và gõ:

Build the code review graph for this project

Lần đầu build mất ~10 giây cho project 500 file. Sau đó graph tự cập nhật mỗi khi edit hoặc commit.