# 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](#1-tiet-kiem-tokens)
2. [Tăng Hiệu Suất Coding](#2-tang-hieu-suat-coding)
3. [Các Plugin & MCP Khuyên Dùng](#3-cac-plugin--mcp-khuyen-dung)
4. [Các Skills Nên Cài](#4-cac-skills-nen-cai)
5. [Phương Pháp Sử Dụng Claude Code Hiệu Quả](#5-phuong-phap-su-dung-claude-code-hieu-qua)

---

## 1. Tiết kiệm Tokens

### [rtk (Rust Token Killer)](https://github.com/rtk-ai/rtk)
* **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](https://github.com/juliusbrussee/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](https://github.com/obra/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](https://github.com/multica-ai/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

*Chưa cập nhật*

---

## 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):

```bash
# 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:

```bash
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).
