Everything Claude Code (ECC): Khung Agent Mã Nguồn Mở cho Claude Code

Kể từ khi agent lập trình trở nên phổ biến, bạn đã phải giải thích lại stack, quy ước, sở thích và tiêu chuẩn review của mình bao nhiêu lần ở đầu mỗi phiên?

Vấn đề là mỗi cuộc trò chuyện mới đều bắt đầu từ số 0. Những công cụ như Claude Code biết cách viết mã, nhưng không biết đội của bạn viết mã như thế nào. Thứ lẽ ra tiết kiệm thời gian lại biến thành thao tác thủ công: dán cùng một ngữ cảnh dự án, chỉnh lại mô hình khi nó chệch hướng, tối ưu hướng dẫn, và xem lại những gợi ý chung chung lặp đi lặp lại mỗi lần.

Everything Claude Code (ECC) là một khung mã nguồn mở nhằm khắc phục điều đó. Dù tên gọi như vậy, nó không liên quan tới Anthropic. Đây là một hệ thống agent và lớp workflow chạy trên Claude Code (không phải mô hình, không phải IDE), biến một agent lập trình tổng quát thành một nền tảng kỹ thuật chuyên biệt vốn đã hiểu tiêu chuẩn của bạn.

Trong bài viết này, tôi sẽ trình bày ECC là gì, các thành phần ghép với nhau ra sao, cách cài đặt, và ai thực sự nên dùng.

Nhưng chính xác Claude Code là gì? Hãy tham gia khóa Claude Code 101 để học cách dùng nó trong quy trình phát triển hàng ngày.

Everything Claude Code Là Gì?

ECC là một repo mã nguồn mở bao bọc Claude Code bằng một lớp vận hành dựng sẵn cho công việc kỹ thuật.

Bạn có thể tìm dự án tại affaan-m/ECC trên GitHub. Dự án dùng giấy phép MIT, do Affaan Mustafa duy trì, và được xây dựng từ hơn 10 tháng dùng Claude Code hằng ngày trên sản phẩm thực. Dù tên gọi, nó không liên quan tới Anthropic.

Repo đóng gói bốn thứ trong một lần cài:

• Bộ khung agent: tập hợp các sub-agent chuyên biệt (lập kế hoạch, kiến trúc, review mã, review bảo mật, xử lý lỗi build, và cả tá tác vụ khác) mà Claude Code sẽ ủy nhiệm thay vì cố làm mọi thứ trong một cửa sổ ngữ cảnh.
• Hệ sinh thái kỹ năng: vài trăm định nghĩa workflow nhỏ bao phủ TDD, review bảo mật, các mẫu framework (Django, Spring Boot, Next.js, và khác), tiêu chuẩn mã hóa theo ngôn ngữ, và tác vụ ML-engineering.
• Khung workflow: các hook chạy theo sự kiện công cụ, các quy tắc luôn áp dụng, cấu hình máy chủ MCP, và bộ nhớ phiên duy trì qua nhiều cuộc trò chuyện.
• Lớp lệnh: các mục slash được bảo trì để chạy các workflow phổ biến, kèm thư mục shim tương thích ngược cho tên lệnh cũ.

Lưu ý quan trọng: Claude Code vẫn là động cơ. Nó đọc mã và chạy công cụ.

Công việc của ECC là mọi thứ xung quanh: nói cho Claude Code biết sub-agent nào xử lý tác vụ này, các bước workflow nào cần theo, stack của bạn dùng quy ước nào, và cần mang theo ngữ cảnh gì từ phiên hôm qua.

Thực tế, điều này nghĩa là bạn không còn cần cấu hình Claude Code từ đầu cho mỗi dự án. Cài ECC một lần, sao chép các gói quy tắc cho stack của bạn, và có ngay một nền tảng kỹ thuật chuyên biệt vốn đã biết cách tiến hành.

Vì Sao Everything Claude Code Trở Nên Phổ Biến

Sự tăng trưởng bắt đầu từ một chuỗi bài trên X.

Đầu năm 2026, Mustafa đăng The Shorthand Guide to Everything Claude Code. Nó đạt hơn 10K bookmark chỉ trong vài ngày. Sau đó anh ấy mở mã nguồn repo, và ECC nay đã vượt 200K sao và 34+ fork.

Đây là lý do:

• Lập trình tác tử chuyển từ thử nghiệm sang dùng hàng ngày: Khi nhiều lập trình viên bắt đầu dùng Claude Code, họ nhận thấy hạn chế của hệ thống mặc định. Thứ họ cần là một lớp cấu hình dựng sẵn loại bỏ khởi động lạnh ngữ cảnh, đầu ra review mã không nhất quán, và tương tự.
• Viết prompt tốt cho agent khó hơn tưởng: Một workflow TDD vững hay prompt cho người review mã lọc theo độ tin cậy cần nhiều vòng lặp mới đạt. Nhiều đội không muốn tự xây và bảo trì từ đầu khi mô hình thay đổi, nên dùng lại phiên bản đã được người khác kiểm nghiệm là con đường dễ hơn.
• Đóng góp tích lũy: 270+ người đóng góp đã thêm gói quy tắc ngôn ngữ (Java, Kotlin, Rust, Perl, PHP), hỗ trợ framework (Quarkus, Laravel), bản dịch, tích hợp IDE ngoài Claude Code (Cursor, OpenCode, Zed), và kỹ năng.
• ECC mang lại chuyên môn hóa mà không cần fine-tuning: Fine-tuning mô hình theo quy ước đội ngũ không thực tế với đa số đội. Một tập kỹ năng và agent có cấu trúc chạy lúc thực thi cho hiệu ứng gần tương tự, và ECC là một trong những nỗ lực đóng gói hoàn chỉnh hơn.

