CocoIndex Codeとは？
CocoIndex Codeは、データ変換エンジンCocoIndexを開発したチームによるものです。tree-sitterで関数やクラスの境界に沿ってリポジトリをチャンクに分け、埋め込みを計算し、ベクトルをプロジェクトの.cocoindex_codeフォルダ内の組み込みSQLiteとLMDBファイルに保存します。エージェントはgrep用の名前を推測する代わりに、「ユーザーセッションをどう管理しているか」のように説明してコードを探せます。Rust製のエンジンは変更されたファイルだけを再インデックスします。
コマンドラインツールのcccは、CLIとして、Claude Codeなどのエージェント向けのskillとして、またはclaude mcp add cocoindex-code -- ccc mcpでMCPサーバーとして動きます。フルインストールにはSentence Transformersが含まれ、既定では小型モデルSnowflake/snowflake-arctic-embed-xsを手元のマシンで使い、APIキーは不要です。軽量インストールはLiteLLM経由でクラウドプロバイダーやOllamaに埋め込みを送ります。バックグラウンドのデ ーモンがクエリの間もモデルを読み込んだまま保持します。
リポジトリは2026年2月に作成され、スター数は約2,980、ライセンスはApache-2.0です。バージョン0.2.43は2026年11月5日に公開され、公式MCPレジストリに掲載されています。PyPIパッケージは11月10日までの1週間で約1,270回ダウンロードされました。
CocoIndex Codeのインストール方法
pipx install 'cocoindex-code[full]' && claude mcp add cocoindex-code -- ccc mcpCocoIndex Codeは使う価値があるか？
CocoIndex Codeの役割は1つだけです。自然言語の質問に対して、最も似ているコードのチャンクを5件返します。MCPサーバーが公開するツールはsearchだけで、言語とパスのグロブで絞り込め、結果の上限は1から100件です。ツールが1つなのでコンテキストの負担はほぼゼロです。さらにrefresh_indexが既定でtrueのため、各クエリの前に前回からの変更分を再インデックスし、エージェントが古いコードを読むことはありません。
検索は埋め込みの類似度だけに頼っています。キーワードやBM25による検索経路はなく、2026年3月に立てられたissueがいまも追加を求めています。そのため、完全一致する識別子が、それらしく聞こえるだけのチャンクより下位に来ることがあります。ここで最も近い競合のSembleは、BM25と埋め込みを組み合わせ、find_relatedツールも備えます。READMEがうたう70%のトークン削減には方法論が公開されておらず、Sembleは少なくともベンチマークを文書化しています。
ローカルの埋め込みは 最大の魅力であり、最大のコストでもあります。フルインストールでは約1 GBのPyTorchとtransformersが加わり、フル版のDockerイメージは約5 GBです。コードをクラウドの埋め込みAPIに送る軽量版は450 MBです。既定のモデルは小さくCPUでも高速ですが、READMEはコード検索の精度を上げたい利用者にnomic-ai/CodeRankEmbed（パラメータ137M、VRAM約1 GB）を勧めています。モデルを切り替えるとインデックスは全面的に作り直しになります。
注意すべき既定設定が2つあります。COCOINDEX_DISABLE_USAGE_TRACKING=1を設定しない限り、匿名の利用状況テレメトリが有効です。READMEによれば、コード、パス、クエリ、結果は含まれません。文書化されたDocker構成は、COCOINDEX_HOST_WORKSPACEで絞り込まない限り、ホームディレクトリ全体を読み書き可能な状態でコンテナにマウントします。どちらも珍しいことではありませんが、どちらも自分で無効にする必要があります。
大きなモノレポの前に知っておくべきインデックス保存の上限があります。LMDBは既定で4 GiBに制限され、数万ファイルを高次元のモデルで扱うと、COCOINDEX_LMDB_MAP_SIZEを引き上げてデーモンを再起動するまでMDB_MAP_FULLが発生することがあります。Serenaやcodebase-memory-mcpのようなコードグラフと比べると、コードは見つけられても、誰がそれを呼んでいるかは答えられません。
真価を発揮する場面
見知らぬPythonとTypeScriptのコードベースに加わった開発者
誰がどう名付けたか知らないまま、ある挙動の実装場所を見つける
pipxでcocoindex-code[full]をインストールし、Claude Codeにccc mcpを登録して「Webhookのリトライはどこで処理しているか」と尋ねます。エージェントは推測した名前でgrepする代わりに、順位付きのチャンクを5件受け取ります。呼び出し元に関する質問には、引き続きSerenaかコードグラフが必要です。
顧客と秘密保持契約を結んで仕事をする、セキュリティを重視するコンサルティング会社
コードをノートPCの外に出さずに、エージェントに意味検索を使わせる
既定のローカルSentence Transformersモデルを使い続け、シェルのプロファイルでCOCOINDEX_DISABLE_USAGE_TRACKING=1を設定します。課金は発生せず、コストは依存関係のための約1 GBのディスクと、初回インデックス時のCPU時間です。
共有の開発コンテナでエージェントを運用するプラットフォームチーム
すべての開発者イメージに同じ検索環境を用意する
軽量イメージcocoindex/cocoindex-code（約450 MB）をVoyageかOpenAIの埋め込みキーで動かし、COCOINDEX_HOST_WORKSPACEでコードフォルダだけをバインドマウントします。埋め込みの費用はリポジトリの規模とプロバイダーのトークン単価で決まります。
導入前に確認すること
- 導入
- pipx install 'cocoindex-code[full]'またはuv tool installのあと、claude mcp add cocoindex-code -- ccc mcpを実行します（Codex、OpenCode、Kilo Code、Oh My Pi向けの手順もあります）。ccc initでモデルを選び、最初の検索でインデックスが作られます。非対話の初回実行には事前に一度ccc initが必要です。
- 連携
- MCPツールはsearch（query、limit、offset、refresh_index、languages、paths）の1つで、読み取り専用です。CLIには例示による構造検索のccc grep、ccc status、ccc doctorもあります。MCPの代わりに、Claude Codeのプラグインマーケットプレイスとskillとしての導入も用意されています。
- データとプライバシー
- インデックスファイルはプロジェクトの.cocoindex_codeフォルダに置かれ、.gitignoreに追加されます。ローカルのSentence Transformersならコードはマシンから出ません。LiteLLMのプロバイダーを使うと、すべてのチャンクがそのプロバイダーに送られます。匿名テレメトリは既定で有効です。セキュリティアドバイザリは公開されていません。
- 大規模利用時のコスト
- ローカルではCPUやGPUの時間とディスク以外は無料です。クラウドの 埋め込み費用はコードの規模に応じてプロバイダーの料金で増えます。チームで共有するインデックスやブランチ間の重複排除はエンタープライズ機能で、価格は問い合わせ制です。
- 制限
- LMDBのインデックス保存は既定で4 GiBが上限で、大きなリポジトリではCOCOINDEX_LMDB_MAP_SIZEの引き上げが必要です。モデルを替えるにはccc resetと全面的な再インデックスが要ります。macOS標準のPythonはSQLiteの拡張を読み込めません。未解決のissueは約26件、オープンなプルリクエストは41件です。
良い点
- 読み取り専用のMCPツール1つだけで、コンテキストの負担がほぼない
- フルインストールならAPIキー不要のローカル埋め込み
- 既定で各クエリの前に差分を再インデックス
- Apache-2.0で、LiteLLM経由で100以上の埋め込みプロバイダーに対応
気になる点
- ベクトル類似度のみで、キーワードやBM25による順位付けがない
- 匿名テレメトリが既定で有効
- フルインストールで約1 GBのPyTorch依存関係が加わる
- 呼び出しグラフ、参照、型の情報がない
おすすめの人
ソースコードをクラウドの埋め込みAPIに送らずに、非公開リポジトリのコードを説明から探せるようにしたい開発者。
CocoIndex Codeの代替
CocoIndex Code：よくある質問
- CocoIndex Codeは使う価値があるか？
- エージェントにリポジトリ の意味検索を与える、すっきりとしてプライバシーを守れる方法ですが、ベクトル検索のみで、既定で利用状況を送信し、ローカルで動かすには1ギガバイトの依存関係が必要です。 評価は5点満点中3.8点です。
- CocoIndex Codeの料金は？
- 無料のオープンソース（Apache-2.0）です。クラウドの埋め込みプロバイダーは利用者に直接課金します。チームで共有するインデックスはエンタープライズ機能で、価格は公開されていません。
- CocoIndex Codeの欠点は？
- ベクトル類似度のみで、キーワードやBM25による順位付けがない; 匿名テレメトリが既定で有効; フルインストールで約1 GBのPyTorch依存関係が加わる; 呼び出しグラフ、参照、型の情報がない.
- CocoIndex Codeは誰に向いているか？
- ソースコードをクラウドの埋め込みAPIに送らずに、非公開リポジトリのコードを説明から探せるようにしたい開発者。
- チームや本番環境でCocoIndex Codeを使うと費用はいくらか？
- ローカルではCPUやGPUの時間とディスク以外は無料です。クラウドの埋め込み費用はコードの規模に応じてプロバイダーの料金で増えます。チームで共有するインデックスやブランチ間の重複排除はエンタープライズ機能で、価格は問い合わせ制です。
- CocoIndex Codeは企業データを扱っても安全か？
- インデックスファイルはプロジェクトの.cocoindex_codeフォルダに置かれ、.gitignoreに追加されます。ローカルのSentence Transformersならコードはマシンから出ません。LiteLLMのプロバイダーを使うと、すべてのチャンクがそのプロバイダーに送られます。匿名テレメトリは既定で有効です。セキュリティアドバイザリは公開されていません。
- CocoIndex Codeの代わりになるものは？
- 当サイトでレビューした中で最も近い代替はSemble, codebase-memory-mcp, Serena 、 CodeGraphです。
回答確認日：2026年11月11日