Tiết kiệm

PRECC theo dõi token tiết kiệm ước tính từ mỗi lần chặn. Dùng precc savings để xem PRECC đã ngăn được bao nhiêu lãng phí.

Tóm tắt nhanh

$ precc savings
Session Token Savings
=====================
Total estimated savings: <span data-stat="session_tokens_saved">8,741</span> tokens

Breakdown:
  Pillar 1 (cd prepends):         <span data-stat="session_p1_tokens">3,204</span> tokens  (<span data-stat="session_p1_count">6</span> corrections)
  Pillar 4 (skill activations):   <span data-stat="session_p4_tokens">1,560</span> tokens  (<span data-stat="session_p4_count">4</span> activations)
  RTK rewrites:                   <span data-stat="session_rtk_tokens">2,749</span> tokens  (<span data-stat="session_rtk_count">11</span> rewrites)
  Lean-ctx wraps:                 <span data-stat="session_lean_tokens">1,228</span> tokens  (<span data-stat="session_lean_count">2</span> wraps)

Phân tích chi tiết (Pro)

$ precc savings --all
Session Token Savings (Detailed)
================================
Total estimated savings: <span data-stat="session_tokens_saved">8,741</span> tokens

Command-by-command:
  #  Time   Command                          Saving   Source
  1  09:12  cargo build                      534 tk   cd prepend (cargo-wrong-dir)
  2  09:14  cargo test                       534 tk   cd prepend (cargo-wrong-dir)
  3  09:15  git status                       412 tk   cd prepend (git-wrong-dir)
  4  09:18  npm install                      824 tk   cd prepend (npm-wrong-dir)
  5  09:22  find . -name "*.rs"              387 tk   RTK rewrite (output truncation)
  6  09:25  cat src/main.rs                  249 tk   RTK rewrite (lean-ctx wrap)
  7  09:31  cargo clippy                     534 tk   cd prepend (cargo-wrong-dir)
  ...

Pillar Breakdown:
  Pillar 1 (context resolution):   <span data-stat="session_p1_tokens">3,204</span> tokens  <span data-stat="session_p1_pct">36.6</span>%
  Pillar 2 (GDB debugging):            0 tokens   0.0%
  Pillar 3 (mined preventions):        0 tokens   0.0%
  Pillar 4 (automation skills):    <span data-stat="session_p4_tokens">1,560</span> tokens  <span data-stat="session_p4_pct">17.8</span>%
  RTK rewrites:                    <span data-stat="session_rtk_tokens">2,749</span> tokens  <span data-stat="session_rtk_pct">31.5</span>%
  Lean-ctx wraps:                  <span data-stat="session_lean_tokens">1,228</span> tokens  <span data-stat="session_lean_pct">14.1</span>%

Cách ước tính tiết kiệm

Mỗi loại sửa lỗi có chi phí token ước tính dựa trên những gì sẽ xảy ra nếu không có PRECC:

Đây là ước tính thận trọng. Tiết kiệm thực tế thường cao hơn vì suy luận của Claude về lỗi có thể rất dài dòng.

Tiết kiệm tích lũy

Tiết kiệm được lưu giữ qua các phiên trong cơ sở dữ liệu PRECC. Theo thời gian, bạn có thể theo dõi tổng tác động:

$ precc savings
Session Token Savings
=====================
Total estimated savings: <span data-stat="session_tokens_saved">8,741</span> tokens

Lifetime savings: <span data-stat="total_tokens_saved">142,389</span> tokens across <span data-stat="total_sessions">47</span> sessions

Thanh trạng thái

Sau khi cài đặt, PRECC thêm một mục statusLine vào ~/.claude/settings.json để thanh trạng thái Claude Code hiển thị các chỉ số phiên trực tiếp:

$0.42 spent | 1.2M in/out | 📊 last cmd: −1.2K | PRECC: 7 fixes | 5.8ms avg | this session: 320 saved over 7 cmds (~$0.05) | lifetime: 8.9K saved over 217 cmds (~$2.85)

Đặt PRECC_LANG để hiển thị nhãn bằng ngôn ngữ của bạn — xem chương Bản địa hóa.

Mỗi đoạn:

Đoạn lifetime: được đặt cuối cùng để nó là đoạn đầu tiên bị cắt nếu giao diện Claude Code cắt thanh ở mép phải.

Vì sao chi phí và số token không chia được cho nhau

