🔍 Claude Code / Codexの拡張を「作る前に秒で探す」ローカルRAGツール c3 / c2 を自作した

この記事でわかること

• Claude Code / Codex 向けに「タスクを一言伝えると、既存のプラグイン・エージェント・スキル・MCPサーバーから最適な組み合わせを提案してくれるツール」を自作した理由
• カタログ構築と検索・提案を分離することで、検索はほぼゼロコスト、提案1回あたりも数千トークン程度に抑えているアーキテクチャ(AIに毎回Web調査させる場合の100分の1以下)
• c3(Claude Code向け)・c2(Codex向け)それぞれの導入コマンドと設定オプション
• 実際に /ccc を実行したときの内部の処理の流れと、優先順位の付け方

対象読者

• Claude Code または Codex を日常的に使っていて、「これって車輪の再発明では?」と迷った経験がある人
• 自作エージェント・スキルを作る前に、既存の資産を検索してから判断したい人
• ローカル完結・低コストで動くRAG的な検索の仕組みに興味がある人

はじめに

Claude Code や Codex は使えば使うほど、そして調べれば調べるほど「本当にこの使い方で合っているのか」と自信がなくなっていきます。日々新しいノウハウや公式機能、有志によるエージェント・スキルが公開される一方、モデルが更新されるたびにそれらがすぐ過去のものになってしまうこともあります。「結局どうするのが正解なのか」と迷いながら使い続けるうちに、せめて「車輪の再発明」だけは避けたいと思うようになりました。

とはいえ、エコシステム全体を毎回 Web 検索して比較するのは時間もトークンもかかります。そこで、「タスクを一言伝えると、ローカルに構築した検索カタログから最適な組み合わせを提案してくれるツール」として作ったのが、Claude Code 向けの c3 (Claude Code Concierge) と、その Codex 移植版である c2 (Codex Concierge) です。

• c3: https://github.com/happygoluckydev/c3
• c2: https://github.com/happygoluckydev/c2

いずれも MIT ライセンスです。本記事では両者の仕組みと導入・使い方を、実際のコマンドを交えて紹介します。

🏗️ アーキテクチャ ── なぜ低コストで提案できるのか

c3 / c2 のポイントは、「カタログ構築」と「検索・提案」を分離していることです。検索(retrieve)はほぼゼロコストですが、提案(propose)にはLLM呼び出しが発生するため数千トークン程度かかります。それでも、AIにエコシステム全体をその都度Web調査させる場合(1回の質問で数万〜10万トークン超になり得る)と比べれば、大幅に低コストです。

フェーズ	頻度	コスト
クロール（カタログ構築）	初回、および7日超で古くなったらバックグラウンドで	HTTPアクセスのみ、LLM呼び出しなし
検索（IDFキーワード検索）	リクエストのたびに	ミリ秒、API課金ゼロ
提案（Claudeが組み合わせを合成）	リクエストのたびに	数千トークン程度

カタログには何が入っているか

クロールで作られるのは、ローカルの JSONL カタログです。

• c3: ~/.claude/ccc/catalog.jsonl に、手元の ~/.claude/agents・~/.claude/skills に加えて wshobson/agents、VoltAgent の subagents/skills 一覧、anthropics/skills、aitmpl.com のコンポーネントカタログ、MCP Registry などを取り込みます（約5,000件規模、件数はインデクサ実行時点の概数）。
• c2: 同じ発想を Codex 向けに移植し、~/.codex/c2/catalog.jsonl に ~/.codex/skills・~/.codex/plugins・個人の ~/.agents/plugins/marketplace.json に加え openai/skills、anthropics/skills（Codex向けの発見用リード）、VoltAgent/awesome-agent-skills、aitmpl.com、MCP Registry を取り込みます。

検索は既定でローカル完結の全文検索（IDF重み付けの字句検索）のみで、埋め込みAPIも npm 依存もなし（Node.js 標準ライブラリのみ）。オプションで Gemini/Voyage/OpenAI の埋め込みAPIを使ったベクトル検索とのハイブリッド（RRF: Reciprocal Rank Fusion）に切り替えられます。

クエリの流れ(c3の場合)

c2 も同様の流れで、/c2 または /cc がコマンド接頭辞を除去してから検索し、最終提案はユーザーの言語に合わせて返します。

🚀 導入方法

c3（Claude Code向け）

前提: Node.js と Claude Code。

git clone https://github.com/happygoluckydev/c3.git
cd c3
sh install.sh        # Windows PowerShellの場合: ./install.ps1

これでスキルが ~/.claude/skills/ccc/ に、/c3 コマンドのエイリアスが ~/.claude/commands/ にコピーされ、~/.claude/ccc/config.json が書き込まれます。Claude Codeのセッションを再起動すれば /ccc <タスク> または /c3 <タスク> が使えるようになります。

インストール時のオプションは以下の通りです。

sh	PowerShell	効果
（デフォルト）	（デフォルト）	本文まで含めた全文検索(fulltext)。外部サービス不要。
--no-fulltext	-NoFulltext	軽量版。本文インデックスを省略しカタログサイズを縮小(recallはやや低下)。
--vectors gemini|voyage|openai	-Vectors gemini	字句検索と埋め込み検索をRRFで融合するハイブリッド検索。GEMINI_API_KEY/VOYAGE_API_KEY/OPENAI_API_KEY のいずれかが必要。

