@aizigao/pi-claude-code-headers-compat
让Pi请求头更像Claude Code，绕过Cloudflare拦截
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：@aizigao/pi-claude-code-headers-compat。 它的用途是：让Pi请求头更像Claude Code，绕过Cloudflare拦截 完整的 Skill 内容见：https://321skill.com/skills/aizigao-pi-claude-code-headers-compat/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
'帮我安装pi-claude-code-headers-compat，并配置我使用的aicoding.sh提供商，避免请求被Cloudflare拦截返回403。' 它会自动执行安装命令，并在`~/.pi/agent/claude-code-headers-compat.json`中生成适配规则，之后所有向aicoding.sh的请求都会自动添加类似Claude Code的请求头。
介绍
这个Skill解决了Pi使用anthropic-messages API时，因请求头与Claude Code不一致而被Cloudflare误判为爬虫流量（返回403）的问题。在实际开发中，许多代理提供商对非标准请求头敏感，导致Pi的请求被拦截，无法正常调用Claude模型。
使用方式很简单，你只需要在Pi中执行pi install npm:@aizigao/pi-claude-code-headers-compat安装该扩展包，然后在~/.pi/agent/claude-code-headers-compat.json中配置需要兼容的提供商规则。之后Pi向匹配的提供商发送请求时，会自动重写请求路径并调整请求头，使其更接近Claude Code的原始行为。
它非常适合已经配置了自定义提供商（如aicoding.sh）且遇到403错误的Pi用户。尤其是那些需要同时使用多个Claude兼容代理，又不想手动修改Pi底层请求逻辑的开发者。对于企业级代理环境或严格防火墙后的场景尤其有用。
建议在配置时先测试单个提供商，确认兼容规则生效后再批量应用。需要注意的是，它只修改请求头和路径，不改变models.json的提供商结构，因此与Pi的原有配置完全兼容。如果遇到新的兼容问题，可以调整配置文件中的适配规则。
常见问题
安装后会影响其他不匹配的提供商吗？
不会，它只对兼容配置文件中列出的提供商生效，其他提供商请求保持原样。
如果Cloudflare更新了防护策略怎么办？
可以更新`claude-code-headers-compat.json`中的规则，或者等待包作者发布新版本适配。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/aizigao-pi-claude-code-headers-compat/raw/index.md 读取 @aizigao/pi-claude-code-headers-compat 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/aizigao-pi-claude-code-headers-compat/raw/index.md（查看排版版本）