parecode

parecode

コーディングエージェントに、コンテキストウィンドウを考慮した検索と、安全でアトミックな複数ファイル編集を提供する MCP サーバーです。大規模なコードベースで正確性を損なうことなく、トークン使用量を削減できるように構築されています。

---

要件

• Node.js 20 以降（ESM、ネイティブテストランナー、安定した fetch 不要のランタイム）。
• PATH に ripgrep があること（Linux/macOS では rg、Windows では rg.exe）。パッケージマネージャーからインストールしてください。
  • macOS：brew install ripgrep
  • Debian/Ubuntu：apt install ripgrep
  • Windows：winget install BurntSushi.ripgrep.MSVC または choco install ripgrep
• 対応する MCP クライアント（参照対象は Claude Code です）。

Parecode には ripgrep は同梱されていません。監査済みの単一バージョンを使い続けられるよう、システムのバイナリを呼び出します。

---

インストール

npm install -g parecode

純粋な JavaScript であり、ネイティブ依存関係や C/C++ ツールチェーンは必要ありません。

---

クイックスタート

Claude Code にサーバーを登録します。

parecode init                       # user scope; installs MCP + SessionStart hook + parecode-explore plugin (defaults)
parecode init --scope project       # commit MCP config + hook to the repo
parecode init --no-hook             # register MCP only; skip the SessionStart hook
parecode init --no-plugin           # skip the parecode-explore Claude Code plugin
parecode init --print               # print the equivalent command without running it
parecode init --remove-hook         # remove the SessionStart hook (MCP stays registered)
parecode init --remove-plugin       # uninstall the parecode-explore Claude Code plugin

SessionStart フックは各セッションの開始時に短い指示を挿入し、同等のネイティブツールよりも ParecodeSearch／ParecodeEdit を優先するよう Claude に伝えます。このフックがないと、通常は Claude のファーストパーティツールである Grep／Read／Edit がデフォルトで優先され、Parecode によるトークン削減効果が得られません。フックのペイロードは静的な文字列で、parecode hook session-start で出力できます。独自のツールを使ってセッションごとに明示的にオプトインする場合は、--no-hook を渡してください。

同梱の parecode-explore Claude Code プラグインは、読み取り専用のサブエージェント（Haiku に固定され、ParecodeSearch のみを利用）と、それに対応するスキルを追加します。これにより、探索形式の質問（「X はどこにありますか？」「Y はどのように動作しますか？」「Z の使用箇所をすべて見つけてください」）に、メインセッションでトークンを消費する代わりに、低コストで独立したコンテキストウィンドウから回答できます。init は npm でインストールされたコピーを指すローカルマーケットプレイスを登録し、claude plugin install parecode-explore@parecode を実行します。お使いの Claude Code のビルドが plugin サブコマンドに対応していない場合、この手順は警告を出してソフトフェイルしますが、init の残りの処理は成功します。プラグイン手順を完全にスキップするには --no-plugin を渡し、プラグイン手順の失敗をハードフェイルにするには --with-plugin を渡してください。

以降、どのセッションでも ParecodeSearch、ParecodeExpand、ParecodeEdit ツールを利用できます。parecode doctor を実行すると、登録状況、フックの状態、存在する場合は .codegraph/ との連携を確認できます。

機能

• ParecodeSearch — ripgrep を利用した検索ツールです。1 回の呼び出しで前後のコンテキストを含む一致箇所を返し、ファイルごとのバイト単位のチャンク分割により、大量の検索結果でコンテキストがあふれるのを防ぎます。
  • pattern には単一の文字列または文字列の配列を指定できます。配列の場合は、同じ paths / contextLines を共有して ripgrep を並列実行し、各一致箇所には、どの入力パターンが該当したかを示す patterns: string[] フィールドが含まれます。関連キーワードのフローを追跡する際、連続して行う N 回の grep を 1 回の呼び出しに置き換えられます。
  • 同じファイル内で重複または隣接するウィンドウは自動的にマージされます（間隔が contextLines 以下の場合）。間をつなぐ行はディスクから読み込まれます。
  • 一致箇所ごと、およびレスポンス全体の estimatedTokens が返されるため、エージェントは結果を取得する前に自ら予算を見積もれます。
  • relatedSymbols: true をオプトインで指定すると、各一致箇所で見つかった、関連するイベントフローの可能性が高い近傍（Handle<X>、On<X>、<X>Handler/Listener/Closed/Completed/Started）を最大 10 件まで表示します。
  • 省略された行範囲が報告されるため、ファイル全体を再読み込みせずに ParecodeExpand で範囲を広げられます。
