DeepSeek V4 の API でプログラミングタスクを回しているなら、長時間セッションの token 消耗はかなり痛いはずです。オープンソースプロジェクト Reasonix は DeepSeek 専用のキャッシュ最適化ソリューションを提供し、キャッシュヒット率を 99.82% まで高め、61 米ドルだった請求額を 12 米ドルまで引き下げました。実質、2割の価格に値引きされたのと同じです。

本記事では Reasonix の仕組みと使い方を紹介します。

• GitHub：「Reasonix」で検索すれば見つかります

Reasonixとは

Reasonix は DeepSeek 専用に作られたターミナル向け coding harness（コーディングエージェントツール）です。その核心の目的はただひとつ、コスト削減です。

具体的には、キャッシュヒット率を最適化することで、長時間セッションの入力 token コストを元の 1/5 まで下げます。

中核技術：キャッシュ優先ループ

Reasonix の鍵となる設計は、バイト単位で安定した prefix-cache に基づく append-only の実行ループです。

DeepSeek の自動プリフィックスキャッシュ（prefix-cache）は、現在のリクエストの厳密なバイトプリフィックスが過去のリクエストと一致した場合にのみ有効になります。大多数の Agent ループは毎回のインタラクションでメッセージを並べ替え、書き換え、新しいタイムスタンプを注入するため、キャッシュが失効してしまいます。

3ゾーンのコンテキスト分割

Reasonix はコンテキストを3つのゾーンに分割します：

1. 固定プリフィックスゾーン：システムプロンプトとプロジェクトコンテキスト。セッションごとに1回だけ計算され、以後一切動きません
2. 履歴ログゾーン：履歴メッセージは追記のみで書き換えず、バイトプリフィックスの一致を常に保証します
3. ドラフトゾーン：現在のターンの作業領域。情報はログに組み込まれる前に Tool-Call Repair で精錬されます

この設計により、プリフィックスは固定、履歴は追記のみ、ドラフトは変更可能となり、3つのゾーンがそれぞれ役割を担ってキャッシュヒットを最大化します。

ツール呼び出しの修復（Tool-Call Repair）

DeepSeek のツール呼び出しには、いくつかよくある問題があります：

• ツール呼び出しの JSON は内部で生成済みなのに、最終メッセージから消えている
• JSON パラメータの変形
• 同じツールが完全に同一のパラメータで重複呼び出される
• JSON が途中で切断される

Reasonix はこれらの問題を4ラウンドの自動修復で処理し、実際の実行前に修復を試みることで、無効なリクエストによる token の浪費を防ぎます。

コスト制御戦略

Reasonix には3層のコスト制御メカニズムがあります：

1. デフォルトで安価なモデルを使用

デフォルトでは v4 flash を優先的に使用し、難しいタスクでのみ pro に切り替えます。

2. 自動コンテキスト圧縮

ターン終了後にコンテキストを自動で圧縮し、以降のリクエストの token 数を減らします。

3. 失敗時の自動アップグレード

ユーザーは /pro と手動入力すれば、次のターンを v4 pro に切り替えられます。このターンが終わると Reasonix は自動で安価なモデルに戻します。失敗回数が警戒ラインに達すると、現在のターンの残り部分も自動的に v4 pro へ切り替わります。

クイックインストール

2ステップで実行でき、グローバルインストールは不要です：

# 1. 进入项目目录
cd your-project

# 2. 启动 Reasonix
npx reasonix code

起動すると TUI（ターミナルユーザーインターフェース）が開き、そのまま使い始められます。初回実行時に DeepSeek API キーが自動で設定されます。

ヒント：DeepSeek API キーを環境変数に設定しておくか、指示に従って入力してください。

実際の効果

Reasonix のテストデータによると：

適用シーン

• 長時間セッションのプログラミングタスク：DeepSeek と多ターン対話する開発作業
• コードリファクタリング/移行：継続的なコンテキストが必要な大規模なコード修正
• 継続的インテグレーションのシーン：自動化パイプライン内の AI プログラミングタスク
• コストに敏感なチーム：API 出費を管理したい開発チーム