ECC: Biến Claude Code thành cả một đội kỹ sư AI

ECC là một plugin miễn phí biến Claude Code thành một “đội kỹ sư” gồm nhiều chuyên gia: Người lên kế hoạch, người viết code, người kiểm thử, người rà bảo mật. Bạn cài một lần bằng hai lệnh, sau đó giao việc bằng câu tiếng Việt bình thường.

Bài này đi qua từng bước: Giải thích từng khái niệm cho người chưa rành, cài đặt từng bước, cách gọi đúng agent, cách tránh “cháy” lượt dùng, cách xử lý lỗi, và một phần lưu ý riêng cho người Việt (thanh toán, gõ tiếng Việt, Windows, tải nhầm bản giả...). Đọc xong, bạn sẽ cài được ECC và chạy trọn một vòng lên kế hoạch → viết code → kiểm thử → rà bảo mật trên dự án thật của mình.

ECC là gì? Giải thích cho người mới

ECC (tên cũ là Everything Claude Code) là một kho mã nguồn mở trên GitHub do lập trình viên Affaan Mustafa (tài khoản affaan-m) xây dựng. Tác giả dùng Claude Code từ những ngày đầu và gom toàn bộ cấu hình “đã chạy thật trên nhiều sản phẩm” của mình vào repo này.[1] Repo dùng giấy phép MIT, nghĩa là miễn phí, được dùng cả cho mục đích thương mại.

Hiểu nôm na: Claude Code bình thường giống một lập trình viên giỏi nhưng làm một mình. Cài ECC vào giống như bạn thuê thêm cả một phòng kỹ thuật đứng sau lưng anh ta: Có người chuyên lên kế hoạch, người chuyên viết test, người chuyên soi bảo mật, người chuyên sửa lỗi build, và một quy trình làm việc bài bản:

Mấy từ bạn sẽ gặp trong tài liệu

Bấm vào từ nào chưa rõ để mở phần giải thích, chỗ nào đã biết thì bỏ qua.

Trong gói ECC có gì?

• Agent: Lên kế hoạch, thiết kế kiến trúc, rà code, sửa lỗi build, bảo mật, và các reviewer riêng cho Go, Python, TypeScript...
• Skill: TDD (viết test trước), nghiên cứu, tài liệu, frontend, dữ liệu, machine learning, vận hành...
• Hook & bộ nhớ: Tự tóm tắt phiên làm việc, tự học thói quen, cảnh báo khi ngữ cảnh sắp đầy.
• AgentShield: Lớp bảo mật quét prompt, hook, cấu hình MCP, quyền truy cập và mật khẩu/khoá bị lộ trong dự án. Kèm GateGuard chặn các lệnh nguy hiểm (như xoá file hàng loạt) trước khi chạy.[1]

Dùng được với công cụ nào?

Nguồn: Bảng hỗ trợ nền tảng trong README chính thức.[1]

Chuẩn bị trước khi cài

Đánh dấu đủ các ô dưới đây rồi hãy sang phần cài đặt. Mất 5 phút kiểm tra ở đây sẽ đỡ cho bạn 30 phút sửa lỗi sau.

• Đã cài Claude Code phiên bản 2.1 trở lên. Kiểm tra bằng cách mở Terminal, gõ claude --version rồi Enter. Chưa có thì xem hướng dẫn cài tại trang tài liệu Claude Code.
• Đã cài Git (công cụ tải và quản lý mã nguồn). Gõ git --version để kiểm tra. Chưa có: Tải tại git-scm.com.
• Đã cài Node.js 18 trở lên: Chỉ cần nếu bạn dùng cách cài bằng npm. Gõ node --version. Chưa có: Tải bản LTS tại nodejs.org.
• Có gói trả phí hoặc API cho công cụ bạn dùng. ECC miễn phí, nhưng “bộ não” AI chạy bên dưới thì không.
• Có sẵn một dự án thật (dù nhỏ) để chạy thử: Một trang web cá nhân, một app to-do... ECC phát huy khi có code thật để làm việc.

Cài ECC vào Claude Code

Toàn bộ phần cài chỉ là 2 lệnh, gõ bên trong Claude Code (không phải gõ ở ô chat claude.ai trên trình duyệt).

/plugin marketplace add affaan-m/ECC

/plugin marketplace add https://github.com/affaan-m/ECC

/plugin install ecc@ecc

Cách khác: Cài bằng trình hướng dẫn npm

Nếu lệnh /plugin báo lỗi, hoặc bạn muốn cài cho cả Codex/Kimi Code, dùng trình hướng dẫn cài đặt (wizard) của ECC. Gõ trong Terminal thường (không phải trong Claude Code), cần Node.js 18+:

npx [email protected] setup