Vậy nên nó bắt đầu từ một chuỗi trên X, rồi biến thành hiệu ứng quả cầu tuyết.

Cách Everything Claude Code Hoạt Động

ECC là một hệ thống theo lớp.

Có năm thành phần giữa bạn và codebase của bạn. Claude Code là runtime. Kỹ năng, agent, MCP, và một lớp bộ nhớ bao quanh nó. Mỗi phần làm một việc, và chúng chuyển giao công việc cho nhau trong phiên.

Claude Code

Claude Code là giao diện mô hình nền tảng.

Đây là CLI chính thức của Anthropic để chạy Claude như một agent lập trình. Nó đọc file, ghi diff, chạy lệnh shell, gọi công cụ, và giữ cuộc trò chuyện. ECC không thay thế những điều đó. Mọi thứ ECC bổ sung đều được nạp vào Claude Code khi bắt đầu phiên và chạy qua hệ thống plugin, hook, và lệnh sẵn có của nó.

Kỹ năng (Skills)

Kỹ năng là hướng dẫn workflow có thể tái sử dụng được lưu dưới dạng tệp Markdown.

Mỗi kỹ năng là một thư mục nhỏ có SKILL.md mô tả cho Claude Code cách xử lý một loại tác vụ cụ thể. Kỹ năng nêu mô tả, các bước, đầu ra kỳ vọng, và ràng buộc. ECC có khoảng 260 kỹ năng phủ các mẫu ngôn ngữ, workflow kiểm thử, quy ước framework, kỹ thuật ML và tác vụ vận hành.

Điều cần nhớ là bạn không chạy kỹ năng thủ công. Claude Code chọn chúng dựa trên việc bạn đang làm, hoặc bạn tham chiếu trong prompt.

Agent

Agent là các sub-agent chuyên biệt mà Claude Code ủy nhiệm công việc.

Mỗi agent được định nghĩa bằng Markdown với tên, mô tả, danh sách công cụ được phép, và system prompt giới hạn phạm vi hành vi. Agent code-reviewer chỉ đọc file và báo cáo phát hiện. Agent planner viết bản thiết kế triển khai trước khi chạm vào bất kỳ dòng mã nào. Ý tưởng là vậy.

Mục đích của sự tách bạch này là cô lập ngữ cảnh. Mỗi sub-agent có một cửa sổ ngữ cảnh sạch cho tác vụ của nó, nên phiên chính không bị đầy. Agent chính điều phối và sub-agent thực thi.

Tích hợp MCP

MCP (Model Context Protocol) là cách Claude Code giao tiếp với công cụ và nguồn dữ liệu bên ngoài.

ECC có cấu hình kết nối GitHub, Supabase, Vercel, Railway, và những dịch vụ khác qua máy chủ MCP. Mỗi máy chủ phơi bày các công cụ mà Claude Code có thể gọi trong phiên. ECC chỉ đóng gói cấu hình hoạt động và quy tắc bảo mật cho chúng.

Mặc định ECC bật một connector (chrome-devtools). Mọi thứ khác là opt-in, tránh xung đột tên công cụ và giữ bề mặt tấn công nhỏ.

Lớp bộ nhớ

Lớp bộ nhớ giúp ECC có trạng thái giữa các phiên.

Các hook chạy tại sự kiện Stop của mỗi cuộc trò chuyện và ghi tóm tắt phiên vào ~/.claude/sessions/. Phiên tiếp theo nạp ngữ cảnh liên quan khi bắt đầu qua hook SessionStart. Những kỹ năng mô hình “học” từ thói quen của bạn được trích xuất vào hệ thống Continuous Learning v2, nơi chúng được lưu như bản năng (instinct) với điểm tin cậy và có thể tái sử dụng sau.

Bí danh phiên, kỹ năng đã học, và số liệu đều sống dưới một gốc dữ liệu agent duy nhất (mặc định ~/.claude, có thể cấu hình theo từng harness nếu bạn chạy ECC trong cả Claude Code và Cursor).

Cách các phần ghép lại với nhau

Một phiên điển hình trông như sau:

1. Bắt đầu phiên: Một hook nạp ngữ cảnh từ phiên trước, cùng các kỹ năng và quy tắc liên quan cho dự án hiện tại.
2. Bạn yêu cầu điều gì đó: Ví dụ, "thêm đăng nhập OAuth."
3. Agent planner chạy trước: Nó viết bản thiết kế, chưa đụng đến mã.
4. Kỹ năng TDD tham gia: Claude Code theo workflow: kiểm thử thất bại, triển khai tối thiểu, rồi refactor.
5. Công cụ MCP được gọi: Có thể GitHub MCP lấy các PR liên quan, hoặc Supabase MCP kiểm tra schema.
6. Agent code-reviewer chạy cuối: Nó kiểm toán diff trong cửa sổ ngữ cảnh riêng và báo cáo lại.
7. Kết thúc phiên: Hook Stop ghi tóm tắt, trích xuất mẫu mới thành instinct, và lưu cho lần sau.

