Tích Hợp ECC Cho Claude Code: Tối Ưu Hóa Quy Trình Phát Triển Với 68 AI Agent Chuyên Biệt

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 chúng tôi.

Con số cập nhật mới nhất: Repo cập nhật liên tục. Khi chúng tôi kiểm tra lại (25/09/2026), bản mới nhất v2.2.2 đã có 68 agent, 292 skill, 94 lệnh và khoảng 267.000 sao trên GitHub.[1] Khi bạn đọc, con số có thể còn cao hơn nữa. 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 chúng tôi 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 chúng tôi. 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: 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.

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?

Công cụ	Mức hỗ trợ
Claude Code	Đầy đủ nhất, đây là nền tảng chính. Khuyên dùng
Codex (OpenAI)	Có plugin riêng, hỗ trợ tốt.
Cursor, OpenCode	Bản beta, có agent và skill cốt lõi, thiếu một số hook.
GitHub Copilot	Chỉ có phần hướng dẫn, không có agent chạy thật.
Gemini, Zed, Qwen, Kimi…	Có bộ cài riêng cho từng công cụ, ít tính năng hơn Claude Code.

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

Quy trình thực tế: Tích Hợp ECC Cho Claude Code: Tối Ưu Hóa Quy Trình Phát Triển Với 68 AI Agent Chuyên Biệt

Đá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.

Hiểu rõ chuyện tiền trước khi cài: Repo ECC miễn phí 100%. Nhưng Claude Code cần tài khoản Claude trả phí: Gói Pro khoảng 20 USD/tháng (tầm hơn 500.000đ), gói Max 100 hoặc 200 USD/tháng, hoặc trả theo lượng dùng qua API.[5] Với gói Pro, chạy cả vòng nhiều agent sẽ chạm giới hạn khá nhanh. Xem phần tiết kiệm lượt dùng. Ngoài ra repo có bản ECC Pro (GitHub App cho repo riêng tư, từ 19 USD/người/tháng). Bạn không cần bản này để làm theo tài liệu. 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). Ngại gõ lệnh? Mở Claude Code rồi nhắn: “Cài giúp chúng tôi plugin ECC từ repo github.com/affaan-m/ECC bằng lệnh /plugin”, Claude sẽ hướng dẫn tiếp. Tuy nhiên lệnh /plugin là lệnh hệ thống, cách chắc ăn nhất vẫn là tự dán 2 lệnh dưới đây. Trong Claude Code, dán lệnh sau rồi Enter: /plugin marketplace add affaan-m/ECC

Lệnh này đăng ký repo ECC làm một “chợ” plugin, để Claude Code biết lấy đồ từ đâu. README chính thức ghi dạng đường dẫn đầy đủ, cũng dùng được, kết quả như nhau:

Bước 2: Cài plugin

Vẫn trong Claude Code, dán tiếp:

/plugin install ecc@ecc

Vậy là xong phần cài. Agent, skill, lệnh và hook đều vào cùng lúc. Nếu Claude Code hỏi phạm vi cài (scope):

user: Dùng cho mọi dự án trên máy bạn. Chọn cái này nếu bạn là người mới.
project: Chỉ dự án hiện tại, và chia sẻ cho cả nhóm qua Git.
local: Chỉ dự án hiện tại, chỉ riêng máy bạn.

Kiểm tra đã cài chưa: Gõ /plugin, mở mục đã cài (Installed) và tìm ecc@ecc. Sau khi cài, bạn có thêm lệnh /ecc:configure-ecc để chỉnh cấu hình ECC về sau.[1]

Chỉ cài MỘT cách thôi: Tác giả nhấn mạnh: Đừng cài chồng nhiều cách vào cùng một công cụ (ví dụ vừa cài plugin, vừa chạy thêm ./install.sh --profile full). Cài hai lần sẽ khiến skill, lệnh, hook bị nhân đôi: Hook chạy 2 lần, tốn token gấp đôi.[1] Đã lỡ cài chồng thì xem mục Xử lý lỗi.

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 npx, không cần cài toàn cục: Một số hướng dẫn trên mạng ghi npm i -g ecc-universal. Theo README hiện tại, cách được khuyên dùng là npx [email protected] setup (chạy trình hướng dẫn, không cần cài toàn cục). Số phiên bản 2.2.2 sẽ đổi theo thời gian. Kiểm tra bản mới nhất bằng npm view ecc-universal version. Và đừng gõ npx ecc-install, vì đó không phải một gói npm riêng.[1]

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:

Bước 3: Bốn việc cốt lõi: Lên kế hoạch → Viết code → Kiểm thử → Bảo mật

Bạn muốn	Gõ gì	Agent nhận việc
Lên kế hoạch tính năng	`/ecc:plan "mô tả tính năng"`	planner (+ architect nếu cần thiết kế kiến trúc)
Viết code có test đi kèm	Nhắn “dùng skill tdd-workflow để làm tính năng này”	tdd-guide
Kiểm thử & đo độ phủ	`/test-coverage` để đo độ phủ, skill `e2e-testing` cho luồng người dùng	e2e-runner (khi dùng skill e2e-testing)
Rà bảo mật	`/security-scan`	security-reviewer
Rà lại code vừa viết	`/code-review`	code-reviewer
Sửa lỗi build	`/build-fix`	build-error-resolver
Dọn code thừa	`/refactor-clean`	refactor-cleaner
Cập nhật tài liệu	`/update-docs`	doc-updater
Lưu / mở lại phiên làm việc	`/save-session` · `/resume-session`	Không có

