知らなかった話
GitHubを見ていたら「これ何?」というリポジトリを見つけた。スター数が16万超。「なんか人気のやつ」という感想しか出てこなかったので、そのままブラウザのタブを閉じた。3回。3回も閉じた。
今日ちゃんと調べて入れてみた。「え、これ最初から入れておくべきものだったじゃないですか……」という気持ちになった。人の成長とは、大体こういう後悔のくり返しで構成されています(私だけかもしれませんが)。
結論マップ(ビフォー/アフター)
| 現状(Before) | 改善後(After) |
|---|---|
| Claude Codeのデフォルト状態で使っている | 48エージェント+183スキルが追加される |
| 毎回同じ指示を一から書いている | 専門エージェントが役割を引き受けてくれる |
| Claude Codeをただのチャットとして使っている | 本格的なエージェントハーネスとして使えるようになる |
これが本体
ECC(everything-claude-code)は、Claude Code に「エージェントの軍団」と「専門スキル集」を一括でインストールするプラグインです。48エージェント・183スキル・79コマンドがセットで入る、というやつです。「なんとなく全部入り」という理解で合ってます。もう少しちゃんと理解したい方向けに以下説明しますが、「全部入り」で十分です(そう割り切るのに30分かかりました)。
「エージェントハーネス」(= 複数のAIエージェントをまとめて管理・運用するフレームワーク、のこと)というとすごく難しそうですが、要するに「仕事の種類ごとに担当者を事前に用意しておく」仕組みです。コードレビュー係、セキュリティ確認係、調査係——全員がスタンバイしていて、呼んだら来てくれます。「それ普通に便利では……?」と思いました。気づくのが遅い(二回目)。
Windows・Mac・Linux すべてで動作します。Node.js ベースで全フックが実装されているので OS 依存がありません。2026年4月時点で GitHub スター16万超。Claude Code・Cursor・OpenCode など複数の環境に対応済みです。「どの環境でも動く」は地味に大事で、「環境が違うと動かない」の絶望感は一度経験すれば十分です——共感してくれる人、いますよね?
Coworkユーザーはどうなの?
ここ、私が一番気にしたところです。ECCの公式READMEに「対応環境」として列挙されているのは Claude Code・Cursor・Codex・OpenCodeで、Coworkの名前はありません。「え、私の環境、対象外?」と5秒固まりました。
5分でできること
プラグインマーケットプレイス経由が一番シンプルでした。「一番シンプル」と書いているときはたいていほかの方法で一回詰まっています。今回も例にもれずそうでした。
- Node.js がインストールされていることを確認する(まだの場合は nodejs.org から。「ついでにNode.jsの勉強も」は後回しにしていいです)
- Claude Code(またはCowork)を起動する
- マーケットプレイスにリポジトリを追加するコマンドを実行する
- プラグインをインストールするコマンドを実行する
- 対話式ウィザードの指示に従って、必要なコンポーネントを選択する(公式は「必要なものだけ選ぶ」ことを推奨しています。私は「どうせなら全部」を選んで現在に至ります)
Node.js の確認だけは先にしておいてください。これを後回しにすると「なぜか動かない」から始まる探索タイムが発動します。私の場合は40分でした。返してほしい。
私が使ったコマンド
# ステップ1: マーケットプレイスにリポジトリを追加する
/plugin marketplace add affaan-m/everything-claude-code
# ステップ2: プラグインをインストールする
/plugin install everything-claude-code
コマンドを打つだけで対話式ウィザードが起動して、必要なコンポーネントを選びながらセットアップを進めていく形式です。ソクラテスが2400年前にやっていた問答法と構造はほぼ同じで、ただしソクラテスと違って答えを間違えても怒られません——そこは安心していいです。
公式は「必要なものだけ選ぶ」ことを明言しています。「全部」を選ぶと大量のインストールが始まって「本当にこんなに要る……?」と不安になります。不安は正しい。私はそれを知らずに全部選んで今に至ります(知識は必ず事後にやってくる)。
💡 ポイント:
rules/フォルダは「フォルダごと」コピーするのが正解です。中のファイルだけを取り出すとファイル間の相対パスが壊れます。「なぜかルールが効かない」で30分溶けます——これは経験談です。
何を選べばいいのか問題
ウィザードに「何が欲しいですか?」と聞かれるわけですが、「欲しいものを選ぶ」という作業が一番難しいのが初心者です(私のことです)。参考までに仕分けをしておきます。
必ず入れておくべきもの
rules/common(言語を問わず全員に効く共通ルール)と、hooks(コード検証などを自動で走らせる仕組み)と、agents(コードレビュー・調査・計画立案などのエージェント群)です。「これがないとECCを入れた意味がない」セットです。
興味があれば覗いてみるもの
言語別ルール(rules/golang、rules/typescript、rules/python など)です。自分が使う言語のものだけ入れればOK。
「ぜんぶ入れとけば何かの役に立つだろう」という私の作戦は、ここに対して特に効果が薄かったです——JavaもRustも書かないので(書けない)。
初心者はどうすればいい?
公式は「必要なものだけ選ぶ」ことを推奨しています。選ぶ基準がわからないうちは正しい判断です。ただし、「何が欲しいかわからない」は「何も要らない」とは違います。
私のように「とりあえず全部」という選択肢も実害はそれほどなく、「余計なものが入っているかもしれない」という軽い罪悪感だけが残ります(現在進行形)。
後から外す方法
ecc uninstall コマンドでアンインストールできます。コンポーネントを選び直したい場合は Claude Code 上で /configure-ecc を実行するか、不要なファイルを .agents/ フォルダから手動で削除するのがシンプルです。
「後から外せる」とわかっていれば、最初の選択でそこまで悩まなくていいですよという話でもあります。
やらかしたこと
hooks の二重登録: ECCは
hooks/hooks.jsonに独自フックを置く構成になっています。なのにsettings.jsonに手動で同じ hooks を追加すると、同じ処理が2回走ります。「自動でやってくれる機能を知らないまま手動でもやる」——これ、コンビニのセルフレジで店員さんのスキャンと自分のスキャンが被るやつと同じ構造だと思います(違う)。rules はフォルダごとコピー:
rules/commonやrules/golangなどは、中のファイルだけ取り出してはいけません。フォルダごと移動が必要です。理由は相対参照(=ファイルの場所を「今いる場所から数えた距離」で指定する方法)。「なんとなくわかった」と思ったら全然わかっていなかった、という現象が起きやすい概念ベスト5に入ります——同じ人いますよね? いますよね??npm パッケージ名が違う: npm でインストールする場合のパッケージ名は
ecc-universalです。プラグイン名のeverything-claude-codeではありません。「同じものなのに名前が違う」ことに対して人類はずっと慣れられないと思います。私の場合は「npm の everything-claude-code が見つからない」で5分固まりました(経験値は積まれています)。
使ってみての正直な感想
ECCを入れてから、Claude Code が「全部ひとりでやってた人」から「チームを持ってる人」になった気がしています。コードレビューのたびに「レビューしてください、以下のコードで……」と毎回書かなくていいのは、思っていた以上に精神的に楽でした。ちりも積もれば山となる——そして山は返ってきません。
「16万スターのリポジトリを3回タブで閉じた人間」からのアドバイスとしては、とりあえず入れてみてください。Node.js の確認さえ済ませれば、あとはコマンド2本で終わります。同じ3回を繰り返さなくていいのに繰り返したのは私だけで十分です——あなたには今日で終わらせてほしい。

コメントを残す