Mô hình vẫn là Claude Code. ECC chỉ điều phối kỹ năng nào, agent nào, và công cụ nào dùng ở mỗi bước.

Kỹ Năng Trong Everything Claude Code

Kỹ năng là cách chính ECC hướng dẫn Claude Code làm gì.

Một kỹ năng là một thư mục có tệp SKILL.md. Markdown định nghĩa mô tả, bước, ràng buộc, đầu ra kỳ vọng, và ngữ cảnh áp dụng. Đó chỉ là tệp văn bản thuần mà mô hình đọc khi chạy.

Và đó là chủ đích. ECC không “huấn luyện lại” gì cả, nó nạp hướng dẫn để Claude đọc và làm theo tức thì.

Kỹ năng nằm trong thư mục skills/ ở gốc repo. Sau khi cài, chúng được sao chép vào ~/.claude/skills/. Claude Code nạp chúng như con trực tiếp của thư mục đó.

Mỗi thư mục kỹ năng có bố cục cơ bản giống nhau:

• SKILL.md - định nghĩa workflow
• Các tệp hỗ trợ tùy chọn (template, script, ví dụ)
• Tệp metadata.yaml tùy chọn để gắn thẻ và khám phá

Kỹ năng ảnh hưởng hành vi agent theo hai cách. Thứ nhất, Claude Code đọc chúng khi bắt đầu phiên và giữ sẵn để tham chiếu. Thứ hai, mô hình chọn kỹ năng phù hợp dựa trên yêu cầu của bạn. Nếu bạn nói "viết kiểm thử thất bại trước", kỹ năng TDD sẽ kích hoạt. Nếu bạn nói "review phần này để tìm SQL injection", kỹ năng review bảo mật sẽ kích hoạt.

ECC đi kèm khoảng 260 kỹ năng. Dưới đây là vài kỹ năng minh họa phạm vi:

• frontend-patterns: Quy ước React và Next.js. Cấu trúc component, cách dùng hook, quyết định component máy chủ vs. phía client, mẫu quản lý trạng thái.

• django-patterns, django-tdd, django-security, django-verification: Một stack Django đầy đủ tách thành bốn kỹ năng. Một cho kiến trúc, một cho chu trình kiểm thử, một cho audit kiểu OWASP, một cho vòng xác minh trước khi phát hành.

• architect (đi kèm agent architect): Review thiết kế hệ thống. Kỹ năng định nghĩa một review kiến trúc bao gồm gì, tạo ra hiện vật gì, và nêu bật những đánh đổi nào.

• tdd-workflow: Vòng lặp đỏ-xanh-refactor. Viết kiểm thử thất bại, viết mã tối thiểu để qua, refactor, xác minh coverage. Kỹ năng bắt buộc thứ tự này.

• security-review: Checklist audit OWASP Top 10, phát hiện credential hardcode, review kiểm tra đầu vào, và kiểm tra lỗ hổng phụ thuộc. Kỹ năng định nghĩa cần quét gì và gắn cờ gì.

Agent Trong Everything Claude Code

Agent là các persona chuyên biệt với cửa sổ ngữ cảnh riêng.

Mỗi agent là một tệp Markdown trong thư mục agents/ với tên, mô tả, danh sách công cụ được phép, và system prompt. System prompt định nghĩa công việc của agent. Danh sách công cụ kiểm soát nó có thể làm gì (đọc file, chạy bash, gọi máy chủ MCP, ghi mã). Claude Code tự động ủy nhiệm tác vụ cho agent.

ECC có 66 agent. Có thể nhóm thành vài loại.

Agent lập kế hoạch chạy trước khi viết mã.

Agent planner chia nhỏ yêu cầu tính năng thành bản thiết kế triển khai: file cần đổi, interface cần định nghĩa, kiểm thử cần viết, và edge case cần xử lý. Agent architect đi ở mức cao hơn: thiết kế hệ thống, quyết định mô hình dữ liệu, ranh giới dịch vụ. Các agent này chỉ đọc mã và viết kế hoạch.

Agent mã hóa thực hiện việc triển khai.

Agent tdd-guide buộc vòng kiểm thử trước. Các trình xử lý lỗi build theo ngôn ngữ như go-build-resolver, pytorch-build-resolver, và kotlin-build-resolver sửa lỗi build trong hệ sinh thái tương ứng. refactor-cleaner xóa mã không dùng.

Agent kiến trúc review quyết định cấu trúc.

Agent architect bao quát thiết kế, database-reviewer bao quát mẫu truy vấn và lựa chọn schema, và mle-reviewer kiểm toán pipeline ML sản xuất (hợp đồng dữ liệu, coverage đánh giá, phục vụ, giám sát).

Agent QA xác minh những gì đã được xây.

Agent code-reviewer kiểm toán diff về chất lượng và bảo mật với ngưỡng độ tin cậy. security-reviewer chạy một lượt theo kiểu OWASP. e2e-runner xử lý kiểm thử end-to-end bằng Playwright. Reviewer theo ngôn ngữ (typescript-reviewer, python-reviewer, go-reviewer, rust-reviewer, và khác) xử lý kiểm tra theo ngôn ngữ.

Lý do tách nhỏ thành các agent riêng là để cô lập ngữ cảnh.

