ECC (Everything Claude Code)

1. ECC là gì?

ECC là một bộ "đồ nghề" cài thêm cho các trợ lý lập trình bằng AI như Claude Code hay Codex. Bản thân các trợ lý này đã viết được code; ECC bổ sung cho chúng một quy trình làm việc có kỷ luật: lên kế hoạch trước khi làm, viết bài kiểm tra, tự rà soát lại code, ghi nhớ những điều quan trọng giữa các phiên làm việc. README của dự án hiện ghi bộ này gồm 68 agent (trợ lý chuyên trách từng việc), gần 300 skill (quy trình mẫu) và 94 lệnh tắt, kèm công cụ quét bảo mật AgentShield.

Nói thẳng: đây là công cụ dành cho người đang lập trình cùng AI, không phải một ứng dụng có cửa sổ để bấm. Cài xong bạn không thấy biểu tượng mới nào trên màn hình; thứ thay đổi là trợ lý AI của bạn có thêm lệnh và làm việc bài bản hơn.

Về chi phí: phần mã nguồn mở của ECC miễn phí, giấy phép MIT. Dự án có một gói trả phí riêng tên ECC Pro (ứng dụng GitHub cho kho mã riêng tư, README ghi từ 19 USD mỗi người mỗi tháng), bạn không cần gói này để dùng những gì hướng dẫn dưới đây. Tuy nhiên bạn vẫn cần tài khoản của chính trợ lý AI (ví dụ Claude Code), và khoản đó thường mất tiền.

Hợp với bạn nếu:

• Bạn đã dùng Claude Code (hoặc Codex) để viết code và muốn nó làm việc cẩn thận hơn.
• Bạn muốn có sẵn các lệnh như lập kế hoạch tính năng, rà soát code, sửa lỗi build mà không phải tự viết lời nhắc dài.
• Bạn chấp nhận gõ vài dòng lệnh.

Chưa hợp nếu:

• Bạn chưa từng dùng trợ lý lập trình AI nào. Hãy làm quen với Claude Code trước, rồi quay lại.
• Bạn tìm một ứng dụng chat AI thông thường. ECC không phải thứ đó.
• Bạn dùng Cursor, Gemini, Copilot… và mong đủ tính năng như trên Claude Code. Dự án ghi rõ các công cụ này mới được hỗ trợ ở mức thử nghiệm hoặc hạn chế.

2. Cần chuẩn bị gì?

• Máy tính chạy Windows, macOS hoặc Linux. ECC không chạy trên điện thoại. Trên Windows, dự án ghi là "hỗ trợ có giới hạn": phần cốt lõi chạy được, một số tính năng tùy chọn cần Git Bash hoặc WSL.
• Node.js bản 18 trở lên. Đây là phần mềm nền để chạy các công cụ viết bằng JavaScript; cài nó xong bạn có luôn lệnh npx dùng ở bước cài đặt. Tải tại https://nodejs.org (chọn bản LTS).
• Git. Công cụ quản lý phiên bản mã nguồn; dự án ghi đây là thứ bắt buộc phải có để cài plugin cho Claude Code. Tải tại https://git-scm.com
• Claude Code bản 2.1 trở lên, đã cài và đăng nhập. Đây là trợ lý lập trình của Anthropic chạy trong cửa sổ dòng lệnh, và là nơi ECC hoạt động tốt nhất. Xem cách cài và các gói trả phí tại trang chính thức https://code.claude.com
• Kết nối mạng trong lúc cài.

ECC không yêu cầu khóa API riêng. Không cần tải mã nguồn của dự án về máy.

Lưu ý: Chỉ cài ECC từ nguồn chính thức: kho GitHub https://github.com/affaan-m/ECC, gói npm ecc-universal, plugin mang tên ecc@ecc và trang https://ecc.tools. Dự án cảnh báo các bản đăng lại ở nơi khác có thể chứa mã độc.

3. Cài đặt từng bước

ECC không có file cài .exe hay .dmg. Cách dễ nhất, cũng là cách dự án khuyên dùng, là chạy trình cài có hướng dẫn từng câu hỏi.

Bước 1: Kiểm tra ba thứ cần có

Mở PowerShell (Windows) hoặc Terminal (macOS, Linux) rồi gõ lần lượt từng dòng:

node --version
git --version
claude --version

