扩展做什么
Pi 从 ~/.pi/agent/models.json 读取自定义的 OpenAI 兼容 provider。手工编辑这个文件可用,但模型列表会在新增或下架模型当天就过期。
官方扩展把 anyrouter 注册为 provider,并从 https://anyrouter.dev/api/v1 刷新目录,所以 pi 里的 /model 列出的是 AnyRouter 当天能路由的模型。它把流式请求交给 pi 内置的 openai-completions 实现,所以工具调用、用量统计和取消都保持可用。
安装
两个选项。想要实时目录就用扩展,想要最短路径就用 AnyRouter CLI:
pi install npm:@anyr/pi
# 或者从 git
pi install git:github.com/AnyRouterHQ/pi-anyrouter
# 或者,使用 AnyRouter CLI
curl -fsSL https://anyr.dev/cli.sh | bash
anyr pi扩展已发布到 npm 的 @anyr scope,名为 @anyr/pi,所以 pi install npm:@anyr/pi 就是简写形式。CLI 会写入 provider、设置 ANYROUTER_API_KEY 并启动 pi --provider anyrouter,当你不想自己管文件时这是最快的路径。源码、测试和协议限制都在 AnyRouterHQ/pi-anyrouter。
兼容标志为什么重要
Pi 根据 host 决定如何与 provider 通信。对未知 host,它会假设一个标准 OpenAI 端点,发送 store、在推理模型上使用 developer 角色、max_completion_tokens 以及很长的 prompt 缓存保留期。
AnyRouter 的 chat 端点没有文档化这些字段。扩展改为根据每个目录行设置 pi 的 compat 标志,所以请求只发送模型实际列出的参数。列出 reasoning_effort 的行发送它,列出 reasoning 的行发送 reasoning 对象,两者都不列的行完全不发送 reasoning 字段。
它不做什么
这个 provider 使用 chat completions 协议。Claude Code 自己的请求形状是 Anthropic Messages,pi 可以用 anthropic-messages 客户端发出,但那个客户端还会发送 Claude 专属字段,这些字段未针对本目录的其余模型验证,所以没有注册第二个 provider。Codex 的形状是 Responses API,而 pi 的 Codex 客户端面向 ChatGPT 后端,不是这个网关。
两者仍然可以通过 chat completions 与它们的模型 id 一起工作,AnyRouter 接受这些 id。
需要知道
目录请求按 API key 缓存五分钟,与响应的 max-age 一致,离线刷新不会访问网络。免费模型在 Go 及以上套餐每 token $0,没有每日上限,BYOK 路由不加价。
Pi 不支持 MCP,所以没有可自动连接的东西。