Khi code-reviewer chạy, nó có một cửa sổ ngữ cảnh mới chỉ với diff và kỹ năng review được nạp. Nó không thấy ghi chú lập kế hoạch hay lịch sử trò chuyện. Nó chỉ review. Sự tập trung đó tạo ra đầu ra tốt hơn so với việc yêu cầu một agent tổng quát vừa lập kế hoạch, vừa viết mã, vừa kiểm thử, vừa review trong cùng một ngữ cảnh, điều mà hầu hết cấu hình Claude Code ad-hoc thường làm.

Quản Lý Ngữ Cảnh Và Bộ Nhớ Trong ECC

ECC không quên mọi thứ giữa các phiên như Claude Code thường làm.

Bộ nhớ trong ECC là hệ thống hook ghi file vào đúng thời điểm và nạp lại vào đúng thời điểm. Chúng chỉ là tệp Markdown và JSON nằm trên đĩa.

Ba thứ được duy trì:

1. Tóm tắt phiên được ghi khi phiên kết thúc: Hook Stop chạy sau tin nhắn cuối, lấy toàn bộ transcript, và ghi tóm tắt vào ~/.claude/sessions/. Tóm tắt đề cập đã làm gì, đã quyết gì, còn gì dang dở. Phiên tiếp theo đọc nó trong hook SessionStart để Claude biết dở dang ở đâu.
2. Instinct là các mẫu trích xuất từ phiên của bạn: Hệ thống Continuous Learning v2 theo dõi bạn làm gì và điều gì hiệu quả, rồi ghi từng instinct với điểm tin cậy, hành động, bằng chứng hỗ trợ, và ví dụ. Chạy /instinct-status để xem đã học gì. Chạy /evolve để gom nhóm các instinct liên quan thành kỹ năng mới.
3. Tệp log theo dõi lớp vận hành: Như thực thi hook, chạy kỹ năng, gọi MCP, chi phí, lỗi. Chúng nằm ở ~/.claude/metrics/ và ~/.claude/session-data/. Hữu ích để debug và cho giao diện dashboard đi kèm repo.

Nếu bạn nghĩ điều này không quan trọng, đây là vài lý do sẽ khiến bạn đổi ý:

• Dự án dài hạn: Một đợt refactor sáu tháng không “reset” mỗi thứ Hai. Quyết định, đánh đổi, và vấn đề đã biết tuần trước có trong tóm tắt được nạp khi bắt đầu phiên.
• Không phải giải thích lặp lại: Bạn không phải dán lại stack, quy ước, hay “nhớ là chúng ta đã quyết dùng Postgres, không phải Oracle” mỗi lần.
• Vượt giới hạn cửa sổ ngữ cảnh: Dù có cửa sổ một triệu token, bạn không thể nhét lịch sử sáu tháng. Tóm tắt nén điều quan trọng. Lịch sử đầy đủ nằm trên đĩa, mô hình nhận phần liên quan.

Bạn có thể tinh chỉnh ngữ cảnh nạp bằng biến môi trường. ECC_SESSION_START_MAX_CHARS giới hạn số ký tự tóm tắt nạp lúc đầu (mặc định 8.000). ECC_SESSION_START_CONTEXT=off tắt cho thiết lập ít ngữ cảnh. ECC_SESSION_RETENTION_DAYS kiểm soát thời gian lưu phiên trước khi dọn dẹp.

Nếu bạn chạy ECC trong cả Claude Code và Cursor trên cùng máy, hãy đặt ECC_AGENT_DATA_HOME để tách bộ nhớ của chúng. Nếu không, chúng sẽ ghi đè file phiên của nhau.

Hỗ Trợ MCP Trong Everything Claude Code

MCP là cách Claude Code gọi mọi thứ không phải file hay lệnh shell.

Model Context Protocol là tiêu chuẩn của Anthropic để kết nối mô hình ngôn ngữ với công cụ bên ngoài. Một máy chủ MCP chạy như tiến trình riêng và phơi bày tập thao tác có kiểu: “đọc trang Notion này” hoặc “mở PR trên GitHub.” Claude Code gọi các thao tác đó như gọi hàm.

ECC đi kèm cấu hình MCP trong mcp-configs/mcp-servers.json cho các dịch vụ phổ biến: GitHub, Supabase, Vercel, Railway, Linear, và khác. Mỗi mục gồm lệnh khởi động máy chủ, biến môi trường cần thiết, và quy tắc bảo mật ECC áp dụng.

Đáng chú ý là ECC không tự bật chúng.

Chính sách connector MCP tháng 6/2026 giảm các máy chủ bật mặc định còn một (chrome-devtools). Mọi thứ khác là opt-in. Bạn hoặc sao chép mục vào .mcp.json của dự án, hoặc bật qua lệnh /mcp của Claude Code. Lý do một phần mang tính thực tế (tên công cụ MCP dài làm hỏng một số gateway) và một phần là lựa chọn bảo mật (mỗi máy chủ MCP là một bề mặt tấn công tiềm tàng).

Hỗ trợ này thực tế trông như sau:

• Tích hợp bên ngoài: Thả mục GitHub vào .mcp.json, cung cấp token, và Claude Code có thể đọc issue, mở PR, và kiểm tra trạng thái CI mà không cần bạn copy-paste.
• Gọi công cụ: Kỹ năng và agent tham chiếu công cụ MCP theo tên. Ví dụ, một kỹ năng triển khai có thể gọi Vercel MCP, và agent review cơ sở dữ liệu có thể gọi Supabase MCP.
• Tự động hóa dự án: Bạn có thể kết hợp máy chủ MCP với hook để có tự động hóa bền vững qua các phiên. Một hook mở PR có thể khởi chạy agent review dùng GitHub MCP để lấy diff và Linear MCP để cập nhật ticket.

