Sipcode について
Sipcodeは、Claude Code利用者向けのオープンソースCLIです。PreToolUseフックでセッションのコンテキストを監視・整理し、使用量やコストを数値で確認できます。OpenAI Codexの利用状況も分析しますが、Codexの動作は変更しません。
主な機能
- 01コンテキストの肥大化と逸脱の監視
- 02同一セッション内の重複ファイル読み込み検出
- 03冗長なツール出力の上限設定
- 04使用量・支出・予測の確認
- 05Codexの利用上限の確認
活用シーン
- 01Claude Codeのセッションでコンテキスト逸脱を把握
- 02セッション内のファイル再読み込みを削減
- 03日次支出と月末予測を確認
- 04Codexのプラン上限に対する使用状況を追跡
MCP 対応
Sipcodeは、セッション統計、コンテキスト状態、Codexの利用上限をクライアントから照会できるMCPサーバーを提供します。MCPツールはClaude Codeのセッション分析に対応し、オプション指定でCodexのセッションも読み取ります。
設定
ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。
ツール
16掲載時のツール一覧 · 2 週間前に更新
このツールにパラメーターはありません。
詳細
Sipcode
Claude Code のコンテキストを自動的に整理し、より的確な回答を低コストで得られます。
30秒でインストール
npm i -g sipcode
sipcode init
これで完了です。次回の Claude Code セッションから、Sipcode が自動的に使われます。数分後に次のコマンドで確認してください。
sipcode drift
出力に no drift, context health stable と表示されていれば、Sipcode は正常に動作しています。
インストール済みですか?最新の状態を保ちましょう。 Sipcode はネットワーク通信を一切行わないため、「アップデートがあります」という通知は表示できません。週に一度、
sipcode update(またはnpm i -g sipcode@latest)を実行して、最新の修正を取得する習慣をつけましょう。詳しくはSipcode の更新をご覧ください。
Sipcode とは?
Sipcode は、あなたと Claude Code の間に入る無料のコマンドラインツールです。次の3つの機能があります。
- Claude Code のコンテキストウィンドウを監視し、肥大化し始めると警告します(これを「コンテキストの劣化」と呼びます)。
- 重複したファイル読み込みなどの無駄を Claude に届く前に検出するため、同じ回答をより低コストで得られます。
- 効果を数値で確認できます。節約額はすべてターミナルで測定できます。
MIT ライセンスのオープンソースです。通常の使用時にネットワーク通信を一切行いません。データがノートパソコンの外に出ることはありません。
Sipcode の比較
| Sipcode | Tool A | Tool B | Tool C | |
|---|---|---|---|---|
| アプローチ | リアルタイムの PreToolUse フック | セッション間のメモリーストア | 静的な手法 | RAG 検索サーバー |
| 冗長なツール出力を制限 | ✓ | ✗ | ドキュメントのみ | ✗ |
| 同一セッション内の再読み込みを重複排除 | ✓ | ✗ | ドキュメントのみ | ✗ |
| セッション途中のインストールに対応 | ✓ 検証済み Warm-Fill | 該当なし | 該当なし | 該当なし |
| 設計上、誤った重複排除が発生しない | ✓ | 該当なし | 該当なし | 該当なし |
| 固定コーパスを使った再現可能なベンチマーク | ✓ 中央値 62.6%(合成タスク20件) | ✗ | ✗ | ✗ |
| 自己分析用 MCP ツール | ✓ 16個のツール | ✗ | ✗ | 一部対応 |
| 対応エージェント | Claude Code(全機能)、OpenAI Codex(使用額の分析と利用上限。フックなし) | 比較対象外 | 比較対象外 | 比較対象外 |
| 通常の使用時にネットワーク通信なし | ✓ | ✓ | 該当なし | ✗ |
| MIT ライセンス | ✓ | ✓ | ✓ | ✓ |
Sipcode は、セッションをまたいでコンテキストを保持するメモリーツールと併用できます(表の Tool A)。Sipcode は個々のセッションを整理された状態に保ちます。それぞれ異なる課題を解決します。最大限の効果を得るには、両方を実行してください。
ツール名を明記した機能別の詳細な比較はこちら:anuj7411.github.io/sipcode/compare
どのような場合に役立つか
Claude Codeを実際の作業に使っているなら、すでに次のようなことを経験しているでしょう。
- 長時間のセッションはすぐに費用がかさみます。Claude Maxで2時間セッションを実行すると、1日のプランを使い切ってしまうことがあります
- コンテキストウィンドウが埋まるにつれて、品質が低下します。Claudeがファイルを読み直したり、同じことを繰り返したり、依頼の内容を見失ったりするようになります
- 何が無駄で、何が重要なのかを判断できません
Sipcodeは無駄を測定し、Claudeに不要な部分を取り除きます。任意のマシンで sipcode benchmark を実行すると、固定された20タスクのコーパスで、中央値が同じ62.6%削減されることがわかります。このコーパスは合成データです。実際のセッションの記録ではなく、Claude Codeのトランスクリプトをスクリプトで作成したペア(Sipcodeを使用しない場合と使用した場合)で構成されています。モデル化されたセッションから、Sipcodeの仕組みが何を取り除くかを示しています。実際の数値はワークロードによって異なり、sipcode impact を使うと実際のセッションで測定できます。
2分でわかる概要
インストール後、Sipcodeの動作を確認するための5つのコマンドを紹介します。
1. sipcode drift
現在のClaude Codeセッションが通常の使用パターンから逸脱しているかどうかを知らせます。肥大化したコンテキスト、繰り返される読み込み、古くなったシグナルを検出して表示します。
✓ Sipcode drift: no drift, context health stable vs your recent baseline.
デフォルトでは、Claude CodeとCodexの両方を対象に、直近のセッションを確認します。特定のセッションを確認するには --session <id> を指定します。--here を指定すると現在のフォルダー内のセッションに限定され、--agent claude-code または --agent codex を指定するとツールを選択できます。
2. sipcode proxy --stats
現在のセッションでSipcodeが検出した内容を、リライターごとに分類して表示します。
Sipcode proxy, rewrite stats
total rewrites: 144
est. tokens saved: ~288,685 (heuristic)
signal kept: 67% (med), weighted across all rewrites
3. sipcode benchmark
固定された20タスクのコーパスを実行し、再現可能な削減率を算出します。誰でも、どこでも実行すれば62.6%という結果が得られます。トランスクリプトは実際のセッションの記録ではなく、スクリプトで作成されたものです。そのため、測定された請求額ではなく、Sipcodeの仕組みをモデル化したものとしてご覧ください(METHODOLOGYを参照)。
62.6% median savings on a locked 20-task corpus
range 37.4% to 80.6% 3,567,170 tokens $22.48
4. sipcode today
日ごとの使用量の概要です。使用したトークン数、セッション数、出力比率、過去30日間の中央値との比較を表示します。
spend so far $1.20 across 4 sessions
tokens so far 943.8K output ratio 3.7%
5. sipcode forecast
過去14日間の使用状況に基づいて、月末の使用量を予測します。
projected month-end $17,674 (range $14,139 to $21,208)
Codex
Sipcode は OpenAI Codex CLI のセッションログ(~/.codex/sessions と ~/.codex/archived_sessions、または CODEX_HOME が指すフォルダー)も読み取ります。Codex の場合、これは利用料金の分析と使用制限を確認するためのものです。Sipcode は、Codex のセッションで使用された内容、トークンの使用先、プランの上限までどれほど余裕があるかを報告します。Codex の動作を変更することはありません。
Codex を読み取るコマンド: stats、today、forecast、trend、impact、why、receipt、drift、regress、limits(Codex 専用)、および MCP サーバーのセッションツール(省略可能な agent 入力として "claude-code" または "codex" を指定できます)と get_codex_limits です。
-
--agent codexを指定すると Codex のみが表示されます。--agent claude-codeを指定すると Claude Code のみが表示されます。 -
--agentフラグを指定せず、両方のツールがインストールされている場合、stats、today、forecast、trend、impactはツールごとに 1 つのセクションを表示します。stats、today、forecastは、次の形式の統合行で終わります。Both tools: <total tokens> tokens · ~$<Claude Code> + ~$<Codex> -
why、receipt、driftは、両方のツールのうち最も新しいセッションについて報告します。もう一方のツールにも新しいセッションがある場合は、そのセッションと表示に使用するフラグを示すヒントが 1 行表示されます。 -
--hereは Codex でも動作し、各セッションについて Codex が記録した作業フォルダーと照合します。 -
--jsonでは、1 回の呼び出しにつき 1 つのツールが対象になります。--agentを指定しない場合は Claude Code が対象となり、Codex のログも存在するときは stderr に注記が表示されます。Codex の JSON を取得するには--agent codexを追加します。 -
Cursor と Codex がインストールされたマシンで
--agentフラグを指定しない場合、Sipcode は Codex を表示します(Cursor のセッションログは読み取りません)。
Codex のトークンのカウント方法。 Sipcode は Codex のリクエストごとの使用記録を読み取ります。古いバージョンの Codex のログでは、各リクエスト後に Codex が記録する累計値の変化を読み取ります。キャッシュされた入力も Codex の入力数に含まれるため、Sipcode がキャッシュされたトークンを二重に課金することはありません。再開または分岐されたセッションファイルにコピーされたリクエストは 1 回だけカウントされます。メンテナーのマシンでは、Sipcode のファイルごとの合計は、実際の 15 個すべてのセッションログにおいて Codex 自身の最終的な total_token_usage と一致しています。また、Sipcode とコードを共有しない独立したカウンター(scripts/verify-counts.mjs)が、各期間コマンドの結果を同じログに対して照合します。
価格。 Codex のモデル価格は、OpenAI の API 価格表(developers.openai.com/api/docs/pricing、および developers.openai.com/api/docs/models にある各 Codex モデルのページ。2026-10-09 時点)に基づきます。入力トークン数が 272,000 を超えるプロンプトには、長いコンテキスト向けの料金も適用されます。価格が不明なモデルは「価格不明」として表示されます。そのトークンもカウントされ、コストの下に合計から除外された数が表示されます。$0 として表示されることはありません。
Codex ではまだサポートされていない機能: AGENTS.md へのルールの書き込み(rules と init のルール設定ステップ)、Codex への MCP サーバーの登録、プロキシとフック(proxy、hygiene)、estimate、benchmark。rules --agent codex と estimate --agent codex は、Claude Code のデータを表示する代わりにエラー E009 で停止します。
圧縮された Codex ログ。 Codex は古いセッションログを .jsonl.zst に圧縮します。Node.js 22.15 以降では、Sipcode はこれらを通常のログと同じように読み取ります。それより古い Node.js では読み取りをスキップし、すべてのレポートの先頭に、読み取れなかったログの数と、読み取りには Node.js 22.15 以降が必要であることを示す警告が表示されます。破損または読み取り不能なログにも、同様の警告が表示されます。--json の場合、警告は stderr に注記として表示され、JSON は変更されません。
Codex の使用上限:sipcode limits
Codex は、各リクエストの後にプランの使用上限の読み取り値を独自のログに書き込みます。sipcode limits はネットワーク呼び出しを一切行わずにそれらを読み取り、次の3つの質問に答えます。上限に達するのはいつか、何が使用したのか、上限が縮小したかどうかです。
sipcode limits --since all の出力例(ここでの1%あたりのトークン数の履歴は、デフォルトの90日より前までさかのぼります):
sipcode limits · Codex · plan: go · as of 2h ago (your last Codex request)
Weekly limit 62% used resets Wed 14 Oct 14:00 at this pace: runs out Tue 13 Oct ~18:00
30-day limit 22% used resets Mon 2 Nov at this pace: lasts until reset
What used your weekly limit (since Wed 7 Oct)
0199a1b2-c3d4-7a11 sipcode 31% 3.1M tokens
0199a0f7-11aa-7b02 my-app 17% 1.4M tokens
codex-auto-review (9 requests) 6%
unattributed (no Codex requests on this computer) 8%
Tokens per 1% of your weekly limit (gpt-5.4)
Mar 28: 425K Apr 1: 357K Apr 13: 77K
Possible limit cut around Apr 13: 5.1x fewer tokens per 1%.
Limits cover your whole account. Codex use on other devices or in the cloud
is not in these logs and can look like a cut.
- ログに記録されたすべての上限期間(5時間、週単位、30日):使用率、リセット時刻、および現在のペースで上限に達する時刻です。ペースは、期間の開始から現在までの経過時間に対する使用率で算出されるため、Codex を使用していない間は推定時刻が後ろに移動します。「as of」は最後に Codex をリクエストした時刻です。使用率の鮮度はその時点までとなります。
- **何が使用したか:**現在の期間の上位5件のセッションとプロジェクト(フォルダー名のみ)、およびCodexの自動レビューを1行で表示します。使用率が上昇するたびに、前回の上昇以降に行われたリクエストに、そのトークン数に応じて使用量を割り当てます。このコンピューターでリクエストしていないのに上昇した場合は、他のデバイスやCodexクラウドと上限を共有しているため、
unattributedと表示されます。 - **上限が縮小したかどうか:**使用率が20%以上の完了済み期間について、上限の1%あたりに消費できたトークン数を、同じモデル内でのみ比較します(トークンの90%以上が1つのモデルからの期間のみが対象です)。同じ日に開始した期間には、開始時刻(
Jul 5 16:39)も表示されます。過去の期間が2つ以上ある場合に、今回の期間で消費できたトークン数が、その中央値の半分以下であればPossible limit cutと表示されます。別のデバイスでのCodexの使用により、ローカルのトークン数が増えないまま使用率が上昇するため、常に「可能性」として示されます。 - オプション:
--json、および1%あたりのトークン数の履歴をどこまでさかのぼるかを指定する--since <window>(デフォルトは90d)です。--hereを指定すると、「何が使用したか」の一覧が現在のフォルダー内のセッションに限定されます(上限はアカウント全体で適用されます)。 - Codex が上限の読み取り値を記録している場合、
sipcode todayは上限に最も早く達するCodexの上限を1行追加します。today --jsonに変更はありません。 - MCP:
get_codex_limits(sinceは任意)は、sipcode limits --jsonと同じJSONを返します。 - Claude Codeのログには上限が記録されないため、
limits --agent claude-codeはエラー E009 で終了します。
アップデート後に悪化しましたか? sipcode regress
sipcode regress は、お使いの Claude Code と Codex のログを調べ、アップデートで発生したリグレッションを検出し、それぞれを引き起こしたバージョンを特定します。各バージョンをほかのバージョンと比較するため、外部のベースラインは不要で、データがマシンの外に送られることもありません。
出力例(あるマシンのログ。お使いの環境では数値が異なります):
sipcode regress · local only, no network
Claude Code: 27,671 interactive requests in 42 sessions (710 subagent and Agent SDK requests left out of the comparison), 2026-05-04 to 2026-10-12, versions 2.1.121 to 2.1.295
Known-regression windows your logs cover: R1, R4, R5
Codex: 930 requests in 15 sessions, 2026-03-28 to 2026-10-08, versions 0.118.0 to 0.162.0, 3 version/model groups with enough limit data
No regressions detected in your logs.
| チェック | 検出対象 | 検出できることが確認済みのリグレッション |
|---|---|---|
warm-cache-miss | コンテキストの大部分を書き換える、5 分未満の間隔で連続するリクエスト | R2:--resume のプロンプトキャッシュミス(2.1.69 から 2.1.89) |
post-idle-cold | 1 時間以上の中断後、次のリクエストでもキャッシュがコールドのままであること | R3:アイドル状態が 1 時間続いた後に思考履歴がクリアされる(2.1.85 から 2.1.100) |
ttl-5m | メイン会話のキャッシュが 1 時間ではなく 5 分の TTL で書き込まれること | R4:1 時間のキャッシュ TTL が 5 分に短縮される(2.1.129 で修正) |
uncached-input | ツールの結果直後のリクエストで、大量の入力がキャッシュされないこと | R1:Fable 5.1 のツールコンテキストがキャッシュされずに再送される(2.1.257 から 2.1.259) |
hourly-rebuild | 約 1 時間ごとにプロンプトキャッシュ全体が再構築されること | R5:OAuth の更新によってキャッシュが 1 時間ごとに再構築される(2.1.248 で修正) |
codex-limit-burn | 同じプランと利用期間で、ほかのバージョンよりもトークンあたりの上限消費量が多い Codex のバージョン | カタログにはありません |
- 既知のカタログにない検出結果は報告する価値のある兆候ですが、バグの証明ではありません。Codex の検出結果は、同時期にプランの上限が変更されたことが原因の可能性もあります。また、ほかのデバイスやクラウド上の Codex も同じ上限を共有します。
- サブエージェントと Agent SDK のリクエストは対象外です。設計上、キャッシュポリシーが異なるためです。
--bug-reportを指定すると、GitHub のイシューに貼り付けるブロックが追加されます。含まれるのはトークン数、バージョン、日付、短いセッション ID のみです。投稿する前に内容を確認してください。- スクリプトでは
--jsonを指定します。1 つのツールだけを対象にするには--agent claude-codeまたは--agent codexを指定します。チェックに必要なバージョンごとの最小リクエスト数を指定するには--min-n <n>を使います(デフォルトは 20)。 - ログを読み取れない場合(たとえば、サンドボックスによってフォルダーへのアクセスが妨げられている場合)は、「Nothing to analyse ... This is NOT a clean result.」と表示し、終了コード 2 で終了します。データが少なすぎる場合は、「Not enough data to compare versions yet」と表示します。一方のツールを比較でき、もう一方のログは読み取れたもののデータが少なすぎる場合は、そのツール名を表示します(「Not enough data to compare Codex versions yet」)。そのツールについて検出結果がないことは、問題がないことを意味しません。
- Sipcode とコードを共有しない独立したカウンター(
scripts/verify-counts.mjs)は、同じログからカバレッジ、各チェックのテーブル、regress --jsonの検出結果を再計算します。
Codex 内で Sipcode を使う
Sipcode プラグインを使うと、ChatGPT デスクトップアプリまたは Codex CLI で、自分の使用状況について普段の言葉で Codex に質問できます。回答はすべて、コンピューター上で sipcode コマンドを実行し、ローカルログを読み取って得られます。
ステップ 1. Sipcode を一度インストールする(Node.js 20 以降)、ターミナルで実行します。
npm i -g sipcode
プラグインは、インストール済みのこの sipcode を実行します。Codex のサンドボックスでは通常ダウンロードがブロックされるため、npx は使用しません。
ステップ 2. プラグインを追加する。 Codex の利用方法に合った手順に従ってください。
ChatGPT デスクトップアプリのみを使う場合(ターミナルで codex と入力すると、認識されないと表示される場合):
-
ターミナルを開き(Windows では PowerShell、macOS では Terminal)、次の 2 つのコマンドを実行します。
npx -y @openai/codex plugin marketplace add Anuj7411/sipcode npx -y @openai/codex plugin add sipcode@sipcodenpxは OpenAI の Codex CLI(npm パッケージ@openai/codex)をインストールせずに実行します。初回実行時にはダウンロードが行われ、1 分ほどかかることがあります。最初のコマンドでこのリポジトリをsipcodeというプラグインマーケットプレイスとして追加し、2 つ目のコマンドでそこから Sipcode プラグインをインストールします。どちらのコマンドも~/.codexに書き込みます。このフォルダーをデスクトップアプリがプラグインの読み込み元として使用します。 -
ChatGPT デスクトップアプリを完全に終了し、もう一度開きます。
-
Plugins を開いて、Sipcode が表示されていることを確認します(一覧に表示されない場合は、ソースとして
sipcodeマーケットプレイスを選択してください)。インストール済みとして表示されていない場合は、そこからインストールします。 -
新しいチャットを開始します。
OpenAI のドキュメントには、個人アカウントで GitHub からマーケットプレイスを追加するためのデスクトップアプリ内のボタンについて記載がありません。そのため、この手順では CLI コマンドを一度使用します。CLI をインストールしたままにする必要はありません。
Codex CLI を使っている場合(codex --version が動作する場合):
codex plugin marketplace add Anuj7411/sipcodeを実行します。codex plugin add sipcode@sipcodeを実行するか、Codex で/pluginsを開き、sipcodeマーケットプレイスを選択して Sipcode をインストールします。- 新しい Codex セッションを開始します。デスクトップアプリも使っている場合は、終了して再度開きます。
ステップ 3. 質問する:
| 質問 | Sipcode が実行するコマンド |
|---|---|
| 「今月、Codex にいくら使いましたか?」 | sipcode forecast --agent codex --json(today と stats も) |
| 「Codex の上限まであとどれくらいですか?減りましたか?」 | sipcode limits(現地時刻を確認するには、ターミナル出力を参照) |
| 「直近の Codex セッションがこんなに高くついたのはなぜですか?」 | sipcode why --agent codex --json |
| 「アップデート後、Codex または Claude Code の性能が落ちましたか?」 | sipcode regress --bug-report |
- Codex のサンドボックスが
~/.codexまたは~/.claudeへのアクセスをブロックすると、プラグインは空の結果を返すのではなく、読み取りアクセス権を付けてコマンドを実行する許可を求めます。 - 金額は API 料金での値です。ChatGPT プランでは、トークンごとに課金されるわけではありません。
- 回答には
sipcodeのターミナル出力と同じ形式で数値が表示されます。金額はセント単位、パーセントは整数、時刻は現地のタイムゾーンで示され、未加工の JSON 値は表示されません。 - このプラグインは手順のみで構成されています(4 つのスキル)。フック、MCP サーバー、ネットワーク呼び出しはありません。
- 新しい短いチャットで質問してください。Codex はリクエストごとに会話全体を再送信するため、長い作業チャットの最後に同じ質問をする場合、新しいチャットで尋ねるよりも上限を大幅に多く消費します。各回答では、事前の追加確認を行わず、Sipcode コマンドを 1 つ実行します。
- プラグインを後から更新するには、
npx -y @openai/codex plugin marketplace upgrade sipcode(またはcodex plugin marketplace upgrade sipcode)を実行し、デスクトップアプリを再起動して新しいチャットを開始します(チャットには、開始時に読み込まれたスキルの手順が保持されます)。sipcodeコマンド自体はnpm i -g sipcode@latestで更新します。
インストール方法(詳しい手順)
Sipcode は Mac、Linux、Windows で動作します。Node.js 20 以降が必要です。また、Codex が圧縮するセッションログ(.jsonl.zst)を読み取るには、Node.js 22.15 以降が必要です。
ステップ 1. Node.js をインストールする
すでに Node.js がインストールされている場合は、このステップをスキップしてください。そうでない場合は、以下を実行します。
- Mac:
brew install node - Linux: nodejs.org/en/download を開き、LTS バージョン、Linux、nvm を選択して、表示されるコマンドを実行します。(Ubuntu と Debian の独自リポジトリにある
nodejsパッケージは、Node 20 より古いことがよくあります。) - Windows: nodejs.org からダウンロードします
インストールできたことを確認します。
node --version
v20.0.0 以上が表示されるはずです。
ステップ 2. Sipcode をグローバルにインストールする
npm i -g sipcode
これにより、npm から Sipcode がダウンロードされ、どこからでも sipcode コマンドを使えるようになります。
Mac または Linux で権限エラーが表示された場合は、次を試してください。
sudo npm i -g sipcode
インストールできたことを確認します。
sipcode --version
1.7.2 以上が表示されるはずです。
ステップ 3. sipcode init を実行して Claude Code に組み込む
sipcode init
このコマンドは、次の 4 つを実行します。
- 現在のプロジェクトに小さな
.sipcode/manifest.mdファイルを作成し、プロジェクトの内容を Claude に伝えます - Claude の返答を簡潔に保つルールを含む小さなブロックを
CLAUDE.mdに追加します(ファイルがない場合は作成します) - Claude Code に Sipcode フックをインストールします。これが実際にトークンを節約する仕組みです
- 日付を記録し、後で
sipcode impactで導入前後の節約効果を確認できるようにします
実行中にチェックリストが表示されます。各ステップが完了すると、チェックマークが付きます。
尋ねられる 2 つの質問(および選択する内容):
1. マニフェストの上限。 Sipcode が挿入するプロジェクトの概要を、どの程度簡潔に保つかを指定します。
- tighten(推奨):情報量の少ないセクションを自動的に削り、概要を簡潔に保ちます。処理がブロックされることはありません。
- strict:マニフェストを 2k トークンに厳格に制限し、上限を超える場合は処理を拒否します。
- off:上限を設けません。マニフェストのサイズは無制限です。
2. 出力の圧縮ルール。 このプロジェクトで Claude の返答をどの程度簡潔にするかを指定します。
- default(推奨):差分形式で編集し、「以下が変更内容です」といった前置きを省きます。
- strict:最大限の簡潔さを求める上級者向けに、極端に短く、要点のみの返答にします。
- verbose:ツールの使い方をまだ学んでいる段階に適した、追加の背景情報や説明を含めます。
- skip:返答ルールをインストールしません。
迷った場合は、それぞれ推奨される選択肢を選んでください。どちらの選択も後で変更できます。返答スタイルは sipcode rules --mode <default|strict|verbose> を実行して変更し、概要を再生成するには sipcode manifest をもう一度実行します。
ステップ 4. 新しい Claude Code セッションを開く
Sipcode は、Claude が次にツールを呼び出したときに自動的に有効になります。ほとんどの場合、再起動は必要ありません。念のため、開いている Claude Code のウィンドウを閉じて、新しく開くこともできます。
これで、Claude Code はバックグラウンドで Sipcode を使用します。
ステップ 5. 約 1 時間作業した後に確認する
sipcode drift
sipcode proxy --stats
drift に「no drift」と表示され、proxy --stats に数十件の書き換えと節約効果が表示されれば、すべて正常に動作しています。
Sipcode の更新
Sipcode は自動で更新を確認することはありません。確認にはネットワーク呼び出しが必要ですが、通常の使用時にネットワーク呼び出しが一切発生しないことは、コードベースで保証されています(そうでない場合はテストが失敗し、ビルドが通りません)。更新は常に、手動で明示的に行います。
最新バージョンに更新するには:
npm i -g sipcode@latest
または、組み込みのヘルパーを使用します。
sipcode update # prints your current version + the update command
sipcode update --run # runs the update in place for you
更新後、sipcode --version でバージョンを確認し、CHANGELOG で変更内容を確認してください。MCP の設定を貼り直す必要はありません。Claude は再接続のたびにサーバーにツールを問い合わせるため、新しいツールは自動的に表示されます。
リリースの頻度: 修正や改善の準備ができ次第、パッチリリースを公開します。報告された問題から 1〜2 日以内に公開されることもよくあります。Sipcode は通知を送れないため(ネットワーク呼び出しが一切発生しません)、週に 1 回ほど sipcode update を実行する習慣をつけるとよいでしょう。確認は 1 秒で済み、新しいバージョンがあれば --run によってその場で更新されます。リリース情報を確認するには、リポジトリをウォッチまたはスターしてください。
提供される機能
| 機能 | 役立つ内容 |
|---|---|
| コンテキスト劣化の検出 | Claude Code のセッションの動作が普段より悪くなり始めたときに警告します |
| 再読み込みの重複排除 | ファイルの重複読み込みを検出してスキップし、トークンと時間を節約します |
| 圧縮の完全性スコア | 節約するたびに、元のシグナルの何パーセントが保持されたかを示します |
| 使用量の計測 | 日別、月別、予測値を表示します。すべてご自身のトランスクリプト(Claude Code と Codex)から取得し、クラウドにはアップロードしません |
| Codex の制限 | Codex の制限に達する時期、その原因、制限が縮小された可能性があるかどうかを示します |
| リグレッションチェック | Claude Code または Codex の更新でキャッシュや制限の動作が変わったかどうかを、バージョンごとに確認できます |
| Codex プラグイン | Codex に使用量、制限、リグレッションについて平易な言葉で質問できます |
| タスクコストの見積もり | コーディングタスクを実行する前に、Opus、Sonnet、Haiku でのコストを予測します |
| コードベースの健全性スコア | AI エージェントが作業しやすいかどうかを、リポジトリごとに 0〜100 で評価します |
| MCP サーバー | Claude Desktop 向けに 16 個のツールを登録するため、Claude 自身に使用状況を尋ねられます |
| 再現可能なベンチマーク | 誰でも実行して検証できる、固定された 20 タスクのコーパスです |
よくある質問
本当に無料ですか?
はい。MIT ライセンスです。トラッキングはありません。当社に送信されるテレメトリーもありません。有料プランもありません。GitHub でソースコードのすべての行を確認できます。
コードがどこかに送信されますか?
いいえ。Sipcode は通常の使用中にネットワーク呼び出しを一切行いません。すべてお使いのマシン上でローカルに実行されます。ソースにネットワーク関連のコードがインポートされているとテストが失敗する、プライバシーテストを用意しています。
実行を繰り返す際の速度を上げるため、Sipcode はご自身のディスク上の ~/.sipcode/ にいくつかのキャッシュを保持します(today と forecast 用のセッションログごとのトークン数、drift 用のセッションごとのメトリクス)。メッセージのテキストは一切保存せず、アップロードされることもありません。また、削除した場合は自動的に再構築されます。保存される情報とその保存場所の詳細は、PRIVACY.md をご覧ください。
ほかのコンテキストツールとの違いは何ですか?
比較ページをご覧ください。要点としては、Sipcode は公開済みの再現可能なベンチマーク、アーキテクチャによる誤った重複排除の完全な防止、セッション中のインストール対応を備えた唯一のツールです。
「コンテキスト劣化」とは何ですか?
Claude のコンテキストウィンドウが古くなった情報、繰り返された情報、または話題から外れた情報で埋まると、回答の品質が低下します。Sipcode は sipcode drift でこれを測定し、プロキシフックで無駄の大部分を取り除きます。
Cursor やほかの AI ツールでも使えますか?
プロキシ、フック、ルールは Claude Code で動作します。また、Sipcode は使用量分析のために OpenAI Codex のセッションログも読み取ります(stats、today、forecast、trend、impact、why、receipt、drift)。Codex で動作する機能と、まだサポートされていない機能については、Codex をご覧ください。Codex 自体では、Sipcode プラグインが使用量、制限、リグレッションに関する質問に回答します(Codex 内で Sipcode を使うをご覧ください)。Cursor では、sipcode rules --agent cursor を実行すると、出力圧縮ルールが Cursor のルールファイルに書き込まれます。Cursor のセッションログは読み取られません。
更新するにはどうすればよいですか?
npm i -g sipcode@latest
または sipcode update を実行すると、バージョンとコマンドを確認できます。sipcode update --run を実行すると、その場で更新できます。Sipcode は更新を自動確認しないため(ネットワーク呼び出しは一切ありません)、更新は常に明示的に行います。変更内容については、CHANGELOG をご覧ください。
アンインストールするにはどうすればよいですか?
sipcode proxy --uninstall
npm uninstall -g sipcode
コマンド
| コマンド | 内容 |
|---|---|
sipcode init | プロジェクトに Sipcode をセットアップします(マニフェスト + CLAUDE.md + プロキシフック) |
sipcode update | 最新バージョンへの更新方法を表示します(または --run で今すぐ更新します) |
sipcode hygiene | セッション衛生機能をインストールします:一度だけ読むルール + コンテキスト圧迫フック |
sipcode rules | CLAUDE.md の出力圧縮ルールをインストール、切り替え、または確認します |
sipcode manifest | プロジェクトのマニフェストを生成または更新します |
sipcode drift | 現在のセッションが通常の状態から逸脱しているか確認します(--session、--here、--agent) |
sipcode proxy --stats | このセッションでプロキシが検出した内容を確認します(--install / --uninstall も指定できます) |
sipcode benchmark | 検証可能な節約額を算出するため、固定された20タスクのコーパスを実行します |
sipcode estimate | タスクを実行する前に、モデルごとのコストを予測します |
sipcode today | 今日の支出を過去30日間の中央値と比較して表示します |
sipcode stats | 全セッションの累積トークン節約量を表示します(--html を指定すると、Claude Code 用に .sipcode/stats.html、Codex 用に .sipcode/stats-codex.html を書き出します) |
sipcode forecast | 過去14日間のデータから月末の支出を予測します |
sipcode limits | Codex の使用制限:現在のペースで制限に達する時期、使用量の内訳、時間経過に伴う1%あたりのトークン数を表示します |
sipcode regress | 更新後に Claude Code または Codex の性能が低下したか、各バージョンを他のバージョンと比較します |
sipcode trend | 指標を1つ、時間経過に沿って追跡し、改善しているか確認します |
sipcode why | セッションごとの詳細分析:トークンがどこで消費されたかを表示します |
sipcode impact | Sipcode 導入前後の支出をA/B比較します |
sipcode score | AI フレンドリー度をリポジトリで監査します(0~100、段階別バッジ付き) |
sipcode receipt | セッションの共有可能な PNG 領収書を生成します |
各コマンドの詳しいオプションは、--help を付けて実行してください。
ヒント:これらのレポートの対象となるセッションは? デフォルトでは、why、stats、today、forecast、trend、impact、receipt、drift は、作業中のフォルダーだけでなく、すべてのプロジェクトを対象にします。そのため、プロジェクト A で sipcode why を実行しても、プロジェクト B で直近のアクティビティがあれば、プロジェクト B の結果が表示されます。現在のプロジェクトだけに絞り込むには、--here を付けます(例:sipcode why --here または sipcode today --here)。Codex のセッションも同様です。すべてのセッションを確認するには sipcode why --list を使い、特定のセッションを選ぶには --session <id> を指定します。
必要条件
- Node.js 20 以降。Codex が圧縮するセッションログ(
.jsonl.zst)を読み取るには Node.js 22.15 以降が必要です。それより古い Node.js では対象ログがスキップされ、各レポートの先頭に警告が表示されます。 - Claude Code がインストールされていること(プロキシフックに必要です)。Sipcode は、Claude Code がインストールされていなくても、スタンドアロンの CLI ツール(benchmark、score など)として動作します。
- 任意:Codex の支出分析には OpenAI Codex CLI が必要です。
ライセンス
MIT。詳細は LICENSE をご覧ください。
謝辞
Claude Max プランを2時間で使い切るインディー開発者のために、心を込めて作りました。62.6% のベンチマーク手法については、benchmark/METHODOLOGY.md に記載しています。コンテキストウィンドウの品質に関する Anthropic の公開研究を、整合性スコアリングの手法に反映しています。
コメント
AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。