ECC: bộ công cụ giúp Claude Code lập kế hoạch, kiểm thử, review — hướng dẫn cài đặt và dùng
Bài này là một góc nhìn khác về affaan-m/ECC — repo từng đổi tên nên mình viết lại với cách tiếp cận khác. Bài hướng dẫn chính: affaan-m/ECC: nâng cấp AI coding agent — hướng dẫn cài đặt và dùng →

Tóm tắt nhanh
ECC là một bộ công cụ cài thêm vào Claude Code, Codex và một số trợ lý lập trình AI khác. Nó cho AI quy trình làm việc đầy đủ: lập kế hoạch, viết test, code, tự review, kiểm tra và ghi nhớ. Cài bằng một lệnh npx có trình hướng dẫn từng bước, cần Node.js 18 trở lên, Git và Claude Code.
ECC là một hệ thống tăng hiệu suất cho trợ lý lập trình AI. Nó là bộ gồm agent, skill, hook, bộ nhớ và công cụ quét bảo mật, cài vào Claude Code (và cả Codex, Cursor, OpenCode…) để AI làm việc theo quy trình chứ không chỉ trả lời từng câu lẻ. Repo hiện có khoảng 302.000 sao và 44.500 fork, giấy phép MIT.
Vấn đề nó giải quyết rất quen: bạn nhờ AI viết code, nó viết ngay mà không lập kế hoạch, không test, không tự soát lại. Lần sau bạn lại phải gõ lại đúng những yêu cầu đó. ECC đóng gói quy trình ấy một lần để bạn không phải nhắc lại trong mỗi prompt. README tóm tắt nó bằng một dòng: lập kế hoạch → test → code → review → kiểm tra → ghi nhớ → cải thiện.
Bài này hợp với lập trình viên mới, người làm văn phòng đã bắt đầu dùng Claude Code, hoặc chủ doanh nghiệp nhỏ có người làm web, tự động hoá bằng AI. Điểm đáng giá nhất là trình cài đặt có hướng dẫn: bạn chạy một lệnh, trả lời vài câu hỏi, không cần clone repo hay sửa file cấu hình bằng tay.
affaan-m/ECC
ECC là bộ plugin cho Claude Code, Codex và các trợ lý lập trình khác: thêm agent, skill, hook, bộ nhớ và quét bảo mật để AI làm việc có quy trình.
I.ECC làm được gì
Theo README, ECC hiện gồm khoảng 71 agent, 314 skill và 98 lệnh tắt kiểu cũ (legacy command shims). Ngoài ra còn hook, rules, bộ nhớ, học liên tục và công cụ quét bảo mật AgentShield. Mỗi phần có ích như sau.
- Agent chuyên trách. Có agent cho lập kế hoạch, review code, sửa lỗi build, bảo mật, kiến trúc và các mảng chuyên môn. Lợi ích: AI review code của chính nó bằng một ngữ cảnh mới, nên dễ thấy lỗi hơn là tự đọc lại ngay trong cuộc trò chuyện đang dài.
- Skill. Đây là các kỹ năng đóng gói sẵn, README liệt kê TDD (viết test trước), nghiên cứu, bảo mật, tài liệu, frontend, dữ liệu, ML, vận hành và nhiều mảng khác. Bạn khỏi phải tự viết hướng dẫn cho AI từ đầu.
- Hook và bộ nhớ. Hook là các bước tự chạy trong lúc AI làm việc: ép tuân thủ quy tắc, tóm tắt phiên làm việc, kiểm soát ngữ cảnh. Bộ nhớ và học liên tục giúp thói quen tốt của bạn được giữ lại thay vì mất khi đóng phiên.
- Rules (quy tắc luôn bật). Bạn chọn theo ngôn ngữ hoặc dự án, ví dụ bộ quy tắc chung kèm bộ cho TypeScript. README lưu ý plugin Claude Code không phân phối được rules, nên phần này cài riêng.
- AgentShield. Quét prompt, hook, cấu hình MCP, quyền truy cập, secret và file agent để tìm chỗ không an toàn. Hữu ích khi bạn cài nhiều công cụ AI và muốn biết có gì rủi ro.
- Nhiều trợ lý lập trình. ECC chạy tốt nhất với Claude Code, có đường cài chính thức cho Codex và Qoder, và có bộ chuyển đổi hạn chế tính năng cho Cursor, OpenCode, Gemini, Zed, GitHub Copilot, Antigravity, Qwen… README dặn xem bảng trạng thái hỗ trợ trước khi mong mọi tính năng giống nhau ở mọi nơi.
II.Cần chuẩn bị gì
Theo README, bạn cần:
- Node.js 18 trở lên. Gói
ecc-universalyêu cầu mức này. - Git. Cần cho việc cài plugin Claude.
- Claude Code 2.1 trở lên, đã nằm trong
PATH(gõclaudetrong terminal phải chạy được). - Terminal. Trên Windows, README hướng dẫn mở PowerShell từ menu Start.
Tư liệu không nói ECC cần GPU hay phần cứng riêng, nên bạn cứ hiểu là không có yêu cầu đặc biệt nào được ghi. Bản thân Claude Code vẫn cần tài khoản của nó theo cách bạn đang dùng. File .env.example của repo có liệt kê các biến như ANTHROPIC_API_KEY và GITHUB_TOKEN, nhưng README phần đã đọc không bắt buộc bạn điền chúng cho cách cài khuyến nghị. Khi cần dùng, bạn xem README đầy đủ và file .env.example trong repo.
Only cài ECC từ nguồn chính thức: repo affaan-m/ECC trên GitHub, gói npm ecc-universal và ecc-agentshield, plugin ecc@ecc, và trang ecc.tools. README cảnh báo các bản đăng lại hay bản sao không chính thức có thể chứa mã độc. Lệnh cài sẽ chạy code trên máy bạn, nên hãy gõ đúng tên gói.
III.Cài đặt từng bước
README khuyên dùng trình cài hướng dẫn (guided setup). Bạn chọn một trong hai cách: trình cài này hoặc lệnh plugin gốc của Claude Code. Đừng làm cả hai trên cùng một máy.
- Chuẩn bịCài Node.js 18+, Git và Claude Code 2.1+
- Mở terminalTrên Windows mở PowerShell từ menu Start
- Chạy trình càiGõ npx ecc-universal@2.2.3 setup
- Chọn tuỳ chọnChọn Global user và hooks Standard rồi xác nhận
- Kiểm traMở phiên Claude Code mới, gõ /plugin list
A.Kiểm tra các thứ cần có
Mở terminal và kiểm tra từng công cụ có sẵn chưa. Nếu một lệnh báo "không tìm thấy", hãy cài hoặc sửa công cụ đó trước rồi mới chạy ECC.
node --version
git --version
claude --versionMỗi lệnh phải in ra một số phiên bản. Chỗ người mới hay vấp: vừa cài xong Node hoặc Claude Code mà gõ lệnh vẫn báo không có. Khi đó hãy đóng cửa sổ terminal và mở lại.
B.Chạy trình cài hướng dẫn
Đây là lệnh chính. README ghim phiên bản 2.2.3, khớp với bản phát hành hiện tại của repo.
npx ecc-universal@2.2.3 setupREADME nói trình cài này không cần clone repo. Nó kiểm kê marketplace chính thức và các phạm vi cài đặt Claude hiện có trước khi thay đổi, rồi cài, cập nhật hoặc chuyển plugin ecc@ecc sang phạm vi bạn chọn. Bạn chạy lại cùng lệnh bất cứ khi nào muốn cập nhật, đổi phạm vi hay đổi mức hook.
Với người dùng cá nhân thông thường, README gợi ý chọn Global user, chọn hooks Standard rồi xác nhận.
Nếu bạn dùng trình quản lý gói khác, README cho các lệnh tương đương:
pnpm dlx ecc-universal@2.2.3 setup
yarn dlx ecc-universal@2.2.3 setup
bunx ecc-universal@2.2.3 setupYarn Classic 1 không có yarn dlx; hãy dùng npx hoặc nâng cấp Yarn.
C.Hoặc: dùng lệnh plugin gốc của Claude Code
Nếu bạn thích cách thủ công hơn, mở Claude Code và gõ hai lệnh sau (đây là lệnh gõ bên trong Claude Code, không phải trong PowerShell):
/plugin marketplace add https://github.com/affaan-m/ECC
/plugin install ecc@eccCách này cài skill, agent, lệnh và hook do plugin quản lý. Làm xong thì dừng ở đó, đừng cài thêm bản thủ công đầy đủ. Nếu một trong hai lệnh báo đã có cài đặt hoặc xung đột phạm vi, README bảo dùng trình cài hướng dẫn ở trên hoặc tự giải quyết phạm vi plugin bị xung đột trước khi thử lại.
Bạn cũng có thể khai báo thẳng trong ~/.claude/settings.json, kết quả giống hai lệnh trên:
{
"extraKnownMarketplaces": {
"ecc": {
"source": {
"source": "github",
"repo": "affaan-m/ECC"
}
}
},
"enabledPlugins": {
"ecc@ecc": true
}
}D.Thêm quy tắc (rules) nếu cần
Plugin không phân phối được rules, nên README hướng dẫn copy tay chỉ những gói bạn muốn. Hãy bắt đầu với rules/common cộng một gói ngôn ngữ bạn thật sự dùng. Các lệnh dưới đây là cú pháp bash (Git Bash, macOS, Linux); PowerShell không có mkdir -p và cp -R theo kiểu này, nên trên Windows bạn dùng Git Bash hoặc copy thư mục bằng File Explorer.
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/ # thay bằng stack của bạnREADME dặn rõ: nếu đã cài plugin thì đừng chạy ./install.sh --profile full sau đó.
E.Cài cho Codex hoặc nhiều trợ lý cùng lúc (tuỳ chọn)
Để cấu hình nhiều trợ lý trong một luồng, README có trình cài hướng dẫn đa nền tảng. Nó cho bạn chọn bất kỳ tổ hợp nào của Claude Code, Codex và Kimi Code, hiện từng đích cài, kiểm tra trước khi ghi và hỏi xác nhận một lần cuối.
npx ecc-universal@2.2.3 install --guidedBạn có thể chạy thử không ghi gì (dry run) để xem trước:
npx ecc-universal@2.2.3 install --guided --harness codex --dry-runVới Codex bản mới, README cũng có đường cài plugin gốc:
codex plugin marketplace add affaan-m/ECC
codex plugin add ecc@ecc
codex plugin list --jsonCác trợ lý khác (Cursor, Gemini, OpenCode, Zed…) dùng lệnh ecc install --target ... riêng. Phần đó README đưa nhiều chi tiết, bạn đọc trực tiếp trong repo trước khi làm.
IV.Kiểm tra đã chạy được chưa
Cách kiểm tra theo README: mở một phiên Claude Code mới rồi gõ:
/plugin listNếu danh sách có ecc@ecc ở trạng thái đang bật (enabled) thì cài thành công. Nếu không thấy, hãy đóng hẳn Claude Code, mở lại rồi gõ lại lệnh.
Sau khi cài xong, skill /ecc:configure-ecc dùng được trong Claude để cấu hình lại, nó gọi cùng luồng cài an toàn ở trên. Nó chỉ có sau khi plugin đã cài, nên không thay được lệnh /plugin trong lần cài đầu.
Bạn cũng có thể hỏi trình cài về tình trạng máy bằng lệnh doctor, README có ví dụ cho Kimi:
npx ecc-universal@2.2.3 doctor --target kimiV.Dùng vào việc thật
Tư liệu README chủ yếu mô tả cách cài và quy trình, không đưa kịch bản dùng chi tiết. Các tình huống dưới đây bám vào những gì README cho biết ECC làm được; prompt chỉ là gợi ý của mình để bạn thử, không phải lệnh có sẵn trong repo.
A.Lập trình viên mới: nhờ AI lập kế hoạch trước khi code
Bạn đang tập làm một website nhỏ cho cửa hàng của gia đình. Trước đây bạn gõ "làm cho mình trang đặt hàng" và AI viết ngay một đống code mà bạn không hiểu. Sau khi cài ECC, bạn thử nhờ AI theo đúng tinh thần quy trình của repo:
Hãy lập kế hoạch cho trang đặt hàng đơn giản trước. Liệt kê các bước, viết test trước, rồi mới code. Cuối cùng review lại phần vừa viết.Kết quả mong đợi: AI chia việc thành các bước, có test đi kèm và có bước soát lại, thay vì xả code một lần. Bạn dễ theo dõi và dễ phát hiện chỗ sai hơn.
Cài một lần, cả quy trình đi theo bạn, không phải gõ lại trong từng prompt.
Ông T
B.Chủ doanh nghiệp nhỏ: kiểm tra bảo mật cấu hình AI đang dùng
Bạn thuê người làm một công cụ tự động hoá có kết nối MCP, có nhiều key và quyền truy cập. Bạn muốn biết cấu hình có chỗ nào đáng ngại không. README nói AgentShield quét prompt, hook, cấu hình MCP, quyền truy cập, secret và file agent. Gói ecc-agentshield được nhắc tên riêng trên npm. README phần đã đọc không có lệnh cụ thể để chạy nó, nên bạn xem hướng dẫn AgentShield trong repo hoặc trên trang ecc.tools. Kết quả: một danh sách các điểm cần sửa để bạn đưa cho người làm cùng xử lý.
C.Dev trong nhóm: hỏi ECC nên dùng skill nào
Nhóm bạn có hàng trăm skill để chọn và không biết bắt đầu từ đâu. README có lệnh consult: bạn đưa chủ đề, ECC gợi ý theo mục tiêu cài đặt.
npx ecc-universal@2.2.3 consult "security reviews" --target claudeKết quả mong đợi: gợi ý các phần phù hợp với chủ đề "security reviews" cho Claude. Bạn thay chủ đề bằng việc của mình. Cần gói gọn nhẹ thì README còn có hồ sơ cài tối thiểu:
npx ecc-universal@2.2.3 install --profile minimal --target claude --with capability:machine-learningD.Máy bị reset: khôi phục thay vì cài lại từ đầu
Bạn đổi máy hoặc cấu hình Claude bị xoá, tưởng mất hết thiết lập. README bảo đừng hoảng: chạy lần lượt ba lệnh sau trong thư mục repo đã clone (lệnh node scripts/ecc.js ... dùng file nằm trong repo). Chúng liệt kê cái đã cài, chẩn đoán và sửa các file do ECC quản lý.
node scripts/ecc.js list-installed
node scripts/ecc.js doctor
node scripts/ecc.js repairKết quả: thường khôi phục lại các file ECC quản lý mà không phải dựng lại từ đầu.
VI.Lỗi hay gặp và cách xử lý
A.Lệnh node, git hoặc claude báo không tìm thấy
Đây là lỗi số một ở người mới. README nói rõ: nếu một lệnh kiểm tra không chạy, hãy cài hoặc sửa công cụ đó rồi mới chạy lại ECC. Sau khi cài, đóng terminal và mở lại để PATH cập nhật.
B.npx báo lỗi phiên bản hoặc cache
Trước khi thử lại, hãy xem phiên bản đang có trên npm:
npm view ecc-universal versionSo kết quả với phiên bản trong lệnh cài (đang là 2.2.3 trong README). Lệnh này chỉ đọc thông tin, không thay đổi máy bạn.
C.Gõ npx ecc-install ... rồi không chạy được
README cảnh báo ecc-install chỉ là tên file chạy nằm bên trong gói ecc-universal, không phải một gói npm riêng. Hãy dùng đúng cú pháp bắt đầu bằng npx ecc-universal@2.2.3 ....
D.Skill, lệnh hoặc hook bị hiện lặp hai lần
Thường do bạn cài chồng nhiều cách vào cùng một trợ lý, ví dụ plugin cộng thêm bản cài thủ công đầy đủ. README khuyên chọn một cách cho mỗi trợ lý. Nếu đã lỡ chồng, hãy xem phần Reset / Uninstall ECC trong README của repo rồi làm theo. Đừng tự xoá file thủ công khi chưa đọc phần đó.
E.Lệnh /plugin của Claude Code báo xung đột phạm vi
Đây là thông báo lỗi do chính Claude Code, ECC không can thiệp được. Cách xử lý theo README: dùng lại trình cài hướng dẫn npx ecc-universal@2.2.3 setup, hoặc gỡ phạm vi plugin bị xung đột rồi cài lại. Nếu vẫn kẹt, README gợi ý mở form báo lỗi cài đặt hoặc chạy ecc feedback; ECC không tự gửi chẩn đoán đi đâu cả.
VII.Có nên dùng không
Điểm mạnh. Cài dễ nhờ trình hướng dẫn, miễn phí theo giấy phép MIT, và quy trình lập kế hoạch → test → review → ghi nhớ có sẵn thay vì tự dựng. Bộ này đồ sộ (hàng chục agent, hàng trăm skill) và có quét bảo mật đi kèm. Repo được cập nhật trong vài tháng gần đây.
Giới hạn. Với người mới, bộ này khá lớn, bạn sẽ không dùng hết và có thể bị ngợp. Khả năng đầy đủ nhất là ở Claude Code; các trợ lý khác chỉ có bộ chuyển đổi hạn chế, nên đừng giả định tính năng giống hệt. README còn nhắc ECC Pro, một GitHub App có phí cho repo riêng tư, bắt đầu từ 19 USD mỗi người mỗi tháng, trong khi bản mã nguồn mở vẫn miễn phí.
Khi nào chọn cách khác. Nếu bạn chỉ dùng Claude Code để hỏi đáp hay viết vài đoạn script, cài thêm cả hệ thống này là thừa. Một vài skill lẻ hoặc file hướng dẫn riêng đã đủ. Hãy chọn ECC khi bạn làm dự án thật, muốn AI làm việc có quy trình, và sẵn sàng bỏ ít phút đọc cách nó hoạt động.
Về dữ liệu: README phần đã đọc không nêu chi tiết dữ liệu được lưu hay gửi đi đâu, ngoài việc ECC không tự upload chẩn đoán. Nếu bạn xử lý dữ liệu nhạy cảm, hãy đọc SECURITY.md trong repo và xem lại mã nguồn trước khi chạy.
Câu hỏi thường gặp
ECC có miễn phí không?
Bản mã nguồn mở của ECC dùng giấy phép MIT và README nói sẽ miễn phí mãi. Ngoài ra có ECC Pro, một GitHub App cho repo riêng tư, tính từ 19 USD mỗi người mỗi tháng. Bạn không bắt buộc dùng gói trả phí để cài và dùng bản mã nguồn mở.
ECC cần những gì để cài?
Cần Node.js 18 trở lên, Git và Claude Code 2.1 trở lên có trong PATH. Trên Windows, README hướng dẫn mở PowerShell rồi chạy `npx ecc-universal@2.2.3 setup`. Không cần clone repo cho cách cài này.
Có chạy được trên Windows không?
Có. README có hẳn một phần hướng dẫn cho người dùng Windows lần đầu, dùng PowerShell. Riêng bước copy rules theo kiểu `mkdir -p` và `cp -R` là cú pháp bash, nên trên Windows bạn nên dùng Git Bash hoặc copy thủ công.
Có cần GPU không?
Tư liệu không nhắc yêu cầu GPU hay phần cứng riêng nào. ECC là bộ skill, agent và hook chạy cùng trợ lý lập trình của bạn, nên phần nặng nằm ở dịch vụ AI chứ không phải ECC. Nếu cần biết chắc, bạn xem README đầy đủ.
ECC dùng được với trợ lý nào ngoài Claude Code?
README nói ECC chạy tốt nhất với Claude Code, có đường cài chính thức cho Codex và Qoder, và có cài hướng dẫn cho Kimi Code. Cursor, OpenCode, Gemini, Zed, GitHub Copilot, Antigravity, Qwen và vài nơi khác dùng bộ chuyển đổi giới hạn tính năng. Hãy xem bảng trạng thái hỗ trợ trong README trước khi kỳ vọng tính năng giống hệt.
Có nên cài ECC bằng nhiều cách cùng lúc không?
Không. README dặn mỗi trợ lý chỉ chọn một cách cài, vì cài chồng có thể làm skill, lệnh hoặc hook bị lặp. Bạn có thể dùng ECC cho nhiều trợ lý khác nhau cùng lúc, miễn mỗi trợ lý chỉ cài một lần.
Dữ liệu của tôi có an toàn không?
README nói ECC không tự upload chẩn đoán, và có kèm AgentShield để quét cấu hình, quyền truy cập và secret. Tư liệu phần đã đọc chưa nói chi tiết về nơi lưu dữ liệu. Bạn nên đọc SECURITY.md và chỉ cài từ nguồn chính thức.


