ECC: Tối Ưu AI Agent Cho Claude Code
/ECC
ECC là bộ công cụ mã nguồn mở theo giấy phép MIT, cài vào Claude Code, Codex và các nền tảng agent lập trình AI khác, bổ sung quy trình plan-test-review-verify có cấu trúc cùng 68 agent và 284 skill. Hãy dùng nếu bạn làm việc trong Claude Code hay Codex và muốn quy trình đó tự động áp dụng thay vì gõ lại mỗi prompt; bỏ qua nếu nền tảng bạn dùng chỉ có adapter giới hạn tính năng, vì README cảnh báo không nên coi các nền tảng ngang tính năng.
Nâng Cao AI Agent Lập Trình Với ECC
ECC là hệ thống cài vào một nền tảng agent lập trình AI có sẵn như Claude Code, Codex, Cursor, hoặc OpenCode, bổ sung skill, bản năng agent, bộ nhớ, và tính năng quét bảo mật quanh mô hình đang chạy ở đó. Nó thay quy trình plan-test-review mà lẽ ra bạn phải viết lại mỗi prompt. Hãy dùng nếu nền tảng của bạn là Claude Code hoặc Codex, nơi README mô tả hỗ trợ đầy đủ; nền tảng khác thì xem như hỗ trợ một phần cho tới khi kiểm tra bảng hỗ trợ.
Năng Lực Cốt Lõi Của Hệ Thống ECC
- ✓68 agent được xây cho các việc như lên kế hoạch, review code, sửa build lỗi, kiểm tra bảo mật, quyết định kiến trúc, và các việc chuyên biệt khác theo từng lĩnh vực, theo đúng bảng thành phần trong README.
- ✓284 skill trải khắp các nhóm như TDD, bảo mật, nghiên cứu, viết tài liệu, frontend và xử lý dữ liệu, cộng thêm machine learning và các việc vận hành hàng ngày.
- ✓94 command shim cũ vẫn còn được giữ lại trong lúc ECC chuyển bề mặt lệnh của mình sang hướng lấy skill làm trung tâm.
- ✓AgentShield quét nhiều hơn cả code mà agent viết ra: nó kiểm tra prompt, hook, cấu hình quyền, secret, cấu hình MCP, và cả file định nghĩa agent.
- ✓Runtime hook và bộ nhớ xử lý việc thực thi rule, tóm tắt phiên làm việc, học liên tục, và kiểm soát ngữ cảnh, tách biệt với các rule pack luôn được nạp sẵn.
- ✓Rule pack là thứ bạn chọn thêm theo ngôn ngữ hoặc dự án chứ không phải một gói cố định, nên bạn chỉ nạp đúng chuẩn mà mình dùng.
- ✓Đi qua đúng cấu hình model mà nền tảng đang dùng, nên một API endpoint tuỳ chỉnh hay model tự host đứng sau ANTHROPIC_BASE_URL vẫn hoạt động mà không cần đổi quy trình của ECC.
Ai Sẽ Hưởng Lợi Từ ECC?
Nhà phát triển đã dùng Claude Code hay Codex hàng ngày và muốn vòng lặp lên kế hoạch, test, review, verify được áp dụng tự động mà không phải giải thích lại mỗi phiên sẽ tận dụng được ECC nhiều nhất; 68 agent và 284 skill của nó được xây quanh đúng quy trình lặp lại đó. Team đang cân nhắc dùng nhiều nền tảng cùng lúc nên đọc bảng hỗ trợ nền tảng trước, vì chính README của ECC mô tả Cursor, Zed, Gemini, OpenCode, GitHub Copilot, Antigravity, và Qwen chỉ được hỗ trợ qua adapter giới hạn tính năng, chứ chưa ngang bằng Claude Code.
Cài Đặt ECC Vào Nền Tảng Lập Trình AI Của Bạn
Với Claude Code, cách README khuyên dùng là hai lệnh plugin: /plugin marketplace add https://github.com/affaan-m/ECC rồi tới /plugin install ecc@ecc. Chỉ một lần cài đó đã mang theo thư viện skill, các agent, command, và hook do plugin tự quản lý của ECC, và README nói nên dừng ở đó thay vì cài thêm thủ công chồng lên. Một luồng setup có hướng dẫn cho ecc-universal đang được lên kế hoạch cho bản npm 2.2.0; bản hiện tại là 2.1.0 và chưa có luồng đó, nên các lệnh plugin vẫn là đường đi được ghi trong tài liệu lúc này. Plugin của Claude Code không mang theo được rule pack, nên rule phải được chép riêng: clone repo về, rồi chép rules/common cùng một pack ngôn ngữ (ví dụ rules/typescript) vào ~/.claude/rules/ecc. Người dùng Codex thì chạy codex plugin marketplace add affaan-m/ECC và codex plugin add ecc@ecc thay vào đó. Các nền tảng khác, gồm Cursor, OpenCode, Gemini CLI, Zed, Antigravity, và Qwen, đi qua ./install.sh --profile minimal --target <harness> sau khi clone repo, riêng OpenCode cần thêm bước npm install && npm run build:opencode trước. README nói rõ chỉ nên cài từ repo GitHub gốc, hai package ecc-universal và ecc-agentshield trên npm, GitHub App, plugin slug ecc@ecc, và trang ecc.tools. README cảnh báo các bản mirror của bên thứ ba không được kiểm duyệt và có thể chứa mã độc.
Cấu Hình ECC Cho Các Quy Trình Nâng Cao
Các lệnh /multi-plan, /multi-execute, /multi-backend, /multi-frontend, và /multi-workflow không nằm trong phần cài plugin hay rule cơ bản; chúng cần runtime ccg-workflow riêng, khởi động bằng npx ccg-workflow, cái này mang theo các dependency như ~/.claude/bin/codeagent-wrapper. Để cho ECC chạy qua một model gateway tuỳ chỉnh hay model tự host thay vì API do Anthropic host, hãy set ANTHROPIC_BASE_URL và ANTHROPIC_AUTH_TOKEN trước khi khởi động claude. README nói ECC không hardcode cấu hình transport của Anthropic, và hook, skill, rule của nó không quan tâm nhà cung cấp nào đứng sau CLI claude, miễn là bản thân CLI đó đã chạy được. Các MCP server cũng không tự bật khi cài qua plugin; hãy chép định nghĩa bạn cần từ mcp-configs/mcp-servers.json vào .mcp.json theo phạm vi repo, hoặc dùng lệnh /mcp có sẵn của Claude Code. ECC chỉ đi kèm đúng một connector mặc định, chrome-devtools. Nếu bạn đã tự chạy phiên bản riêng của connector đó, set ECC_DISABLED_MCPS="chrome-devtools" sẽ báo cho luồng cài đặt và sync của ECC bỏ qua nó thay vì thêm một bản trùng.
Điểm mạnh
- ✓Giấy phép MIT giữ cho repo affaan-m/ECC gốc luôn miễn phí để tự cài, bất kể gói ECC Pro trả phí.
- ✓node scripts/ecc.js consult "security reviews" --target claude cho phép xem trước và chọn component trước khi cài trọn bộ 68 agent, 284 skill.
- ✓README nêu rõ những cách kết hợp cài đặt nên tránh chồng lên nhau, ví dụ cài plugin Claude Code cùng lúc với cài thủ công đầy đủ, thay vì để bạn tự phát hiện xung đột.
- ✓Chạy được sau một model gateway tuỳ chỉnh hay model tự host: set ANTHROPIC_BASE_URL và ANTHROPIC_AUTH_TOKEN thì hook và skill của ECC vẫn hoạt động bình thường, miễn CLI claude đã kết nối được.
- ✓Có sẵn đường khôi phục được ghi lại rõ ràng, list-installed rồi tới doctor rồi repair, cho lúc setup Claude cục bộ của bạn bị xoá sạch, mà không cần mua lại gì cả.
Khả Năng Tương Thích Nền Tảng Và Giới Hạn Đã Biết
- △README không hề giải thích chữ ECC viết tắt cho gì, và cũng không có lịch sử phiên bản, changelog, hay ngày thành lập, nên mức độ trưởng thành hay tuổi đời thật sự của dự án không rõ ràng từ những gì được ghi lại ở đây.
- △Mức hỗ trợ không đồng đều giữa các nền tảng: chỉ Claude Code và một sync path cho Codex được mô tả là hỗ trợ đầy đủ, còn Cursor, Zed, Gemini, OpenCode, GitHub Copilot, Antigravity, và Qwen chỉ có thứ README gọi là adapter giới hạn tính năng.
- △Luồng setup có hướng dẫn cho ecc-universal trên npm chưa ra mắt. README nói nó sẽ có ở bản 2.2.0, còn bản npm hiện tại là 2.1.0, nên người dùng npm vẫn phải đi theo đường cài plugin hoặc script lúc này.
- △/multi-plan, /multi-execute, và các command đa model khác không chạy được ngay khi cài xong; chúng cần cài thêm runtime ccg-workflow riêng qua npx ccg-workflow.
- △README mô tả ECC được một người bảo trì duy nhất phát hành hàng tuần trên 7 nền tảng, điều đáng cân nhắc khi nhìn vào số lượng tích hợp mà một người phải giữ cho luôn cập nhật.
- △ECC Pro, bản GitHub App được host cho repo riêng tư, có giá từ $19/seat/mo theo README; bản miễn phí chỉ bao gồm phần bạn tự cài và tự chạy.
Khám Phá Các Lựa Chọn Thay Thế Để Tối Ưu Agent
Câu Hỏi Thường Gặp Về ECC
ECC dùng giấy phép MIT, miễn phí để clone, cài, và tự chạy trên cả dự án mã nguồn mở lẫn dự án riêng tư; chỉ riêng ECC Pro, bản GitHub App được host cho repo riêng tư, mới tính phí, từ $19/seat/mo theo README.
affaan-m/ECC là repo gốc trên GitHub, ecc@ecc là định danh marketplace và plugin trên Claude Code, còn ecc-universal là package npm riêng; README nói rõ ba cái tên này cố tình không dùng thay cho nhau được.
Theo README, Claude Code được hỗ trợ đầy đủ hiện tại, Codex có sync path chính thức, còn các nền tảng như Cursor, Zed, Gemini, OpenCode, GitHub Copilot, Antigravity, và Qwen chỉ có adapter nhẹ hơn, giới hạn tính năng so với bộ tính năng đầy đủ.
ECC chạy được sau một API endpoint tuỳ chỉnh hay model tự host: với Claude Code, set ANTHROPIC_BASE_URL và ANTHROPIC_AUTH_TOKEN sẽ định tuyến traffic qua gateway riêng của bạn mà không cần đổi quy trình của ECC, theo README.
README hướng dẫn chạy node scripts/ecc.js list-installed, rồi tới doctor, rồi repair, như chuỗi khôi phục trước khi cài lại ECC; README cũng nói rõ setup Claude bị xoá hay reset không có nghĩa là bạn phải mua lại bất cứ thứ gì.
ECC Pro là bản GitHub App được host của ECC, dành cho repo riêng tư, giá từ $19/seat/mo theo README, trong khi repo mã nguồn mở affaan-m/ECC vẫn giữ giấy phép MIT và miễn phí để tự cài.
Vấn đề ECC giải quyết
Một agent trong Claude Code hay Codex có thể tự viết code, nhưng để nó lên kế hoạch trước, chạy test, tự review lại diff của mình từ một ngữ cảnh sạch, và mang bài học sang phiên làm việc tiếp theo, thường bạn phải tự viết phần khung đó vào file CLAUDE.md hoặc AGENTS.md của riêng mình, lặp lại cho từng dự án. ECC không viết code thay bạn. Nó đóng gói chuỗi plan-test-implement-review-verify-remember-improve đó thành một plugin cài được, đi kèm 68 agent và 284 skill, để một team không phải dựng lại cùng một bộ rule và hook ở mỗi repo mình làm việc.
Trường hợp sử dụng tốt nhất
- •Chuẩn hoá vòng lặp plan-test-review-verify cho mọi phiên làm việc trong Claude Code, thay vì dán lại cùng một đoạn hướng dẫn vào CLAUDE.md mỗi lần.
- •Chạy cùng một quy trình agent trên cả Claude Code lẫn Codex, vì ECC có sync path được hỗ trợ chính thức cho Codex bên cạnh plugin gốc cho Claude Code.
- •Kiểm tra một setup agent hiện có xem prompt, hook, cấu hình MCP, quyền, và secret có bị lộ hay không bằng AgentShield trước khi các file đó được đưa vào dùng.
- •Chỉ cài một phần nhỏ của ECC, vài skill hay một capability, qua node scripts/ecc.js consult, thay vì cài trọn bộ 68 agent và 284 skill.
Repo liên quan
ECC có đáng để bạn bỏ thời gian?
ChatGPT, Claude và Perplexity đều đọc được trang này. Hỏi thử xem họ nghĩ gì về ECC.