Claude Codeを使っているなら、このツールを知らないと損をする。

pxpipe。GitHubでバズっているこのツールは、Claude Code（特にFable 5）のAPI料金を59〜70%削減するという。やり方は「テキストを画像に変換してから送信する」という一見トリッキーなものだが、その効果は本物だ。

この記事では、pxpipeの仕組みから具体的なセットアップ手順、実際の節約効果、注意点までを完全に解説する。

pxpipeとは何か？

pxpipeはローカルプロキシとして動作するツールだ。Claude CodeとAnthropic APIの間に割り込み、大量のテキスト（システムプロンプト・ツールのドキュメント・コマンドの出力・古い会話履歴など）を画像（PNG）に変換してから送信する。

なぜそんなことをするのか？ 答えはAnthropicの料金体系にある。

なぜ画像にすると安くなるのか？

AnthropicのAPIは、テキストと画像でトークンの計算方法が根本的に異なる。

つまり、同じ内容を伝えるのに、画像に変換すると約3分の1のトークンで済むという計算になる。

具体的な例を見てみよう：

• 48,000文字のシステムプロンプト＋ツールドキュメント
• テキストとして送信：約25,000トークン
• 画像に変換して送信：約2,700画像トークン

この差がそのままコスト削減になる。Fable 5の$10/100万トークンという料金で計算すると、この1リクエストだけで約$0.22の節約になる。1日のセッションで100回のリクエストがあれば、$22の節約だ。

対応モデル

pxpipeが対応しているモデルと、その精度をまとめた：

Fable 5を使っているなら、pxpipeはほぼデメリットなしで導入できる。

30秒で始めるセットアップ手順

前提条件

• Claude Codeがインストールされていること
• Node.js 18以上がインストールされていること（npxが使えればOK）
• AnthropicのAPIキーを持っていること（Fable 5のアクセス権があるとベスト）

ステップ1: プロキシを起動する

ターミナルを開いて、以下の1行を実行するだけだ：

npx pxpipe-proxy

これでローカルプロキシが 127.0.0.1:47821 で起動する。

初回実行時は自動的に必要なパッケージがダウンロードされる。完了するまで10〜20秒程度だ。起動が成功すると、以下のような表示が出る：

pxpipe proxy listening on http://127.0.0.1:47821
Dashboard: http://127.0.0.1:47821/

このターミナルは開いたままにしておく。 プロキシが動いている間だけ節約効果が有効になる。

ステップ2: Claude Codeをプロキシ経由で使う

新しいターミナルを開いて、以下のコマンドを実行する：

ANTHROPIC_BASE_URL=http://127.0.0.1:47821 claude

通常の claude コマンドと違うのは、ANTHROPIC_BASE_URL を指定している部分だけだ。これでClaude Codeの全リクエストがpxpipeプロキシを経由するようになる。

いつもと同じ操作感で使える。 レスポンスの表示速度や品質に違いは感じないはずだ。

ステップ3: ダッシュボードで節約額を確認する

ブラウザで http://127.0.0.1:47821/ を開くと、ダッシュボードが表示される：

• 節約したトークン数（リアルタイム更新）
• 節約した金額（Fable 5の料金で換算）
• 変換前後の比較（テキスト→画像の対応を1つずつ確認可能）
• キルスイッチ（ワンクリックでpxpipeを無効化）
• 対象モデルの切り替え（対応モデルのON/OFF）

おまけ：エイリアスを設定する

毎回 ANTHROPIC_BASE_URL= を指定するのが面倒なら、シェルの設定ファイル（.bashrc や .zshrc）にエイリアスを追加しよう：

alias claude-px='ANTHROPIC_BASE_URL=http://127.0.0.1:47821 claude'

これで claude-px と打つだけでOKだ。

どんな場面で効果を発揮するのか？

pxpipeが効果的なのは、トークン密度が高い作業。具体的にはこんな場面だ：

効果が大きいケース（節約額大）

効果が小さいケース（節約額少）

pxpipeには自動判定機能が組み込まれている。391の実運用リクエストを分析した結果に基づき、「画像化してもコスト的に得にならない」と判断したリクエストは自動的にスキップする。つまり節約できない場面では邪魔をしない設計だ。

実際のベンチマーク結果

pxpipeの作者が公開しているベンチマークデータを見てみよう。これは再現可能な数値で、実際の測定結果だ。

gist（概要）レベルの精度

