Hướng Dẫn Tối Ưu Hóa & Nâng Cao Hiệu Quả Sử Dụng Claude Code

Tài liệu này tổng hợp các công cụ, cấu hình và phương pháp giúp tối ưu hóa chi phí token và nâng cao hiệu suất lập trình khi làm việc với Claude Code.

---

Mục lục

1. Tiết kiệm Tokens
2. Tăng Hiệu Suất Coding
3. Các Plugin & MCP Khuyên Dùng
4. Các Skills Nên Cài
5. Phương Pháp Sử Dụng Claude Code Hiệu Quả

---

1. Tiết kiệm Tokens

rtk (Rust Token Killer)

• Lợi ích: Tiết kiệm từ 60% đến 90% lượng token tiêu thụ đối với kết quả đầu ra của các lệnh terminal (stdout/stderr).
• Cách hoạt động: RTK hoạt động như một CLI proxy trung gian. Khi Claude Code thực thi lệnh (ví dụ: git status, npm test), hook của RTK sẽ chặn lệnh đó lại, thực hiện nén và lọc bỏ các thông tin dư thừa (khoảng trắng, chú thích, thanh tiến trình, log chạy thành công) trước khi gửi kết quả sạch về cho mô hình ngôn ngữ.

caveman (Tùy chọn - Có thể ảnh hưởng đến chất lượng đầu ra)

• Lợi ích: Giảm lượng token của câu trả lời từ AI khoảng 60% - 75%.
• Cách hoạt động: Đây là một skill ép Claude Code giao tiếp bằng cấu trúc ngữ pháp cực kỳ tối giản (tương tự như cách nói chuyện của người tiền sử). Phương pháp này lược bỏ hoàn toàn các câu từ xã giao hoặc giải thích dài dòng không cần thiết để tập trung tối đa vào mã nguồn và kết quả kiểm thử.

---

2. Tăng Hiệu Suất Coding

Superpowers

• Lợi ích: Thiết lập và ép buộc AI Agent tuân thủ quy trình phát triển phần mềm chuẩn chỉnh, giảm thiểu lỗi và các thay đổi thiếu kiểm soát.
• Cách hoạt động: Hoạt động như một lớp quy trình (process layer) định hướng AI thực hiện theo các bước có kỷ luật: Tìm hiểu yêu cầu -> Lên kế hoạch thực hiện -> Tạo nhánh/worktree độc lập -> Viết kiểm thử trước (TDD) -> Viết mã nguồn -> Xác minh trước khi hoàn tất.

Andrej Karpathy Skills

• Lợi ích: Ngăn chặn AI tự ý chỉnh sửa lan man ngoài phạm vi yêu cầu, hạn chế mã nguồn bị phức tạp hóa và tiết kiệm token nhờ tránh các chu kỳ sửa lỗi lặp đi lặp lại.
• Cách hoạt động: Ép Claude Code tuân thủ 4 nguyên tắc cốt lõi:
  1. Suy nghĩ trước khi làm: Phát biểu rõ ràng giả định và hỏi lại khi có điểm chưa rõ.
  2. Tối giản tối đa: Chỉ viết lượng mã nguồn tối thiểu vừa đủ để giải quyết vấn đề.
  3. Chỉnh sửa chính xác: Không tự ý refactor hoặc định dạng lại các vùng code xung quanh.
  4. Tập trung vào mục tiêu: Định nghĩa tiêu chí thành công và kiểm thử liên tục cho đến khi đạt được mục tiêu.

---

3. Các Plugin & MCP Khuyên Dùng

AgentHub — dashboard nội bộ theo dõi & điều khiển agent

• Lợi ích: Thấy được agent đang làm gì theo thời gian thực — session, tool call, token, chi phí, cây subagent, transcript — thay vì đoán qua terminal. Chạy nhiều lane song song và biết lane nào đang ở bước nào.
• Cách hoạt động: Hook của Claude Code POST mọi tool call lên server Express + SQLite chạy local, UI React cập nhật qua WebSocket. Toàn bộ dữ liệu nằm trên máy bạn.
• Chức năng chính:
  • Lane — mỗi thư mục làm việc là một lane, sống sót qua restart, đi qua pipeline stage và hiển thị tiến độ (stage khai báo bằng agenthub stage, còn stage suy luận từ tool stream chỉ hiện màu amber, không bao giờ là "done").
  • Chạy Claude Code / Codex ngay trong trình duyệt — terminal thật (tmux + PTY, xterm.js), tương tác đầy đủ, resume được, attach lại được từ terminal máy.
  • Analytics & chi phí theo model, alert + webhook, import lịch sử session (kể cả từ máy khác qua SSH).
  • Trình xem cấu hình Claude Code + Codex — plugin, skill, subagent, slash command, MCP, hook, memory… xem hết, sửa được các file dạng text.
  • CLI agenthub cho toàn bộ bề mặt trên, cộng ship pipeline (/agenthub:ship-full, /agenthub:ship-quick).

Cài đặt — không cần clone. Đã đăng ký marketplace sg ở mục 4 rồi thì chỉ một lệnh:

claude plugin install agenthub@sg

Chưa dùng marketplace sg thì cài từ marketplace riêng của AgentHub:

/plugin marketplace add https://git.smartgift.io.vn/Smartgift-AI/AgentHub.git
/plugin install agenthub@agenthub

Important

Chỉ chọn MỘT trong hai đường. Cài dashboard từ cả sg lẫn marketplace riêng của AgentHub sẽ chạy hai bộ hook ingestion song song — mỗi event vào database hai lần, token và cost bị đếm đôi.

