如果有人在 2026 年 5 月告诉你,他能帮你把 Claude Code 的账单砍掉 60%,方法是把你的提示词渲染成图片再发给模型,你大概率会觉得他在搞行为艺术。正常人的逻辑是:图片比文字大得多,怎么可能省钱。
但 pxpipe 证明了这个反直觉的逻辑是对的。Anthropic 对图片 Token 的计费是按像素尺寸算的,图片里塞了多少字符,账单不关心。一张 1928×1928 的 PNG 约 4761 个视觉 Token,能装下约 92000 个字符的密集内容。同等数量的字符走纯文本通道,要约 25000 Token。三倍的效率差。
这不是理论推演。pxpipe 在真实 Claude Code 会话上的测量结果是端到端账单降 59% 到 70%。截至 2026 年 7 月底,项目发布不到三个月,GitHub 上已经攒了 6700+ Stars。HackerNews 上有人把它称为”Token 套利时代的第一面旗”。
说白了,pxpipe 做的事情本质上是一个定价机制的巧妙利用。它不优化模型、不压缩语义、不改写提示词。它就是换了一条计费通道。而这条通道 Anthropic 自己早就铺好了,原本是给截图用的。
打动我的几个地方
pxpipe 的核心机制简单得有点粗暴:本地起一个代理,劫持 Claude Code 发出去的 API 请求,把请求里那些臃肿但不要求精确识别的文本块渲染成 PNG,然后把改写后的请求转发出去。系统提示词、工具文档、旧的历史记录,每个请求都要带着的静态大块,是主要的压缩对象。
它不做的事同样重要。最近的对话轮次保持纯文本,因为当前在跟模型说的内容需要逐字精确。字节精确的数据,比如哈希值、密钥、ID,不碰,因为这些在图片里读错了没有报错机制,模型会直接给你编一个。静态系统提示词如果本身就在 Anthropic 的缓存窗口内,pxpipe 会自动跳过,不去破坏已有的缓存折扣。

仪表盘设计得很实用。浏览器打开 localhost:47821,你能看到每一轮的 Token 节省量、哪些文本被转成了图片的对照、以及一个一键关闭的开关。透明性对于这类”你也不知道它到底改了啥”的中间件来说,比任何功能都重要。
离线导出模式是个被低估的功能。npx pxpipe-proxy export src/ 直接把整个目录渲染成一组 PNG 页面,附带一个 factsheet 文本文件。你可以把这些页面丢给任何支持图片上传的 AI 客户端。不跑代理的时候也能用,相当于把”密集视觉上下文”从代理逻辑里抽出来,变成一个通用能力。
多模型支持方面,pxpipe 从最初只针对 Fable 5 优化,扩展到支持 Anthropic Messages、OpenAI Responses 和 Google generateContent 三种 API 格式。默认只对 claude-fable-5 和 gpt-5.6 启用压缩,其他模型需要手动加入白名单。这个保守策略是对的,不同模型对密集图片的识别能力差异太大。
最后是 Docker 部署和库模式。不想污染本地环境,docker compose up 就能跑起来。想嵌入自己的工具链,import { renderTextToImages } from "pxpipe-proxy" 一行搞定。TypeScript 实现,纯 JS runtime,没有原生依赖的编译负担。
但这些亮点背后,有一个你必须在用之前就想清楚的问题:你到底愿意接受多大程度的信息损失。pxpipe 跑到 60% 的节省,代价是有损的。这个问题往下展开聊。
跑起来看看
安装只需要 Node.js 18 以上,没有任何额外的系统依赖。一行命令启动代理,代理跑在本地的 47821 端口:
npx pxpipe-proxy
启动后,把 Claude Code 的 API 请求指向这个本地代理即可:
ANTHROPIC_BASE_URL=http://127.0.0.1:47821 claude
如果你的 Claude Code 环境不方便改环境变量,用 warp 模式可以绕过这个限制。原理是 CONNECT 代理,不需要设置 ANTHROPIC_BASE_URL:
pxpipe warp -- claude