Nếu bạn đã chạy bản riêng của bất kỳ MCP nào ECC đóng gói, đặt ECC_DISABLED_MCPS thành danh sách phân tách bằng dấu phẩy. ECC sẽ bỏ qua chúng trong quá trình cài và đồng bộ, để tránh trùng lặp tranh nhau cùng tên máy chủ.

AgentShield Và Tính Năng Bảo Mật

Bảo mật là điểm khiến ECC khác biệt so với phần còn lại.

AgentShield là trình kiểm toán bảo mật độc lập đi kèm ECC. Nó quét cấu hình Claude Code để tìm lỗ hổng, cấu hình sai, lỗi, và rủi ro injection. Nó chạy như một gói npm riêng (ecc-agentshield), nhưng kết nối với ECC qua kỹ năng /security-scan để bạn có thể chạy ngay trong phiên Claude Code.

Bản quét bao phủ năm hạng mục:

• Phát hiện bí mật: 14 mẫu cho credential hardcode, API key, token.
• Kiểm toán quyền hạn: công cụ và đường dẫn mà mỗi agent và kỹ năng có thể truy cập, và liệu các quyền cấp có quá rộng hay không.
• Phân tích hook injection: liệu hook có thể bị lợi dụng để chạy lệnh tùy ý hay không.
• Hồ sơ rủi ro máy chủ MCP: mỗi máy chủ MCP kết nối có thể đọc, ghi, hay gọi gì, và đâu là điểm phơi bày.
• Review cấu hình agent: vector prompt injection, danh sách công cụ cấp quyền quá mức, thiếu ràng buộc.

Bạn có thể chạy bằng lệnh sau, không cần cài đặt:

npx ecc-agentshield scan

Đầu ra là điểm chữ (A đến F) kèm danh sách phát hiện, sắp theo mức độ nghiêm trọng. Phát hiện nghiêm trọng thoát với mã 2.

Dưới đây là vài cờ đáng biết:

• -fix áp dụng sửa tự động cho vấn đề an toàn (gỡ bí mật bị lộ, siết quyền quá rộng…)
• -opus chạy bản quét qua ba agent Claude Opus 4.X trong pipeline red-team / blue-team / auditor. Kẻ tấn công cố tìm chuỗi khai thác. Người phòng thủ đánh giá biện pháp bảo vệ. Kiểm toán viên tổng hợp thành báo cáo rủi ro ưu tiên.
• -stream truyền trực tiếp phân tích, hữu ích với cấu hình chậm.

Cách tiếp cận pipeline Opus là phần khiến AgentShield khác một trình linter thông thường. Các agent đối kháng cố xâu chuỗi các thành phần vốn “ổn” thành thứ có thể khai thác, là nguồn gốc của nhiều cuộc tấn công agent thực tế.

AgentShield báo cáo 102 quy tắc phân tích tĩnh và 1.282 kiểm thử nội bộ với coverage 98%, theo repo. Các con số đáng để xác minh với bản phát hành mới nhất, nhưng rõ ràng đây không phải script 50 dòng.

Định dạng đầu ra gồm terminal (đánh màu), JSON (cho CI), Markdown, và HTML. Cũng có GitHub Action và một ứng dụng GitHub riêng ECC Tools chạy AgentShield trên PR.

Với đa số đội dùng Claude Code trong môi trường sản xuất, AgentShield là lý do cụ thể nhất để cài ECC ngay cả khi bạn không dùng phần còn lại của khung.

Cài Đặt Everything Claude Code

ECC có hai đường cài đặt.

Thiết lập lỗi thường gặp nhất là chồng cài plugin lên cài thủ công. Cả hai đều sao chép cùng file vào cùng chỗ, dẫn đến trùng lặp. Vậy nên trước hết: chỉ chọn một cách.

Trước khi cài, đảm bảo bạn đã cài Claude Code v2.1.0 hoặc mới hơn:

claude --version

Phiên bản Claude

Cài đặt qua trình quản lý plugin

Đây là cách khuyến nghị cho đa số người dùng.

Từ trong Claude Code, chạy:

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

Cài đặt plugin

Lệnh đầu đăng ký repo ECC làm marketplace. Lệnh thứ hai cài plugin.

Một lưu ý là hệ thống plugin không phân phối quy tắc. Quy tắc là các hướng dẫn luôn tuân theo (phong cách mã, quy trình git, tiêu chuẩn kiểm thử, mẫu theo ngôn ngữ), và đặc tả plugin của Claude Code không đi kèm chúng. Bạn sao chép thủ công sau khi cài plugin.

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/python ~/.claude/rules/ecc/

Sao chép rules/common cộng một gói ngôn ngữ bạn thực sự dùng. Trong ví dụ trên, tôi đã sao chép quy tắc Python. Đừng sao chép tất cả, vì nhiều quy tắc đồng nghĩa nhiều ngữ cảnh hơn được nạp vào mỗi phiên, và phần lớn sẽ không áp dụng cho dự án của bạn.

Cài đặt qua tệp cấu hình