Trình này tự kiểm tra máy bạn đang có gì, rồi cài/cập nhật ecc@ecc theo phạm vi bạn chọn. Muốn cập nhật ECC về sau, chạy lại đúng lệnh này. Muốn cài cho nhiều công cụ một lượt (Claude Code + Codex + Kimi Code):

npx [email protected] install --guided

Dùng Codex thay vì Claude Code?

Gõ trong Terminal:

codex plugin marketplace add affaan-m/ECC
codex plugin add ecc@ecc

Sau đó trong Codex gõ $configure-ecc để cấu hình. Cursor và OpenCode dùng bộ chuyển đổi riêng (bản beta), xem mục Other agents and editors trong README.[1]

Tuỳ chọn: Thêm bộ quy tắc (rules)

Plugin của Claude Code không tự mang theo rules được, nên nếu muốn Claude luôn tuân theo chuẩn code của ECC, bạn chép tay. Người mới có thể bỏ qua bước này. Nếu làm, chỉ lấy bộ chung + đúng một ngôn ngữ bạn dùng:

git clone https://github.com/affaan-m/ECC.git
cd ECC
mkdir -p ~/.claude/rules/ecc
cp -R rules/common ~/.claude/rules/ecc/
cp -R rules/typescript ~/.claude/rules/ecc/   # đổi thành python, golang... tuỳ dự án

Cho các agent vào việc

Đến đây ECC không còn là một bản cài đặt nữa, mà là một đội. Bạn có thể giao việc bằng 4 câu tiếng thường, hoặc gõ đúng lệnh để gọi thẳng agent phụ trách:

Chạy thử trọn một vòng trên dự án thật

Hãy lên kế hoạch cho nút bật/tắt chế độ tối (dark mode) ở trang Cài đặt của mình. Sau đó làm tính năng này, kiểm thử nó, và rà bảo mật cho nó.

Mình soạn sẵn một bộ câu lệnh mẫu tiếng Việt cho cả 4 khâu, kèm file cấu hình tiết kiệm token (giải thích ở phần sau). Bấm Copy để lấy nguyên khối:

BỘ PROMPT MẪU ECC: TIẾNG VIỆT (Cường Mê AI)
Dán từng khối vào Claude Code sau khi đã cài plugin ecc@ecc.
Thay phần trong [ngoặc vuông] bằng thông tin dự án của bạn.

========================================
0. LÀM QUEN VỚI DỰ ÁN (chạy đầu tiên)
========================================
Hãy đọc qua dự án này và tóm tắt cho mình bằng tiếng Việt:
Công nghệ đang dùng, cấu trúc thư mục chính, cách chạy dự án
và cách chạy test. Chưa sửa gì cả.

========================================
1. LÊN KẾ HOẠCH (agent planner)
========================================
/ecc:plan "[Mô tả tính năng, ví dụ: Thêm nút bật/tắt chế độ tối ở trang Cài đặt, nhớ lựa chọn của người dùng sau khi tải lại trang]"

Yêu cầu thêm: Trình bày kế hoạch bằng tiếng Việt, liệt kê file sẽ
sửa, các bước theo thứ tự, rủi ro có thể gặp. Chờ mình duyệt rồi
mới bắt đầu code.

========================================
2. VIẾT CODE THEO KIỂU TEST TRƯỚC (agent tdd-guide)
========================================
Kế hoạch ổn rồi. Hãy dùng skill tdd-workflow để làm tính năng này:
Viết test trước (để test chạy đỏ), sau đó viết code tối thiểu cho
test xanh, rồi dọn lại code. Báo cho mình sau mỗi giai đoạn.

========================================
3. KIỂM THỬ VÀ ĐO ĐỘ PHỦ
========================================
/test-coverage

Nếu độ phủ dưới 80%, hãy bổ sung test cho những phần còn thiếu và
chạy lại. Báo cáo con số độ phủ cuối cùng bằng tiếng Việt.

========================================
4. RÀ BẢO MẬT (agent security-reviewer)
========================================
/security-scan

Sau đó giải thích cho mình bằng tiếng Việt, dễ hiểu cho người
không chuyên: Có lỗ hổng nào, mức độ nghiêm trọng ra sao, và đề
xuất cách vá. Chỉ sửa sau khi mình đồng ý.

========================================
5. RÀ LẠI TOÀN BỘ (agent code-reviewer)
========================================
/code-review

========================================
6. CẢ VÒNG TRONG MỘT CÂU (tốn nhiều lượt dùng hơn)
========================================
Hãy lên kế hoạch cho [tính năng], sau đó làm nó, kiểm thử nó và
rà bảo mật cho nó. Trả lời và giải thích bằng tiếng Việt.

========================================
7. KẾT THÚC PHIÊN
========================================
/save-session
(Lần sau mở lại: /resume-session)