仪表盘自动在 http://127.0.0.1:47821/ 上线,左边是实时 Token 节省,右边是每轮转换的文本到图片对照。所有请求事件记录在 ~/.pxpipe/events.jsonl,你可以事后算账。作者在 demo 视频里展示了一个完整的 session 对比:同一个任务,纯文本花了 $42.21,pxpipe 只花了 $6.06。当然这是极端密集场景,日常使用不太可能达到 85% 的夸张降幅。
实际跑起来的感受是,对话流畅度没有明显变化。响应流正常播放,因为 pxpipe 只压缩请求不碰输出。压缩本身会增加请求前的延迟,大型请求的 PNG 编码需要几百毫秒,大部分淹没在网络往返里,感知不强。偶尔有极端情况,一个请求里几十个 tool_result 块同时被压缩,会多等一两秒。
几个常见坑:Windows 用户需要用社区维护的 pxpipe-windows 分支,官方主要支持 macOS 和 Linux。如果你在用 Opus 模型,pxpipe 默认不会对它启用压缩。因为实测 Opus 对密集图片的十六进制字符串识别率是 0/15,远低于 Fable 5 的 13/15,压缩等于白扔信息。
跑起来的体验说完了,但你大概已经在想了:省了这么多 Token,模型真的还能读懂压缩后的内容吗?往下看适用场景,答案比简单的”能”或”不能”复杂。
什么时候用,什么时候别用
| 场景 | 典型用户 | 优势 | 局限 |
|---|---|---|---|
| 长会话编程 | Claude Code 重度用户 | 端到端省 59-70%,历史轮次自动压缩 | 精确字符串不可靠 |
| 批量代码分析 | 需要读大量文件的 Agent | 一次渲染整个目录树 | 大文件编码延迟 |
| 研究文档审阅 | 需要给 AI 塞大量背景 | 离线导出任意内容 | CJK 保守,效果不如英文 |
| 自动化流水线 | CI/CD 中的 Agent 调用 | API 直接调用,无需手动 | 需确认模型白名单 |
不适用的情况:
-
你需要精确的代码引用、文件路径匹配、或者 git diff 级别的逐行对比。这些场景下图片压缩的信息损失会在三四轮对话后积累成明显偏差。 -
你用的是 Opus 或其他视觉能力较弱的模型。pxpipe 对 Opus 的误读率约 7%,且默认不启用压缩。用了反而可能更贵,因为模型读错了会多跑几轮纠错。 -
你的会话通常很短,压缩顶多省几百 Token。这类场景用 Anthropic 官方的 prompt caching 就够了,零风险。
场景表看着很清晰,但有个问题还没回答:这个项目能活多久?这得看看社区。
社区怎么样了
| 指标 | 数据 | 说明 |
|---|---|---|
| Stars | 约 6700(截至 2026 年 7 月底) | 45 天内从 0 冲到 6.7k,峰值日增 1600 |
| 核心维护者 | 约 1-2 人(Bus Factor 中高风险) | teamchong 几乎是单人维护 |
| 提交次数 | 402 | 极其活跃,日均 3-4 次提交 |
| 协议 | MIT | 商业友好,无使用限制 |
增长速度值得单聊。pxpipe 在 7 月 4 日冲上 GitHub Trending 榜首,当天收 1.6k Stars。HackerNews 讨论帖拿到 249 分。这个爆发速度在一众 Token 优化工具里是独一档的。
但 Bus Factor 是个明显的红灯。teamchong 几乎是唯一的核心维护者,社区参与者主要在提 Issue 和 PR 而非负责模块。Commit 节奏虽然凶猛,但如果维护者突然停更,项目几乎没有备选接手方案。我在 Issue 区看到有用户调侃”如果作者被 Anthropic 招安了怎么办”,玩笑背后是真实的可持续性风险。
社区已经孵化了两个第三方项目:pxpipe-windows 解决了 Windows 平台的 mitm 证书问题,OmniGlyph 被 OmniRoute 集成作为视觉上下文渲染模块。核心思路正在被其他工具吸收,这对一个只有两个月的项目来说是个好兆头。
社区数据翻完了,但说真的,Stars 和 commits 只能告诉你过去发生了什么。更关键的问题是:pxpipe 到底值不值得把它塞进你的日常工具链里?
我的真实看法
pxpipe 最让我感兴趣的不是它省了多少 Token,而是它揭示了一个更大的趋势:视觉通道正在变成 LLM 应用的隐藏入口。Anthropic 给 Fable 5 做了强大的视觉理解能力,本意是处理截图和文档扫描。但开发者发现这个通道的定价机制跟文本通道不一样,于是开始用它来传输密集文本。这不是设计内的用法,但也不是漏洞,是一个被发现的新路径。