1.2M in/out được hiển thị không phải là mẫu số tạo ra $0.42 spent. cost.total_cost_usd của Claude Code được tính từ phân tích đầy đủ token của API — đầu vào cơ bản, đầu ra, cộng với đọc cache và tạo cache. Số lượng token cache tích lũy toàn phiên không được hiển thị trong schema statusline, vì vậy PRECC chỉ có thể hiển thị phần nhìn thấy (không phải cache).

Trong các phiên dài có nhiều lần đọc lại tệp, đọc cache có thể bằng 10× số token nhìn thấy. Đó là lý do ghép cặp chúng thành tỷ lệ sẽ gây hiểu lầm — thay vào đó, PRECC hiển thị chúng dưới dạng các đoạn độc lập.

Vì sao PRECC không tính chi phí

Số tiền chi phí là quyền uy. PRECC đọc nguyên văn cost.total_cost_usd từ JSON mà Claude Code đẩy vào lệnh trạng thái qua stdin. Đó cũng chính là số mà Claude Code tính vào ngân sách đăng ký/sử dụng của bạn. Bạn có thể xác minh bất cứ lúc nào bằng lệnh slash tích hợp /cost — cả hai nên khớp nhau.

Điều gì thúc đẩy chi phí

Đối với Claude Opus 4.6:

Những yếu tố thúc đẩy lớn nhất trong các phiên dài thường là token đầu ra (loại đắt nhất trên mỗi token, đặc biệt ở cấp ngữ cảnh 1M), đọc cache lặp lại (rẻ riêng lẻ nhưng tích lũy nhanh qua nhiều lượt) và tạo cache (ghi một lần cho mỗi lần đọc tệp với tỷ lệ ~1.25× tốc độ đầu vào cơ bản). PRECC giảm chi phí token nhìn thấy bằng cách nén đầu ra Bash (đoạn 📊 last cmd: hiển thị khoản tiết kiệm theo từng lệnh), nhưng không thể giảm đọc cache của các tệp mà Claude đã tải.

Số đếm phiên ổn định

Đoạn “PRECC: N fixes” đếm các sự kiện kể từ thời điểm bắt đầu phiên được lưu trữ, ghi vào ~/.local/share/precc/sessions/<session_id>.start ở lần làm mới statusline đầu tiên của mỗi phiên. Điều này khiến số đếm đơn điệu — nó không thể giảm giữa phiên ngay cả khi cost.total_duration_ms thiếu trong một lần làm mới cụ thể.

Ảnh chụp toàn thời gian tự động làm mới

Đoạn lifetime: đọc ~/.local/share/precc/.lifetime_summary.json, được ghi lại sau mỗi phép đo PostToolUse và sau mỗi lần gọi precc savings. Đoạn this session: đọc cùng tệp lifetime nhưng trừ đi đường cơ sở từng phiên được lưu khi làm mới đầu tiên của mỗi phiên. Không cần làm mới thủ công — các tệp tự cập nhật.

Tắt thanh trạng thái

Nếu bạn muốn giữ thanh trạng thái hiện có, hãy đặt lệnh statusLine của riêng bạn trong ~/.claude/settings.json. Trình cài đặt PRECC sẽ phát hiện giá trị tùy chỉnh và để nguyên nó trong các bản cập nhật tiếp theo.

Để chỉ tắt dòng 📊 PRECC trên mỗi tương tác (trong additionalContext), đặt PRECC_QUIET=1 trong môi trường shell của bạn.

Related research

PRECC’s three savings mechanisms each have a counterpart in the recent literature. These are related work — the ideas PRECC’s design draws on. Their reported figures are their measurements, not PRECC’s: PRECC only ever quotes numbers measured on your own machine (see “measured, not estimated”, above).

• Output/trajectory trimming (PRECC’s diet + bash-output compression) — Reducing Cost of LLM Agents with Trajectory Reduction (AgentDiet), FSE 2026, arXiv:2509.23586. Removes redundant/expired trajectory content post-hoc; reports −39.9–59.7% input tokens. PRECC applies the same idea pre-execution and deterministically (no extra LLM call).
• Skills as programs (PRECC’s mined + builtin rewrite skills) — Harnessing LLM Agents with Skill Programs, arXiv:2605.17734. Frames reusable agent skills as executable program functions — the same analogy behind PRECC’s command-rewrite skills (a pattern → a deterministic rewrite).
• Context compression (PRECC’s compress + lean-ctx wrapping) — Compress the Context, Keep the Commitments: A Formal Framework for Verifiable LLM Context Compression, arXiv:2605.17304. Recent work on compressing context without losing required information — the property PRECC’s deterministic, cache-stable rewrites aim to preserve.