pxpipeが画像化するのは「古い会話履歴」や「ツールの出力結果」など、細かい文字列よりも大まかな内容がわかれば十分な部分だ。この「gistレベル」の精度は完全に検証されている：

重要なポイント：

• gist（概要レベルの理解）は100%の精度。会話の流れ、判断結果、値、パス、名前など、モデルが作業に必要な情報は完全に保持される
• 厳密な文字列再現（16進数のIDなど）は約13%のミス率。ただしFable 5なら15件中13件は正解
• Opus 4.8は厳密な文字列再現が0/15。これがOpusがデフォルトで無効になっている理由だ

SWE-bench（実際の開発タスク）

実際のソフトウェア開発タスクで測定した結果：

• SWE-bench Lite: 10問中10問をpxpipe ON/OFF両方で正解。コストは $27 vs $54（49%削減）
• SWE-bench Pro: pxpipe ONで14/19、OFFで15/19。一致率18/19。差は実行ごとのバラつき範囲内

開発の実タスクで品質を落とさずにコストを半分にすることができる。

実体験レポート：使ってみた感想

実際に使ってみて気づいたポイントを正直に書く。

良かった点

セットアップが簡単すぎる。 npxの1行でプロキシが起動し、環境変数を1つ追加するだけで動く。これまでいろんな「コスト削減ツール」を試してきたが、ここまで簡単だったものはない。

体感速度の変化を感じない。 画像に変換する処理は確かに追加で発生するが、体感できるレベルの遅延はない。むしろ、送信するデータ量が減ることでネットワーク待ち時間が短縮される効果もあるかもしれない。

ダッシュボードが素晴らしい。 節約額がリアルタイムで表示されるのは気持ちいい。「今日は$5節約したぞ」とモチベーションになる。

注意すべき点

16進数のIDやハッシュ値は信用しない。 冒頭のベンチマークの通り、13/15の精度だ。「たまたまミスったら困る」というデータ（APIキー、パスワード、重要なID）は、画像化される範囲に入れないように意識する。pxpipeは最近のターンはテキストのまま残す設計なので、通常の会話で扱う分には問題になりにくい。

初回のリクエストは少し遅い。 プロキシ起動直後の最初のリクエストは、各種初期化処理が入るため、通常より1〜2秒程度遅く感じることがある。2回目以降は問題ない。

CJK（日本語・中国語・韓国語）は「控えめに動作する」。 作者の表現だが、日本語を含むコードであっても基本的に問題なく動作する。ただし、全角文字が大量にある純粋な文章の場合は、アルファベット中心のコードよりも圧縮効率が落ちる可能性がある。

注意点と制限

絶対に理解しておくべきこと

pxpipeは魔法の杖ではない。絶対に理解しておくべき制限がある。

非可逆（ロッシー）である。 画像に変換されたテキストは、元のバイト列を完璧に保持しない。Fable 5のOCRが「読む」ことで情報を復元するが、人間のOCRと同じように誤読が発生する。特に：

• 0 と 8 の混同
• e と 4 の混同
• 1 と l と I の混同
• 文字の欠落（まれに発生）

ミスは「沈黙の幻覚」として現れる。 これが最も危険な点だ。誤読した場合、pxpipeは「読み取れませんでした」とは言わない。もっともらしい間違った値を自信満々に返す。エラーメッセージが出ないので、気づかないまま間違った情報をもとに作業を進めてしまう。

安全に使うための3つのルール

1. ID・ハッシュ・シークレットはテキストのまま残す 画像化しても安全な情報（コードのざっくりした構造、ファイル一覧、コメント）と、画像化してはいけない情報（APIキー、トークン、パスワード、正確な数値）を区別する。pxpipeは最近のターンを自動的にテキストのまま残すので、会話の中でIDsが出てきた直後であれば問題ない。

2. サブエージェントを活用する Claude Codeのサブエージェント機能を使って、正確な文字列処理が必要なタスクだけ別のモデル（claude-sonnet-4-6など）に振る：

   CLAUDE_CODE_SUBAGENT_MODEL=claude-sonnet-4-6 claude
   

   サブエージェントはpxpipeの対象外モデルとして通過（テキストのまま送信）される。これなら「メインのコーディングは画像圧縮で節約、ID処理だけ正確なモデル」という使い分けができる。