Lần session-start kế tiếp sẽ tự cài hook, boot server, đưa CLI agenthub vào PATH (chạy nền). Sau đó dùng /agenthub-doctor để kiểm tra, /agenthub-open để build UI và lấy URL, /agenthub-update để cập nhật.

Yêu cầu trước khi cài:

Cần	Vì sao
Node >= 22.5	Bản cài qua plugin dùng node:sqlite (không có better-sqlite3 native)
git	Mọi thao tác lane (worktree, đọc branch/status)
tmux	Bắt buộc nếu muốn chạy agent từ trình duyệt hoặc dùng agenthub lanes shell — dashboard gọi thẳng binary tmux, không có bản dự phòng
gh (tùy chọn)	Chỉ cần cho agenthub lanes ci status và các bước mở PR

sudo apt install git tmux        # Ubuntu / Debian
brew install git tmux            # macOS
tmux -V                          # xác nhận: tmux 3.x

Windows không có tmux native — chạy AgentHub trong WSL2 và cài tmux ở trong đó. Thiếu tmux thì dashboard vẫn chạy bình thường, chỉ riêng nút Start Run và agenthub lanes shell là lỗi.

Hướng dẫn đầy đủ: README.vi.md · INSTALL.md · docs/PLUGINS.md

MCP (Model Context Protocol)

MCP là cách nối Claude Code với một hệ thống bên ngoài (database, trình duyệt, tracker, API nội bộ) dưới dạng tool mà agent gọi được, thay vì bạn phải copy/paste dữ liệu vào prompt.

Lệnh cần biết:

claude mcp list                  # các MCP server đang nối và trạng thái
claude mcp add <tên> -- <lệnh khởi động server>
claude mcp remove <tên>

Phạm vi cấu hình: ~/.claude.json (user, dùng ở mọi project) hoặc .mcp.json trong repo (project, commit được để cả team dùng chung). Trong AgentHub, trang Settings → Claude Code liệt kê mọi MCP server đang cấu hình kèm transport, command/args và file nguồn — xem nhanh hơn là mở từng file.

Lưu ý khi cài: một MCP server là một tiến trình chạy trên máy bạn với quyền của bạn và phần mô tả tool của nó đi thẳng vào context của agent. Chỉ nối server bạn tin tưởng, và đọc kỹ env của nó có đòi token gì.

Danh sách MCP khuyến nghị cho team: chưa chốt. Hiện chưa máy nào trong nhóm cấu hình MCP server (claude mcp list trống), nên phần này để trống có chủ đích thay vì liệt kê cho có — ai dùng thấy tốt thì bổ sung vào đây kèm lý do.

---

4. Các Skills Nên Cài

Marketplace nội bộ Smartgift

Đăng ký marketplace một lần rồi cài plugin theo vai trò (cần đăng nhập gitea Smartgift):

# 1. Đăng ký marketplace (một lần)
claude plugin marketplace add https://git.smartgift.io.vn/Smartgift-AI/smartgift-claude-skills.git

# 2. Nếu đã cài all thì không cần cài các plugin bên dưới
claude plugin install sg-all@sg

Nguồn: https://git.smartgift.io.vn/Smartgift-AI/smartgift-claude-skills

Plugin	Skill	Dùng cho
sg-all	sg-md-writing + sg-prompt-sharpening	Khuyến nghị — cài tất cả
sg-dev	sg-md-writing	Soạn & bảo trì file CLAUDE.md/AGENTS.md ràng buộc hành vi AI
sg-common	sg-prompt-sharpening	Làm rõ yêu cầu và tự sửa prompt trước khi hành động

Đã cài sg-all thì KHÔNG cần cài thêm sg-dev hay sg-common — cài trùng sẽ nạp lặp skill. Chỉ chọn sg-dev/sg-common riêng nếu có lý do muốn giới hạn phạm vi:

claude plugin install sg-dev@sg        # chỉ sg-md-writing
claude plugin install sg-common@sg     # chỉ sg-prompt-sharpening

Xem: claude plugin list. Gỡ: claude plugin uninstall sg-all@sg (hoặc sg-dev@sg / sg-common@sg tùy plugin đã cài).

---

5. Phương Pháp Sử Dụng Claude Code Hiệu Quả

• Quản lý ngữ cảnh (Context) chặt chẽ: Giá trị của việc đưa Context đầy đủ và sạch sẽ cho AI lớn hơn nhiều so với việc tập trung vào prompt. Hãy giữ context gọn gàng bằng cách loại bỏ các file không liên quan và tránh nhồi nhét thông tin thừa cho AI.
• Review độc lập: Sử dụng một Agent riêng biệt (tạo một session mới) hoặc Teammate khác (cài đặt chế độ tmux cho teammate) để review code thay vì dùng chính Agent đang thực thi tác vụ. Agent thực hiện thường có xu hướng thiên vị và tự mặc định mã nguồn của mình là đúng.
• Tận dụng Skills/Workflows có sẵn: Luôn ưu tiên sử dụng các quy trình và kỹ năng đã được xây dựng sẵn cho từng tác vụ cụ thể thay vì để Agent tự ứng biến.
  • Ví dụ: Sử dụng skill systematic-debugging của Superpowers khi cần debug, hoặc quy trình code-review tích hợp sẵn của Claude Code khi cần review một PR, commit (mình có thể đưa nó link hoặc chỉ commit version cho nó review).