--vectors を指定した場合、埋め込みAPIプロバイダには「カタログ再構築時の名前・タグ・説明文」と「クエリごとの検索文字列」が送信されます（本文フルテキストは送られません）。APIキーが未設定の場合は自動的に字句検索にフォールバックします。

カタログの定期更新をcron/タスクスケジューラで固定したい場合は以下を実行します。

sh setup-schedule.sh       # macOS/Linux: 毎週月曜9:00にcronジョブを登録

./setup-schedule.ps1       # Windows: 毎週月曜9:00にタスクスケジューラへ登録

これを実行しなくても、/ccc 実行時にカタログが無ければ同期構築、7日超で古ければ現行カタログで即応答しつつバックグラウンドで再構築されます。

c2（Codex向け）

前提: Node.js と、プラグインに対応した Codex CLI。

git clone https://github.com/happygoluckydev/c2.git

clone した plugins/c2 ディレクトリを Codex の Plugins ワークフローで追加します（または個人の ~/.agents/plugins/marketplace.json から参照）。これで c2 スキルと /c2・/cc のコマンドプロンプトが使えるようになります。新しいセッションで /c2 <タスク> または /cc <タスク> を実行してください。

c2 の検索モードは ~/.codex/c2/config.json を編集して切り替えます。

{
  "fulltext": true,
  "vectors": { "provider": "openai" }
}

設定	効果
"fulltext": true（デフォルト）	本文まで含めた字句検索。外部サービス不要。
"fulltext": false	軽量版。本文インデックスを省略。
"vectors": { "provider": "openai" | "gemini" | "voyage" }	RRFによるハイブリッド検索。対応するAPIキーが必要。

定期更新のスケジュール登録は c3 と同じ構成で、パスだけ plugins/c2/ 配下になります。

sh plugins/c2/setup-schedule.sh      # macOS/Linux

./plugins/c2/setup-schedule.ps1      # Windows

💡 使い方のイメージ

実際に /ccc を実行すると、次のような流れで返答が来ます（Stripeの定期課金画面を作りたい、というタスクの例）。

/ccc I want to build a Stripe subscription billing page

c3内部では、まずタスク文から英語キーワードを抽出し、search.mjs --all でカタログ内の候補をTSVで受け取ります。候補は種類ごとに件数上限があり（agent最大5件、plugin最大5件、skill最大6件、mcp最大5件）、そこから優先順位ポリシーに従って3〜5件の最終候補に絞り込み、search.mjs --get で各候補のインストールコマンドを含む詳細情報を取得してから、提案テーブルと根拠、セキュリティ上の注意点を添えて回答します。

優先順位ポリシー ── c3 と c2 の違い

どちらも「まず既存資産の再利用」を最優先にしていますが、対象エコシステムの違いに合わせて並びが変わります。

順位	c3（Claude Code向け）	c2（Codex向け）
1	追加不要（既存機能・手元導入済みagent/skillの再利用）	追加不要（既存機能・手元導入済みskill/pluginの再利用）
2	プラグイン（agent+skill+commandがまとまったもの）	インストール済みプラグイン
3	スキル（手順知識だけで足りる場合。公式スキルを優先）	公式スキル/プラグイン
4	MCPサーバー（外部サービスへのアクセスが本当に必要な場合のみ）	互換性のあるコミュニティ製スキル
5	単体のコミュニティ製エージェント	MCPサーバー（外部データ・操作が本当に必要な場合のみ）

いずれもコミュニティ製の定義ファイルにはプロンプトインジェクションのリスクがあり得るため、インストール前に内容を確認するよう案内が付きます。

🧹 手元の資産の棚卸し(prune)

導入済みのagent/skillのうち使われていないものを洗い出し、常駐コンテキストのコストを見積もる補助スクリプトも同梱されています。

c3の場合:

node ~/.claude/skills/ccc/scripts/prune.mjs          # ドライラン(レポートのみ)
node ~/.claude/skills/ccc/scripts/prune.mjs --apply  # 未使用分を ~/.claude/agents-archive/ へ退避

c2の場合:

node plugins/c2/skills/c2/scripts/prune.mjs           # ドライラン(レポートのみ)
node plugins/c2/skills/c2/scripts/prune.mjs --apply    # 未使用分を ~/.codex/skills-archive/ へ退避

いずれも削除ではなく退避のみで、c2側はCodexのセッション記録が無い場合はアーカイブ自体を拒否する安全策が入っています。

✅ まとめ

c3 / c2 は、「自作する前に、もう存在しているものを探す」という一手間を、ローカルカタログとキーワード検索によって低コスト(検索はほぼゼロ、提案も数千トークン程度)で習慣化するためのツールです。

• 既定では外部サービスに一切依存せず、ローカルの全文検索だけで完結する
• 必要な場合だけベクトル検索のハイブリッドに切り替えられる設計になっている
• 優先順位ポリシーは常に「まず手元の資産を再利用」から始まる

次にやること: Claude Codeを使っているなら c3、Codexを使っているなら c2 を、それぞれのリポジトリからcloneして install.sh（または該当の導入手順）を試してみてください。フィードバックやIssueも歓迎です。

• c3: https://github.com/happygoluckydev/c3
• c2: https://github.com/happygoluckydev/c2

📝 追記

細かい点ですが、c3は/ccc(エイリアス/c3)、c2は/c2(エイリアス/cc)と、コマンド名とエイリアスの対応関係がプロジェクト間で逆転しています。意図した設計ではなく単なる命名の揺れなので、気づいた方はご愛嬌ということで見逃していただければと思います。