内容提要
Pi Black是一个非官方扩展包,通过模拟Claude Code请求格式,让Claude Pro或Max订阅用户能在Pi编码代理中使用订阅用量,绕过Anthropic对第三方工具的限制。它修改认证流程,复用订阅,但存在账号封禁风险和法律灰色地带,且版本兼容性严格,需谨慎使用。
延伸解读
技术原理与风险并存
Pi Black通过模拟Claude Code 2.1.224的请求格式,包括账单系统块顺序、校验和、请求ID等,使Anthropic服务器误认为请求来自官方终端,从而复用订阅用量。但这种伪装并非无懈可击,Anthropic可能通过检测请求模式或更新协议来封堵,且账号封禁风险明确存在。开发者已在README中声明免责,用户需自行承担后果。
版本兼容性限制
Pi Black对Pi版本要求严格,仅支持0.84.1、0.84.2、0.84.3三个版本,且Claude Code协议版本锁定在2.1.224。这意味着一旦Anthropic更新协议或Pi发布新版本,Pi Black可能立即失效,需要开发者跟进更新。用户在使用时需注意版本匹配,否则可能无法正常加载或工作。
订阅条款与封号风险
Anthropic消费者条款明确禁止将订阅用于第三方工具,2026年3月官方已宣布不再覆盖OpenClaw等工具。Pi Black的使用属于灰色地带,用户可能面临账号封禁。GitHub讨论中已有用户反馈账号被限制的案例,但具体封禁标准未知。建议用户权衡风险,谨慎使用。
Q&A
Pi Black是什么?它如何让Claude Pro订阅在Pi中使用?
Pi Black是一个非官方的Pi扩展包,通过修改Pi的Anthropic认证流程,模拟Claude Code 2.1.224的请求格式,使Anthropic服务器误认为请求来自官方终端,从而允许Claude Pro或Max订阅用户在其他工具(如Pi)中使用订阅用量,而无需额外购买API额度。
Pi Black修改了哪些技术细节来模拟Claude Code?
Pi Black精确复现了Claude Code的请求格式,包括账单和Agent SDK系统块的精确排序、提示词相关的cc_version后缀、使用seeded XXH64计算的结构化cch校验和、每个请求唯一的x-client-request-id、Claude Code会话头,以及自动发现的身份元数据(如果有)。
安装Pi Black有哪些方法?对Pi版本有什么要求?
安装Pi Black有两种方法:一是通过Pi包安装,使用命令`pi install git:github.com/paoloanzn/pi-black`,可加tag锁定版本;二是独立二进制安装,适用于macOS和Linux,使用curl命令。Pi Black只支持Pi 0.84.1、0.84.2、0.84.3三个版本,其他版本会拒绝加载。
使用Pi Black有哪些风险?
使用Pi Black存在账号封禁风险和法律灰色地带。Anthropic的消费者条款明确禁止将订阅用于第三方工具,2026年3月官方宣布订阅不再覆盖第三方工具使用。Pi Black开发者也在README中声明项目非官方,用户需自行承担风险。
Pi Black与pi-doppelclaude等类似工具相比有什么不同?
Pi Black通过模拟Claude Code的请求格式来伪装成官方客户端,而pi-doppelclaude等工具则通过Agent SDK加载订阅,并暴露钩子让用户替换系统提示词以绕过检测。Pi Black走的是“伪装”路线,而其他工具是“绕墙”路线。
Pi Black是否读取用户的Claude身份信息?
Pi Black会在内存中读取Claude Code状态文件(~/.claude.json)中的安装ID和账户UUID,并添加到请求元数据中,但不会复制、打印或持久化这些值。即使没有这些元数据,订阅路由功能依然正常工作。
Claude Code 2.1.224版本有什么新功能?Pi Black为何锁定该版本?
Claude Code 2.1.224版本在2026年8月第一周发布,主要更新是跨会话消息传递,允许不同终端会话互相通信。Pi Black锁定该版本是因为它需要匹配该版本的请求格式,以便伪装成官方客户端。