Dùng cách này nếu bạn muốn toàn quyền kiểm soát, hoặc nếu cài plugin không chạy trên thiết lập của bạn.

git clone https://github.com/affaan-m/ECC.git
cd ECC
npm install
./install.sh --profile full

Trên Windows:

.\install.ps1 --profile full
# or
npx ecc-install --profile full

Cách này sao chép agent, kỹ năng, lệnh, hook, và quy tắc vào thư mục ~/.claude/ của bạn. Không có lớp plugin. Mọi thứ sống như file trên đĩa mà Claude Code đọc khi bắt đầu phiên.

Một vài lựa chọn profile đáng biết:

• -profile minimal: Chỉ quy tắc, agent, lệnh, và kỹ năng lõi, không có hook.

• -profile core: Tập mặc định dùng được. Có hook.

• -profile full: Toàn bộ repo.

Bạn cũng có thể cài thành phần cụ thể với --modules hoặc --with:

./install.sh --target claude --modules hooks-runtime
npx ecc install --profile minimal --target claude --with capability:machine-learning

Nếu bạn không chắc thành phần nào phù hợp công việc, hãy hỏi trình tư vấn đi kèm:

npx ecc consult "security reviews" --target claude

Nó trả về các thành phần phù hợp và lệnh cài chi tiết.

Xác minh cài đặt

Kiểm tra những gì đã được cài:

/plugin list ecc@ecc

Xác minh cài đặt plugin

Màn hình đó hiển thị agent, lệnh, và kỹ năng có sẵn từ plugin. Với cài thủ công, dùng trình bao bọc vòng đời:

node scripts/ecc.js list-installed
node scripts/ecc.js doctor

doctor kiểm tra file thiếu, hook hỏng, và lệch phiên bản. Nếu có cờ cảnh báo, chạy:

node scripts/ecc.js repair

Để xác nhận Claude Code nhận plugin mới, mở một phiên và thử lệnh slash:

/ecc:plan "Add user authentication"

Kết quả lập kế hoạch của ECC

Với cài plugin, cần tiền tố /ecc:. Với cài thủ công, dạng rút gọn (/plan) hoạt động.

Nếu thấy trùng lặp hay hỏng, đừng cài đè. Chạy node scripts/uninstall.js --dry-run trước để xem sẽ xóa gì, rồi node scripts/uninstall.js để dọn sạch. ECC chỉ gỡ file do nó cài, nên cấu hình không liên quan vẫn nguyên vẹn.

Làm Việc Với Kỹ Năng, Lệnh, Và Workflow

Phần lớn những gì bạn làm trong ECC chạy qua kỹ năng thay vì lệnh.

Lý do là thư mục commands/ vẫn được duy trì để tương thích ngược, nhưng phát triển workflow mới diễn ra ở skills/ trước tiên.

Dưới đây là vài mẫu sử dụng bao phủ phần lớn công việc hằng ngày của bạn.

Gọi kỹ năng chủ yếu là ngầm định

Bạn thường không gọi kỹ năng theo tên. Bạn mô tả điều bạn muốn, và Claude Code chọn kỹ năng phù hợp. Nếu bạn nói "viết kiểm thử thất bại trước", kỹ năng tdd-workflow sẽ kích hoạt. Tên kỹ năng xuất hiện trong phản hồi để bạn thấy cái gì đã được nạp.

Khi muốn rõ ràng, hãy tham chiếu kỹ năng trong prompt: "Dùng kỹ năng django-tdd để thêm endpoint mới." Hoặc chạy lệnh bao bọc:

/code-review
/security-scan

/ecc:plan "Add OAuth login"

Tiền tố /ecc: là bắt buộc với cài plugin. Cài thủ công dùng dạng rút gọn (/plan, /code-review).

Kết quả giai đoạn lập kế hoạch của ECC

Chỉ định tệp là một phần của workflow

Phần lớn agent và kỹ năng làm việc trên một phạm vi cụ thể: một tệp, thư mục, diff, PR. Bạn giới hạn phạm vi bằng cách nhắc đến tệp trong prompt, mở nó trong editor trước khi gọi, hoặc trỏ agent vào đường dẫn:

/code-review src/auth/
/python-review services/billing/payment.py

Agent nắm phạm vi, chỉ nạp những tệp cần thiết, và chạy trong cửa sổ ngữ cảnh riêng.

Tích hợp shell chạy qua công cụ bash của Claude Code

Kỹ năng có thể gọi shell cho bất kỳ thứ gì cần thực thi thực tế, như chạy kiểm thử, build, lint, hay gọi CLI. Kỹ năng TDD chạy pytest hoặc go test. Agent sửa lỗi build chạy build thực để thấy lỗi thực. Kỹ năng security-scan chạy npx ecc-agentshield scan và phân tích đầu ra.

Kỹ năng định nghĩa lệnh shell nào chạy và khi nào. Hook cũng có thể chạy lệnh shell theo sự kiện công cụ (chạy kiểm tra kiểu sau mỗi lần sửa, cảnh báo về console.log trước khi lưu).

Quản lý MCP chủ yếu là opt-in

Sau khi cài, ECC chỉ bật đúng một máy chủ MCP mặc định (chrome-devtools). Để thêm, sao chép mục từ mcp-configs/mcp-servers.json vào .mcp.json của dự án, rồi bật qua lệnh /mcp của Claude Code. Giao diện /mcp xử lý bật, tắt, và xác thực lại.

