TL;DR

Everything Claude Code (ECC) là layer tối ưu hiệu suất cho AI agent harness - không chỉ là bộ config. Được tạo bởi Affaan Mustafa sau khi chiến thắng Anthropic hackathon, ECC open-source tháng 1/2026 và tăng lên 186K+ stars chỉ trong 5 tháng. Phiên bản mới nhất v2.0.0-rc.1 (April 28, 2026) bao gồm 60 agent, 231 skill, AgentShield security scanner với 1.282 test, và Rust-based control plane alpha. Cài đặt bằng một lệnh npm, hỗ trợ Claude Code, Cursor, Codex, OpenCode và GitHub Copilot.

Vấn đề Claude Code mặc định không giải quyết được

Claude Code rất mạnh, nhưng ai dùng lâu đều gặp ba vấn đề chung:

  • Mất bộ nhớ giữa các session - mỗi lần mở session mới là một tờ giấy trắng. Không nhớ convention của project, không nhớ lỗi đã xảy ra, không nhớ kiến trúc bạn đang xây.
  • Không có bảo mật tích hợp - không có cơ chế nào tự động phát hiện API key bị expose trong config, hook injection, hay MCP server có vấn đề.
  • Chi phí token khó kiểm soát - khi dùng nhiều MCP server, 200K context window của Claude Code có thể tụt xuống còn ~70K token thực tế. Session dài = bill cao.

ECC giải quyết cả ba cùng lúc, thông qua một hệ thống agent - skill - hook được thiết kế kỹ lưỡng và kiểm thử nghiêm túc.

Cơ chế hoạt động: 4 layer chồng nhau

ECC agent harness architecture: 60 agents, 231 skills, AgentShield, continuous learning

ECC xây dựng trên 4 layer:

  1. Agent layer - 60 subagent chuyên biệt theo từng vai trò: Planner, Architect, TDD Guide, Code Reviewer, Security Reviewer, ngôn ngữ cụ thể (TypeScript, Python, Go, Java, Kotlin, Rust, C++...). Orchestrator agent nhận task lớn, phân rã và dispatch sang specialized agent. Không cần manual context switch.
  2. Skill layer - 231 skill là domain knowledge nạp theo yêu cầu (on-demand), không load ngay vào context. Backend patterns, frontend React/Next.js, DevOps, ML/PyTorch, các framework phổ biến. Rules thì luôn load (~5-8K tokens), skill thì chỉ load khi cần.
  3. Hook layer - 20+ automation hook chạy tại PreToolUse, PostToolUse, SessionStart, SessionEnd, Stop. Tự động format code, check TypeScript, phát hiện secret trong prompt, block đọc file .env, lưu session state.
  4. Learning layer - Continuous Learning v2 quan sát từng tool call qua PreToolUse/PostToolUse hook, trích xuất pattern thành "instinct" với confidence score từ 0.3 đến 0.9. Score tăng khi instinct hữu ích, giảm và tự prune sau 30 ngày nếu không còn liên quan. Dùng /evolve để cluster 3+ instinct liên quan thành một skill có thể tái sử dụng.

AgentShield: bảo mật tích hợp cho AI agent

AgentShield là security scanner được xây tại Claude Code Hackathon (Cerebral Valley x Anthropic, Feb 2026). Pipeline hoạt động theo mô hình 3 agent đối kháng chạy trên Opus 4.6:

  • Red Team - tìm attack vector và multi-step chain có thể khai thác
  • Blue Team - đánh giá các guardrail hiện tại và đề xuất hardening
  • Auditor - tổng hợp cả hai phía thành báo cáo ưu tiên theo rủi ro

102 static analysis rule chia theo 5 category: Secrets (10 rules, 14 pattern), Permissions (10 rules), Hooks (34 rules), MCP Servers (23 rules), Agent Config (25 rules). Test suite 1.282 test với 98% code coverage. Kết quả xuất dạng score A-F / 0-100:

npx ecc-agentshield audit ./CLAUDE.md

Lý do tính năng này quan trọng: tháng 1/2026, khoảng 12% skill trên một marketplace AI agent lớn chứa nội dung độc hại. AgentShield phát hiện sớm trước khi lỗi lên production.

Tối ưu token: giảm 60% chi phí API

ECC ship sẵn cấu hình token optimization mà tác giả đã battle-test qua nhiều production app:

SettingMặc địnhECC khuyến nghịTác động
modelopussonnet~60% giảm chi phí; xử lý 80%+ task lập trình
MAX_THINKING_TOKENS31.99910.000~70% giảm hidden thinking cost mỗi request
CLAUDE_AUTOCOMPACT_PCT_OVERRIDE95%50%Compact sớm hơn - context chất lượng hơn trong session dài

Ngoài ra, ECC giới hạn cứng: không enable quá 10 MCP mỗi project, không quá 80 tool active. Mỗi MCP tool description tốn 2-5K tokens - enable 20 MCP không cần thiết có thể khiến 200K window thực tế còn 70K.

So sánh: ECC hoạt động ra sao trên từng tool

Điểm khác biệt lớn nhất của ECC là không lock-in vào Claude Code. Cùng một bộ agent và rule chạy được trên nhiều harness:

ToolAgentsSkillsHook Events
Claude Code602318 types
Cursor IDESharedShared15-20 types
OpenCode123711 types
Codex CLIShared10Không có
GitHub CopilotN/AVia instructionsKhông có

Cursor dùng DRY adapter pattern để tái sử dụng hook script của Claude Code mà không duplicate code. Team có backend dev dùng Claude Code và frontend dev dùng Cursor - ECC trở thành config source duy nhất, loại bỏ configuration drift giữa hai môi trường.

Cài đặt và giá

OSS core hoàn toàn miễn phí, MIT license, không giới hạn:

# Cài qua npm (cách nhanh nhất)
npx ecc-install

# Hoặc package toàn bộ
npm install -g ecc-universal

ECC Tools GitHub App (layer tự động hóa thêm) có phí:

  • Free - Public repo, 10 analyses/tháng, 200 commits/run
  • Pro - $19/seat/tháng - private repo, AgentShield scanning, 50 analyses/tháng
  • Enterprise - Liên hệ - SSO, audit logs, custom rule packs, unlimited analyses

Lưu ý thực tế: multi-agent mode tốn nhiều API call hơn (mỗi agent = 1 call riêng). Dùng /plan cho task cần multi-agent, dùng Claude Code thông thường cho task đơn giản.

Kết: cấu hình agent như một bài toán kỹ thuật thực thụ

186K stars trong 5 tháng không phải do hype ngắn hạn. ECC đang lấp đầy một khoảng trống thực sự: phần lớn AI coding tool ship dưới dạng hộp đen, developer không có cơ chế tốt để version control hành vi agent, audit security, hay chia sẻ config nhất quán giữa các tool và teammate.

ECC đặt bài toán này ở tầm kỹ thuật nghiêm túc - versioned, testable, cross-platform. Cho team đang dùng Claude Code hoặc Cursor hàng ngày, đây là thứ đáng bỏ một buổi chiều để đánh giá trước khi tự viết lại từ đầu.

via GitHub - affaan-m/everything-claude-code · ecc.tools · AgentShield