Đúng là khi mỗi lệnh in ra một số phiên bản: Node từ 18 trở lên, Claude Code từ 2.1 trở lên. Lệnh nào báo "not found" hoặc "is not recognized" thì quay lại mục 2, cài phần mềm tương ứng, đóng cửa sổ dòng lệnh, mở lại và thử lần nữa. Trình cài ECC không tự cài giúp ba thứ này.

Bước 2: Chạy trình cài có hướng dẫn

npx ecc-universal setup

Lần đầu, npx có thể hỏi có tải gói ecc-universal về không; gõ y rồi Enter.

Lưu ý: README mới nhất trên GitHub viết lệnh kèm số phiên bản, dạng npx ecc-universal@2.2.2 setup. Tại ngày viết hướng dẫn này (30/9/2026), bản mới nhất thật sự có trên npm là 2.2.1, nên lệnh ghim số 2.2.2 có thể báo lỗi không tìm thấy phiên bản. Lệnh không kèm số ở trên luôn lấy bản mới nhất đã phát hành. Muốn biết bản đó là bao nhiêu, gõ npm view ecc-universal version.

Bước 3: Trả lời các câu hỏi của trình cài

Trình cài sẽ kiểm tra máy bạn đã có ECC ở đâu chưa, rồi hỏi hai điều chính. Với nhu cầu cá nhân thông thường, dự án gợi ý:

• Phạm vi cài: chọn Global user (dùng được ở mọi thư mục dự án trên máy).
• Mức hook: chọn Standard. Hook là các đoạn tự động chạy khi trợ lý AI làm việc, ví dụ chặn một lệnh xóa nguy hiểm.

Sau đó xác nhận. Đúng là khi trình cài báo hoàn tất và không có dòng lỗi màu đỏ.

Bước 4: Kiểm tra trong Claude Code

Đóng phiên Claude Code đang mở (nếu có), mở một phiên mới rồi gõ:

/plugin list

Đúng là khi danh sách có dòng ecc@ecc ở trạng thái đang bật (enabled).

Cách khác: cài ngay bên trong Claude Code

Nếu bạn không muốn dùng npx, có thể gõ hai lệnh sau ngay trong Claude Code:

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

Hai cách cho ra cùng một plugin. Chỉ chọn một cách. Dự án nhấn mạnh việc cài chồng nhiều cách lên cùng một trợ lý sẽ làm lệnh và hook bị nhân đôi.

Dùng Codex hoặc công cụ khác

Với Codex, README hướng dẫn hai lệnh:

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

Với Cursor, OpenCode, Gemini CLI, Zed và các công cụ khác, cách cài phải tải mã nguồn về và chạy script riêng cho từng công cụ. Phần này dành cho người đã quen dòng lệnh; xem bảng chi tiết trong README tại https://github.com/affaan-m/ECC

4. Dùng lần đầu

Dự án khuyên đừng cố học hết vài trăm skill. Hãy bắt đầu từ đúng việc bạn đang làm.

1. Mở cửa sổ dòng lệnh tại thư mục dự án code của bạn và gõ claude để vào Claude Code.
2. Thử lệnh lập kế hoạch. Thay phần trong ngoặc kép bằng việc bạn muốn làm:

/ecc:plan "Thêm trang đăng nhập bằng email"

Kết quả đúng: Claude Code không lao vào viết code ngay mà trả về một bản kế hoạch chia bước, nêu file nào sẽ sửa và cần kiểm tra gì. Bạn đọc, chỉnh, rồi mới cho nó làm.

3. Sau khi có code mới, thử nhờ rà soát:

/code-review

Bạn sẽ nhận một danh sách nhận xét về đoạn code vừa viết.

Vài lệnh khác hay dùng, theo bảng trong README:

Việc bạn đang làm	Lệnh
Build bị lỗi, cần sửa	/build-fix
Dọn code thừa	/refactor-clean
Phiên làm việc đã dài, muốn xem còn bao nhiêu "bộ nhớ"	/context-budget
Lưu lại để mai làm tiếp	/save-session
Làm tiếp phiên hôm trước	/resume-session
Quét rủi ro bảo mật trong cấu hình	/security-scan

Muốn xem ECC đang cài những gì, gõ /plugin list ecc@ecc.

5. Lỗi thường gặp và cách sửa