Nguồn: Mục Start Using ECC trong README.[1]

4 câu tiếng thường đó làm những việc sau:

“Lên kế hoạch cho tính năng này” → agent planner thiết kế toàn bộ: File nào cần sửa, bước nào làm trước, rủi ro gì.
“Làm đi” → nó viết code bằng Django, Next.js, React… tuỳ dự án của bạn, theo kiểu viết test trước.
“Kiểm thử đi” → chạy test cho đến khi độ phủ đạt khoảng 80%.
“Rà bảo mật đi” → agent bảo mật đóng vai hacker tấn công thử chính app của bạn (theo danh sách lỗ hổng phổ biến OWASP Top 10) rồi đề xuất/vá lỗ hổng.

Mẹo: Gõ / để xem đúng tên lệnh trên máy bạn: README ghi lệnh lên kế hoạch có tiền tố (/ecc:plan), còn các lệnh khác ghi dạng ngắn như /security-scan. Tuỳ cách cài, tên lệnh trên máy bạn có thể có hoặc không có tiền tố ecc:. Gõ / rồi gõ ecc hoặc tên lệnh để Claude Code gợi ý đúng danh sách đang có. Một số bài hướng dẫn cũ ghi /plan hoặc /tdd, các lệnh đó có thể đã đổi tên.

“Tự vá lỗ hổng” không có nghĩa là an toàn tuyệt đối: Agent bảo mật giúp bạn bắt được nhiều lỗi phổ biến, nhưng không thay thế được một đợt kiểm tra bảo mật chuyên nghiệp cho sản phẩm có dữ liệu thật của khách hàng (thanh toán, thông tin cá nhân). Luôn đọc lại các bản vá trước khi chấp nhận, và dùng Git để có thể quay lại nếu AI sửa sai.

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

Bước 4: Chọn một tính năng nhỏ và chạy đủ 4 khâu

Chạy thật một lần qua cả 4 khâu giá trị hơn một tiếng ngồi đọc tài liệu. Làm theo thứ tự:

Lưu lại bản hiện tại bằng Git trước khi bắt đầu (gõ trong Terminal: git add . && git commit -m "truoc khi thu ECC"). Nếu AI làm hỏng, bạn quay lại được.
Mở Claude Code trong thư mục dự án.
Dán câu lệnh mẫu bên dưới (tiếng Việt hay tiếng Anh đều được).
Đọc kế hoạch Claude đưa ra. Đồng ý hoặc sửa trước khi cho nó code.
Theo dõi từng khâu, xem kết quả test và báo cáo bảo mậ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 chúng tôi. Sau đó làm tính năng này, kiểm thử nó, và rà bảo mật cho nó.

Bản tiếng Anh nếu bạn quen ra lệnh bằng tiếng Anh: “Plan a dark mode toggle for my settings page, then build it, test it, and secure it.”

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 (DevPixel VN)
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 chúng tôi 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ờ chúng tôi 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 chúng tôi 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 chúng tôi 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 chúng tôi đồ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]

Thiết lập	Mặc định	Nên đặt	Tác dụng
`model`	opus	sonnet	Giảm khoảng 60% chi phí
`MAX_THINKING_TOKENS`	31.999	10.000	Giảm khoảng 70% chi phí “suy nghĩ ngầm” mỗi lượt
`CLAUDE_AUTOCOMPACT_PCT_OVERRIDE`	95	50	Tự nén hội thoại sớm hơn, phiên dài vẫn giữ chất lượng
`CLAUDE_CODE_SUBAGENT_MODEL`	Không có	haiku	Agent con chạy bằng model rẻ nhất
`ECC_CONTEXT_MONITOR_COST_WARNINGS`	on	off (nếu dùng gói tháng)	Tắt cảnh báo ước tính tiền API, vốn không áp dụng với gói Pro/Max

Cách áp dụng cấu hình Dễ nhất

Bấm Copy ở ô settings.json mẫu trong phần Chạy thử.
Mở Claude Code, dán nội dung vừa copy vào ô chat.
Nhắn: “Gộp các thiết lập này vào file ~/.claude/settings.json của chúng tôi, giữ nguyên các thiết lập đang có.”
Thoát và mở lại Claude Code.

Tự làm tay: Mở file ~/.claude/settings.json (Mac: Thư mục người dùng → thư mục ẩn .claude; bấm Cmd+Shift+. để hiện file ẩn), rồi thêm các dòng trên. Đừng ghi đè cả file nếu bạn đã có thiết lập khác.

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 chúng tôi tổng hợp từ kinh nghiệm dùng Claude Code ở Việt Nam:

Chỉ tải từ nguồn chính thức: Cẩn thận bản “share lại”: Repo nổi tiếng nên rất dễ bị người khác đóng gói lại rồi chia sẻ trên group Facebook, Zalo, Telegram kiểu “bản full đã crack”, “bản Việt hoá”. Chính README cảnh báo các bản re-upload có thể chứa mã độc.[1] Nguồn chính thức duy nhất: Repo github.com/affaan-m/ECC, plugin ecc@ecc, gói npm ecc-universal và ecc-agentshield, website ecc.tools. Hook có quyền chạy lệnh trên máy bạn, nên cài nhầm bản giả là rất nguy hiểm.

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

Đọc tiếp