# 面向 pi coding agent 的官方 AnyRouter provider

> 官方 pi 扩展把 AnyRouter 注册为 provider，刷新实时目录，并设置兼容标志，而不是让 pi 去猜。一把 sk-ar-v1- key，覆盖目录里的每一个聊天模型。

- Date: November 22, 2026
- Category: guides
- HTML: https://anyrouter.dev/blog/zh/pi-provider-anyrouter

## 扩展做什么

Pi 从 `~/.pi/agent/models.json` 读取自定义的 OpenAI 兼容 provider。手工编辑这个文件可用，但模型列表会在新增或下架模型当天就过期。

官方扩展把 `anyrouter` 注册为 provider，并从 `https://anyrouter.dev/api/v1` 刷新目录，所以 pi 里的 `/model` 列出的是 AnyRouter 当天能路由的模型。它把流式请求交给 pi 内置的 `openai-completions` 实现，所以工具调用、用量统计和取消都保持可用。

## 安装

两个选项。想要实时目录就用扩展，想要最短路径就用 AnyRouter CLI：

```bash
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 或 git 安装扩展，或使用 AnyRouter CLI。_

扩展已发布到 npm 的 `@anyr` scope，名为 `@anyr/pi`，所以 `pi install npm:@anyr/pi` 就是简写形式。CLI 会写入 provider、设置 `ANYROUTER_API_KEY` 并启动 `pi --provider anyrouter`，当你不想自己管文件时这是最快的路径。源码、测试和协议限制都在 [AnyRouterHQ/pi-anyrouter](https://github.com/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，所以没有可自动连接的东西。