Dấu hiệu	Nguyên nhân	Cách sửa
Gõ node, git hoặc claude thì báo "not found" / "is not recognized"	Phần mềm đó chưa cài, hoặc cài xong chưa mở lại cửa sổ dòng lệnh	Cài theo link ở mục 2, đóng và mở lại cửa sổ, chạy lại Bước 1
npx báo lỗi phiên bản hoặc lỗi cache (ví dụ không tìm thấy bản 2.2.2)	Lệnh ghim một số phiên bản chưa có trên npm	Gõ npm view ecc-universal version để xem bản đang có, rồi chạy npx ecc-universal setup không kèm số
Cài xong nhưng /plugin list không có ecc@ecc	Phiên Claude Code cũ chưa nạp plugin mới	Thoát hẳn Claude Code, mở phiên mới rồi kiểm tra lại
Lệnh /plugin install báo plugin đã tồn tại hoặc xung đột phạm vi	Trước đó ECC đã được cài ở một phạm vi khác	Chạy npx ecc-universal setup; trình cài sẽ chuyển ecc@ecc về phạm vi bạn chọn
ECC hiện hai lần, mỗi hook chạy hai lượt	Cài plugin rồi lại cài thủ công chồng lên	Gỡ plugin khỏi Claude Code, chạy lệnh gỡ ở mục 6, rồi cài lại đúng một cách
Báo "Duplicate hooks file detected"	File cấu hình plugin bị khai báo hook hai lần	Đừng chép hooks/hooks.json vào settings.json; Claude Code 2.1 trở lên đã tự nạp hook của plugin
Dùng Yarn bản 1 thì yarn dlx báo không có lệnh	Yarn Classic không có dlx	Dùng npx như Bước 2

Nếu vẫn kẹt, dự án có mẫu báo lỗi cài đặt trong mục Issues của kho GitHub và file hướng dẫn chi tiết tại https://github.com/affaan-m/ECC/blob/main/TROUBLESHOOTING.md. ECC không tự gửi dữ liệu chẩn đoán đi đâu cả.

6. Gỡ cài đặt / cập nhật

Cập nhật

Chạy lại đúng lệnh cài:

npx ecc-universal setup

Trình cài tự nhận ra bản đang có và cập nhật. Cũng dùng lệnh này khi bạn muốn đổi phạm vi cài hoặc đổi mức hook.

Kiểm tra và sửa chữa

Nếu ECC chạy không ổn, thử chẩn đoán trước khi gỡ. Chạy trong đúng thư mục bạn đã dùng khi cài:

npx ecc-universal doctor
npx ecc-universal repair

Gỡ

Xem trước những gì sẽ bị gỡ, rồi mới gỡ thật:

npx ecc-universal uninstall --dry-run
npx ecc-universal uninstall

Nếu bạn cài bằng hai lệnh /plugin trong Claude Code, hãy gỡ plugin ecc@ecc ngay trong Claude Code (gõ /plugin để mở phần quản lý plugin). ECC chỉ xóa những file nó đã ghi nhận là của mình; các thư mục quy tắc bạn tự chép tay thì bạn tự xóa.

7. Câu hỏi hay gặp

ECC có mất tiền không? Phần mã nguồn mở thì không, giấy phép MIT. ECC Pro là dịch vụ trả phí riêng cho kho mã riêng tư trên GitHub và không bắt buộc. Trợ lý AI mà ECC chạy bên trong (Claude Code, Codex) có chi phí riêng của nó.

Có cần mạng không? Cần khi cài và cập nhật. Khi dùng thì trợ lý AI của bạn vốn đã cần mạng.

ECC có gửi dữ liệu của tôi đi đâu không? README ghi rõ ECC không tự tải dữ liệu chẩn đoán lên; biểu mẫu góp ý khi gỡ là tùy chọn và là một bài đăng công khai trên GitHub. Còn code bạn đưa cho trợ lý AI thì đi theo chính sách của trợ lý đó, không phải của ECC.

Dùng với Cursor hay Copilot được không? Được ở mức hạn chế. Bảng hỗ trợ của dự án xếp Claude Code là ổn định, Codex là được hỗ trợ, Cursor và OpenCode ở mức beta, Copilot chỉ có phần hướng dẫn dạng văn bản, các công cụ còn lại ở mức thử nghiệm.

Cài nhiều có làm trợ lý AI chậm đi không? Plugin đưa danh mục skill vào ngữ cảnh của mô hình, nên có tốn thêm token. Dự án có lệnh /context-budget để kiểm tra và một kiểu cài gọn không kèm hook (npx ecc-universal install --profile minimal --target claude) cho máy hoặc mô hình có ngữ cảnh nhỏ.