• ParecodeExpand — 既知の (file, startLine, endLine) 範囲を、任意の contextBefore / contextAfter の余白を加えて広げます。ParecodeSearch の一致箇所に続けて使うことを想定しています。同じ形式の estimatedTokens を返すため、同じ自己予算管理のヒューリスティックを適用できます。行の位置を特定した後は、ファイル全体の Read よりこちらを優先してください。
• ParecodeEdit — 空白を許容するファジーマッチング（オプトインの Unicode 類似文字モードも利用可能）、編集前後の stat による競合検出、同一ディレクトリ内でのアトミックなリネーム書き込みに対応した、複数ファイルの一括編集機能です。ファイル間の編集は並列実行されます。
• parecode stats — トークン節約量の推定値を記録する、ローカルの JSONL セッションログです。ネットワーク通信もテレメトリーもありません。

---

実測された節約効果

検索と編集を伴うタスク（呼び出し箇所の特定、複数ファイルのリファクタリング、「すべての Y に X を行う」など）では、条件を揃えた A/B テストにおいて、Parecode によりコストを約 40％、アシスタントのターン数を約 75〜83％削減できました。

リポジトリ	タスク	コスト	ターン数
TypeScript	シンボルのすべての呼び出し箇所を見つけ、それぞれを編集（17 箇所、8 ファイル）	−43%	−83%
Unity / C#	シンボルのすべての呼び出し箇所を見つけ、それぞれを編集（11 箇所、5 ファイル）	−41%	−76%

方法：Parecode の有効時と無効時で同一のタスクを実行し、各実行で新しいセッションを使用しました。各条件で n=3、実行順は交互にし、Sonnet 4.6 を使用しました。節約効果は、多数の Grep / Read / Edit の往復を単一の ParecodeSearch / ParecodeEdit 呼び出しにまとめることで得られます。そのため、検索や複数ファイルへの展開が多いタスクほど効果が大きく、単一ファイルのタスクや推論が中心のタスクでは効果がほぼなくなります。これらはセッションごとに実測したトークン数とコストであり、以下のスキャンに記載されている推定値ではありません。

---

過去の節約効果をスキャン

Parecode をもっと早くインストールしていたら、どれほど節約できたか気になりますか？過去の Claude Code セッションをスキャンできます。

parecode stats --retroactive --since 30d

出力例：

Parecode — last 30d (retroactive scan)
─────────────────────
Sessions:                   42
Tool calls:                156
Calls batched (est):        89
Tokens saved (est):  1,200,000

* Note: Retroactive savings are estimated, not measured.

プライバシーに関する注意： このスキャンは、Claude Code のセッショントランスクリプト（~/.claude/projects/**）を対象に、すべてローカルで実行されます。デフォルトでは、構造化フィールド（ツール名、パス、パターン、トークン数）のみを解析します。データがネットワーク経由で送信されることはありません。ツールの入出力を読み取る --include-content フラグは、明示的に指定した場合のみ有効になり、使用時には目立つ形で警告されます。

---

プライバシー

Parecode は実行時にネットワーク通信を一切行いません。セッションログは、OS のデータディレクトリ（env-paths で解決）に Unix では 0600 のアクセス許可で書き込まれます。ログは自動管理されます。サーバーの起動ごとに、30 日より古いセッションデータが削除され、エンベロープログは 5 MB に制限されます。より早く削除するには parecode prune <days> を実行するか、データディレクトリを消去してください。parecode update を実行して、最新リリースに更新し、フック／プラグインを更新してください。

---

ライセンス

MIT