{
  "model": "sonnet",
  "env": {
    "MAX_THINKING_TOKENS": "10000",
    "CLAUDE_AUTOCOMPACT_PCT_OVERRIDE": "50",
    "CLAUDE_CODE_SUBAGENT_MODEL": "haiku",
    "ECC_CONTEXT_MONITOR_COST_WARNINGS": "off"
  }
}

Tiết kiệm lượt dùng: Đừng để “cháy” gói

Nhiều agent đồng nghĩa với nhiều lượt gọi AI. Gói Pro có thể hết hạn mức chỉ sau vài vòng chạy đủ 4 khâu. Tác giả ECC khuyên cấu hình sau để giảm chi phí mà không giảm chất lượng đáng kể:[1]

Thói quen hằng ngày

• /model sonnet cho việc thường; chỉ đổi /model opus khi cần suy luận kiến trúc phức tạp.
• /clear khi chuyển sang việc không liên quan: Xoá sạch hội thoại, miễn phí.
• /compact ở các điểm dừng tự nhiên (xong nghiên cứu, xong một mốc). Đừng nén khi đang code dở.
• /cost để xem đã tiêu bao nhiêu; /context-budget để xem cái gì đang ngốn ngữ cảnh.
• Bật dưới 10 MCP và dưới 80 công cụ mỗi dự án, vì mỗi công cụ bật thêm đều chiếm chỗ trong “bộ nhớ ngắn hạn” của Claude. MCP là các kết nối giúp Claude dùng công cụ bên ngoài như Gmail, Notion, cơ sở dữ liệu.
• Bắt đầu với một agent cho một việc nhỏ, quen rồi mới chạy cả vòng 4 khâu.

Lưu ý riêng cho người Việt

Mấy điểm dưới đây mình tổng hợp từ kinh nghiệm dùng Claude Code ở Việt Nam:

• Thanh toán: Claude thu phí bằng USD qua thẻ quốc tế (Visa/Mastercard, kể cả thẻ ghi nợ quốc tế của ngân hàng Việt). Ngân hàng thường cộng thêm phí chuyển đổi ngoại tệ khoảng 1-3%, nên số tiền trừ thực tế sẽ nhỉnh hơn giá niêm yết. Tránh mua “tài khoản share” giá rẻ trôi nổi, dễ bị khoá và lộ code của bạn cho người khác.
• Ra lệnh bằng tiếng Việt được, nhưng tên lệnh (/ecc:plan, /security-scan) và tên skill (tdd-workflow) phải giữ nguyên tiếng Anh. Thêm câu “trả lời bằng tiếng Việt” để nhận báo cáo tiếng Việt.
• Gõ tiếng Việt có dấu trong Terminal đôi khi bị lỗi lặp chữ hoặc mất dấu với bộ gõ Telex (Unikey, EVKey, bộ gõ macOS). Cách tránh: Soạn câu lệnh ở Notes/Word rồi dán vào, hoặc dùng Claude Code trong ứng dụng Claude trên máy tính / trong VS Code.
• Đặt tên thư mục dự án không dấu, không khoảng trắng (ví dụ du-an-web thay vì Dự án Web). Nhiều script và hook chạy bằng dòng lệnh dễ lỗi với đường dẫn có dấu tiếng Việt.
• Máy Windows: Phần lõi chạy được, nhưng một số tính năng (tự học liên tục, bộ nhớ) còn lỗi trên Windows thuần. Nên cài WSL (Windows Subsystem for Linux, một “máy Linux thu nhỏ” chạy bên trong Windows) để dùng trơn tru nhất.[1]
• Có README tiếng Việt ngay trong repo, tiện đọc thêm, nhưng bản dịch có thể chậm hơn bản tiếng Anh. Khi có mâu thuẫn, tin bản tiếng Anh.[2]
• Code của công ty: Hỏi quy định nội bộ trước khi cho AI đọc mã nguồn. Tuyệt đối không dán mật khẩu, API key vào ô chat hay chia sẻ ảnh chụp màn hình có chứa key lên group.
• Mạng chậm/chặn: Nếu lệnh thêm marketplace bị treo lâu (mạng công ty, Wi-Fi quán cà phê chặn GitHub), thử đổi sang 4G hoặc mạng khác rồi chạy lại.

Danh sách kiểm tra sau khi cài

Đủ 5 ô này là bạn đã cài và dùng ECC đúng cách:

• Thêm marketplace không báo lỗi, và trong menu /plugin thấy ecc@ecc ở mục đã cài.
• Gõ /ecc:plan thì việc được giao cho agent planner, không phải một câu trả lời chung chung.
• Chạy test thì có báo cáo độ phủ (con số %), chứ không chỉ nói “xong rồi”.
• Rà bảo mật đưa ra phát hiện hoặc bản vá trên một file thật.
• Đã bấm Star cho repo ECC trên GitHub để dễ theo dõi cập nhật.

Xử lý lỗi thường gặp