Nếu bạn tự chạy bản máy chủ MCP mà ECC đóng gói, hãy đặt:

export ECC_DISABLED_MCPS="github,supabase"

Trình cài và luồng đồng bộ của ECC sẽ bỏ qua chúng, tránh việc hai máy chủ giống nhau tranh chấp tên công cụ.

Workflow xâu chuỗi với nhau

Bạn không chạy kỹ năng từng cái một. Một workflow tính năng điển hình trông như:

/ecc:plan "Add OAuth login with Google"
# planner agent writes a blueprint

# tdd-workflow skill activates as you implement
# tests fail, code gets written, tests pass

/code-review
# code-reviewer agent audits the diff

/security-scan
# AgentShield checks the new code and config

Mỗi bước dùng một agent khác nhau trong cửa sổ ngữ cảnh mới. Phiên chính điều phối, và tóm tắt phiên ghi lại chuỗi ở cuối và cung cấp cho phiên tiếp theo.

Everything Claude Code so với Các Khung Cấu Hình Đối Thủ

ECC không phải lớp cấu hình duy nhất cho Claude Code. Vài lựa chọn khác làm việc tương tự với đánh đổi khác nhau.

Cần rõ ràng về phân loại. ECC cạnh tranh với các khung cấu hình chạy trên Claude Code. Nó không cạnh tranh với các harness chạy song song (Cursor, Codex, OpenCode, Zed) hay nền tảng agent độc lập (OpenHands, LangGraph, CrewAI), vốn là nhóm công cụ khác.

Ba đối thủ thường được nhắc đến.

BMAD-Method là một khung SDLC agile với agent theo vai trò chuyên môn (Analyst, PM, Architect, Scrum Master, Developer, QA). Nó chạy trên Claude Code, Cursor, và Windsurf qua npx bmad-method install. Nó mạnh ở giai đoạn lên kế hoạch ban đầu, biến ý tưởng mơ hồ thành PRD, tài liệu kiến trúc, và story đã phân rã trước khi viết mã. Công cụ thực thi nhẹ hơn ECC. Không có trình quét bảo mật và không có danh mục MCP. Ít mẫu theo ngôn ngữ hơn.

SuperClaude là khung cấu hình gọn nhẹ dựa trên Markdown. Khoảng 30 lệnh slash, 20 agent, và vài chế độ hành vi. Cài bằng pip install SuperClaude. Nó đơn giản hơn ECC theo thiết kế, không có quét bảo mật và không có runtime điều phối. Nhưng cũng không có lớp bộ nhớ tích hợp ngoài những gì Claude Code cung cấp. Nếu bạn muốn một CLAUDE.md hoạt động tốt kèm tập prompt được kiểm nghiệm, SuperClaude là lựa chọn hay.

claude-flow / Ruflo (đổi tên từ Claude Flow đầu 2026) là bộ điều phối swarm đa agent. Nó dùng phương pháp SPARC (specification, pseudocode, architecture, refinement, completion) và chạy các hệ phân cấp do “queen” dẫn dắt gồm 60-100+ agent chuyên biệt song song. Có bộ nhớ bền vững qua AgentDB và hoạt động trên Claude, GPT, Gemini, và Ollama. Hạ tầng nặng hơn ECC, và được xây cho công việc đa agent song song hơn là năng suất một phiên.

Nếu bạn muốn duyệt thêm trước khi quyết định, awesome-claude-code là danh mục chọn lọc tài nguyên Claude Code (agent, kỹ năng, plugin, máy chủ MCP, cấu hình). Đây là nơi cộng đồng khám phá nhiều nhất.

Tóm lại, chọn BMAD nếu bạn muốn lập kế hoạch kiểu agile, SuperClaude nếu bạn muốn lớp cấu hình gọn nhẹ, Ruflo nếu bạn cần công việc đa agent song song, và ECC nếu bạn muốn nền tảng kỹ thuật hoàn chỉnh với công cụ bảo mật và bộ nhớ bền vững tích hợp.

Ai Nên Dùng Everything Claude Code?

ECC không dành cho tất cả. Nếu bạn chỉ dùng Claude Code vài lần mỗi tuần cho tác vụ nhỏ, khung sẽ có vẻ nặng nề so với lợi ích. Một tệp CLAUDE.md 100 dòng là đủ với hầu hết nhu cầu.

ECC phát huy hiệu quả khi bạn đi xa hơn mức đó.

Các kịch bản phù hợp với ECC hơn so với Claude Code thuần:

• Kỹ sư AI xây hệ thống agent: Nếu bạn thiết kế hay triển khai workflow agent, ECC là tài liệu tham chiếu thực tiễn. Đọc prompt agent, định nghĩa kỹ năng, cấu hình hook, và mượn những gì hiệu quả.
• Người đam mê năng suất phát triển: Nếu bạn đầu tư vào công cụ, dotfiles, thiết lập editor, shell, thì ECC là khoản đầu tư tương tự cho Claude Code. Bạn sẽ tận dụng tốt nhất nếu dùng thường xuyên.
• Đội ngũ chạy Claude Code như hạ tầng hàng ngày: Nếu đội dùng Claude Code để review mã, lập kế hoạch, refactor, hay giao tính năng mỗi ngày, thời gian tiết kiệm nhờ tính nhất quán và onboarding sẽ cộng dồn. Thành viên mới có cùng agent và workflow.
• Bất kỳ ai xây workflow agent phức tạp: Pipeline nhiều bước, điều phối sub-agent, xâu chuỗi MCP, ngữ cảnh bền vững, v.v. ECC đã giải phần lớn các vấn đề này, và mẫu có thể tái sử dụng ngay cả khi bạn không cài toàn bộ.