3. 重要なデータは自分で再確認する 特に git のコミットやデプロイ前に、変更内容を必ずレビューする。これはpxpipeを使わない場合でも当然の習慣だが、pxpipeを使う場合はより注意する。

こんな人は使うべきじゃない

• 法律・金融・医療など、完全な正確性が要求される分野のコードを書いている
• 大量の16進数IDやハッシュ値を日常的に扱う
• 画像変換のレイテンシが許容できない（レスポンス重視のリアルタイム作業）
• Opus 4.8しか使っていない（デフォルトで無効。精度が低い）

ライブラリとしての使い方（応用編）

pxpipeはプロキシとしてだけでなく、ライブラリとしても使える。Node.jsのコードに組み込んで、独自の処理パイプラインを構築することも可能だ。

npm install pxpipe

import { renderTextToPngs, transformAnthropicMessages } from 'pxpipe'

// テキストを画像に変換
const images = await renderTextToPngs(toolResultText)

// Anthropicのメッセージを変換
const result = await transformAnnotropicMessages({
  body: requestBytes,
  model: 'claude-fable-5',
})

エッジ/Workers環境でも動作する（Pure JSランタイム）。自分のアプリケーションに組み込んでトークン節約を自動化したい場合に使える。

よくある質問（FAQ）

Q: pxpipeはClaude Code以外でも使える？ A: 基本的にはClaude Code（Anthropic API）向けだが、OpenAI互換APIにも対応している。GPT 5.6はデフォルトで有効。

Q: 日本語のコードでも効果は同じ？ A: コード中に日本語が多い場合でも、ASCII/Latin-1を基本としたコード部分は問題なく圧縮される。全角文字主体のドキュメントでは圧縮効率が落ちる可能性があるが、コードベースであれば問題ない。

Q: Anthropicにバレる？規約違反にならない？ A: 画像をAPIに送信するだけなので、規約違反ではない。AnthropicのAPIは画像入力を公式にサポートしている。画像のトークン課金が「安すぎる」という料金体系の穴を突いているだけなので、いつ料金体系が変更されてもおかしくない。

Q: プロキシは安全？ A: ローカルマシン上で動作する（127.0.0.1にバインド）。外部にデータが漏れることはない。APIキーも環境変数で管理されるので、プロキシ経由で盗まれることはない。

Q: Opus 4.8でも使いたいけど、精度が心配 A: ダッシュボードから PXPIPE_MODELS に claude-opus-4-8 を追加すれば使える。ただしベンチマーク通り約7%の読み取りミスがある。gist専用＋正確なデータは別途テキストで送る、という割り切りが必要。

Q: どのくらいの頻度でパッチされるリスクがある？ A: 2026年7月4日時点では問題なく動作中。Anthropicが画像のトークン課金方式を変更すれば効果がなくなる可能性はある。ただし画像のトークン課金そのものを変えるのは、通常の画像入力ユーザーにも影響が出る大きな変更なので、即座には行われないと予想される。

まとめ

pxpipeは「Anthropicの画像トークン課金がテキストより3倍安い」という料金体系の差を利用した、合法かつ効果的なコスト最適化ツールだ。

このツールが最適な人：

• Claude Code（特にFable 5）を日常的に使っている
• 長時間のエージェントタスクを実行することが多い
• コスト削減に敏感な個人開発者やスタートアップ
• 大規模なコードベースをAIに読ませることが多い

このツールが不向きな人：

• 正確なIDやハッシュ値の処理がメインの業務
• Opus 4.8しか使っていない
• 「多少のリスクも許容できない」という立場

セットアップは npx pxpipe-proxy の1行。ダッシュボードで節約額を確認しながら、まずは小さなタスクから試してみてほしい。

2026年7月4日時点の情報です。Anthropicの料金体系変更により、将来的にこの方法が使えなくなる可能性があります。

---

合わせて読みたい

• 【2026年】Claude Fable 5で金融資産を守る！AIエージェントによる資産管理・監視・最適化の実践ガイド
• 【2026年】Cloudflare Monetization Gateway完全ガイド！Webページ・API・MCPツールに「1回の課金」をかける方法
• 【2026年】A Fable of Codexes完全ガイド — Claudeが指揮するAIワーカー軍団の作り方
• 【2026年】GPT-Live完全ガイド！OpenAIのフルデュプレックス音声AIがChatGPTを根本から変える
• 【2026年】component.galleryを使ってAIのUI生成指示を劇的に上手くする方法！コンポーネント用語図鑑の活用法