风险也很清楚。pxpipe 的经济模型建立在定价差异上。如果 Anthropic 调整了图片 Token 的定价,或者给密集文本图片加了特殊计费规则,pxpipe 的基础就消失了。作者在 README 里也坦诚地写了:价格会变、负载不同,唯一耐久的数字是 Token 削减量本身。
技术层面,有损压缩是个绕不过去的硬限制。SWE-bench 测试中,pxpipe 和纯文本在 Lite 难度都拿了 10/10,在 Pro 难度 pxpipe 是 14/19 而纯文本是 15/19。差距只有一题,Pro 级别的题目总数本来就少,统计上不算显著。但工程上意味着边缘情况你可能会丢分。如果你的任务对精度要求极高,这一题的差距可能就是分界线。
我把 pxpipe 定位为”暂时有效的套利工具”,而不是”成熟的成本优化方案”。它对 Fable 5 用户来说值得用,因为 Fable 5 的视觉理解足够强,误读率低,省下来的钱是真实的。对于 Opus 用户、对精确度有洁癖的开发者、或者刚接触 Claude Code 还在学怎么用的人,建议先观望。省下来的 Token 不够填误读带来的纠错成本。
说到替代方案,pxpipe 不是唯一在跟 Token 账单较劲的工具。caveman 走的是改写路线,把提示词和输出压缩成极简语法,不碰图片,没有误读风险,代价是表达能力打折。RTK(Rust Token Killer)专注过滤终端输出的噪声,在 git status 类型的场景省 80%,但它是单向过滤,不处理系统提示词和历史记录。更安全的选择是 Anthropic 官方的 prompt caching,零风险但省得少。这三者跟 pxpipe 不互斥,caching 打底加 pxpipe 压大块静态内容,是目前最务实的组合策略。
资源地址
| 资源 | 地址 |
|---|---|
| GitHub | https://github.com/teamchong/pxpipe |
| npm | https://www.npmjs.com/package/pxpipe |
先用 Docker 跑一周再说
如果你已经在用 Fable 5 跑 Claude Code,并且每个月光 API 账单就让你肉疼,pxpipe 值得你花一个下午试试。从 Docker 部署开始,跑一周看看 events.jsonl 里的节省数字是不是真实的。嫌手动设置环境变量麻烦就用 warp 模式,一行命令搞定。
如果你还在观望,盯两个指标:Anthropic 对视觉 Token 定价的任何调整声明,以及 pxpipe 的 Issue 区有没有突然出现大面积的图片识别出错报告。第一点决定了这门生意的经济基础还在不在,第二点决定了实际可用性有没有退化。
Token 套利这门生意不会永远存在。但在它消失之前,先把账单降下来,不丢人。说到最后,pxpipe 的价值不在它能省多少钱,而在于它提醒了我们一件事:大模型的定价体系比它们的推理能力变化得更快,而最先发现这些变化的,从来不是官方。