Những ai không nên dùng ECC:

• Người dùng Claude Code không thường xuyên: Vài phiên mỗi tuần kiểu “giúp tôi debug script này” không cần 60+ agent, 260+ kỹ năng, và lớp bộ nhớ. Công sức thiết lập không đáng.
• Tác vụ mã hóa đơn giản, một lần: Script nhanh, sửa nhỏ, app demo, prototype dùng rồi bỏ. Claude Code thuần xử lý tốt, thêm ECC chỉ tăng ma sát mà ít giá trị.
• Những đội đã có thiết lập ổn: Nếu CLAUDE.md của bạn đã tối ưu và workflow ổn định, chuyển sang ECC đòi hỏi thời gian chuyển đổi. Hãy mượn phần bạn thích, để phần còn lại.

Nếu chưa chắc, lựa chọn an toàn là đọc repo, sao chép hai-ba agent và kỹ năng bạn thấy hay, và tạm bỏ qua cài đặt đầy đủ.

Ưu Và Nhược Điểm Của ECC

Tôi sẽ điểm qua vài điểm mạnh và yếu của ECC. Cả hai đều đáng biết trước khi quyết định.

Ưu điểm

• Thư viện kỹ năng đồ sộ: Khoảng 260 kỹ năng bao phủ TDD, audit bảo mật, mẫu framework, ngôn ngữ, kỹ thuật ML, triển khai, và hơn nữa. Dù bạn không cài gì, repo vẫn là tham chiếu thực tiễn cách viết định nghĩa kỹ năng tốt.
• Tái sử dụng workflow: Bạn có prompt đã thử nghiệm cho review mã, lập kế hoạch, refactor, và kiểm thử. Agent code-reviewer đặc biệt được trích dẫn bởi những người không dùng ECC nhưng mượn prompt.
• Bộ nhớ bền vững: Những thứ như tóm tắt phiên và ngữ cảnh xuyên phiên hoạt động ngay. Đa số cấu hình Claude Code khác không đề cập bộ nhớ.
• Hỗ trợ MCP mạnh: Cấu hình dựng sẵn cho GitHub, Supabase, Vercel, Railway, và khác.
• AgentShield: Trình quét bảo mật một mình đã đủ lý do cài ECC dù bạn không dùng phần khác. Chỉ ít cấu hình Claude Code khác có thứ tương đương.
• Mã nguồn mở dưới MIT: Không có paywall cho phần lõi. Ứng dụng GitHub được host và tầng ECC Pro là riêng.
• Đa nền tảng: Hoạt động với Claude Code, Cursor, Codex, OpenCode, Zed, Gemini, và khác. Nếu bạn chuyển hoặc chạy nhiều công cụ, vẫn dùng cùng agent và kỹ năng.

Hạn chế

• Đường cong học tập: 60+ agent, 260+ kỹ năng, ba đường cài, bốn loại profile, và một đống biến môi trường. Tuần đầu chủ yếu là tìm hiểu cái gì đang được nạp và mỗi thành phần làm gì.
• Độ phức tạp thiết lập: Cài plugin vs. thủ công, vấn đề quy tắc-không-phân-phối-qua-plugin, vấn đề hook trùng ở phiên bản Claude Code cũ, luồng bật/tắt MCP, biến gốc dữ liệu agent cho dùng đa harness. Hầu hết có tài liệu, nhưng vẫn nhiều việc.
• Chi phí bảo trì: Repo cập nhật thường xuyên. Số lượng trong danh mục thay đổi giữa các bản phát hành và tên kỹ năng thay đổi.
• Phụ thuộc hệ sinh thái Claude Code: ECC phụ thuộc đặc tả plugin, hệ thống hook, và hỗ trợ MCP của Claude Code. Khi Claude Code thay đổi, ECC phải theo.
• Quá mức cần thiết cho nhiều trường hợp: Với đa số đội, một CLAUDE.md viết tốt 60-200 dòng bao phủ 80% những gì ECC mang lại. 20% còn lại giá trị, nhưng chỉ khi bạn dùng.

Khung này là lớp cấu hình Claude Code hoàn chỉnh nhất hiện tại. Nhưng “hoàn chỉnh nhất” không đồng nghĩa “cần thiết cho mọi người”.

Kết Luận

Nếu bạn dùng Claude Code hàng ngày, ECC đáng để xem. Nếu không, repo vẫn đáng đọc như tài liệu tham chiếu cách xây workflow agent vận hành vững trong thực tế.

Dù thế nào, ECC cho thấy phát triển phần mềm đang dịch chuyển tới các pipeline agent có thể lập trình thay vì phiên chat đơn lẻ. Các khung để làm tốt điều này vẫn còn mới, và ECC là một trong những nỗ lực hoàn chỉnh nhất cho đến nay. Nó sẽ không phải cái cuối cùng, và đó mới là điều quan trọng.

Nếu bạn mới với AI tạo sinh và lập trình tác tử, hãy đăng ký khóa học Generative AI Concepts của chúng tôi. Khóa học sẽ cho bạn nền tảng vững chắc cho tương lai.