# Provider AnyRouter chính thức cho pi coding agent

> Extension pi chính thức đăng ký AnyRouter như một provider, tải lại catalog trực tiếp và đặt các cờ tương thích thay vì để pi đoán. Một key sk-ar-v1-, mọi chat model trong catalog.

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

## Extension làm gì

Pi đọc custom OpenAI-compatible provider từ `~/.pi/agent/models.json`. Tự sửa file đó chạy được, nhưng danh sách model sẽ cũ ngay ngày một model được thêm hoặc ngừng.

Extension chính thức đăng ký `anyrouter` như một provider và tải lại catalog từ `https://anyrouter.dev/api/v1`, nên `/model` trong pi liệt kê những gì AnyRouter định tuyến được hôm đó. Nó nhờ `openai-completions` tích hợp sẵn của pi, nên tool call, usage accounting và hủy request vẫn hoạt động.

## Cài đặt

Hai lựa chọn. Extension cho bạn catalog trực tiếp, còn AnyRouter CLI cho bạn đường ngắn nhất:

```bash
pi install npm:@anyr/pi

# hoặc từ git
pi install git:github.com/AnyRouterHQ/pi-anyrouter

# hoặc, dùng AnyRouter CLI
curl -fsSL https://anyr.dev/cli.sh | bash
anyr pi
```

_Extension từ npm hoặc git, hoặc AnyRouter CLI._

Extension được phát hành trên npm trong scope `@anyr` dưới tên `@anyr/pi`, nên `pi install npm:@anyr/pi` là dạng ngắn. CLI ghi provider, đặt `ANYROUTER_API_KEY` và khởi động `pi --provider anyrouter`, là đường nhanh nhất nếu bạn không muốn tự quản file. Source, test và giới hạn protocol nằm ở [AnyRouterHQ/pi-anyrouter](https://github.com/AnyRouterHQ/pi-anyrouter).

## Vì sao các cờ tương thích quan trọng

Pi quyết định cách nói chuyện với provider theo host. Với host lạ, nó giả định một endpoint OpenAI chuẩn và gửi `store`, role `developer` trên model reasoning, `max_completion_tokens` và prompt-cache retention dài.

Endpoint chat của AnyRouter không tài liệu những trường đó. Extension đặt các cờ compat của pi theo từng dòng catalog, nên request chỉ gửi tham số mà model thực sự liệt kê. Dòng liệt kê `reasoning_effort` thì gửi nó, dòng liệt kê `reasoning` thì gửi object reasoning, và dòng không liệt kê cái nào thì không gửi trường reasoning.

## Điều nó không làm

Chat completions là protocol mà provider này nói. Hình request của Claude Code là Anthropic Messages, pi có thể phát bằng client `anthropic-messages`, nhưng client đó còn gửi các trường chỉ của Claude và chưa được xác minh cho phần còn lại của catalog, nên không đăng ký thêm provider thứ hai. Hình của Codex là Responses API, và client Codex của pi nhắm backend ChatGPT, không phải gateway này.

Cả hai vẫn chạy qua chat completions với model id của chúng, mà AnyRouter chấp nhận.

## Cần biết

Lượt tải catalog được cache năm phút cho mỗi API key, khớp với `max-age` của response, và lượt refresh ngoại tuyến không gọi mạng. Model miễn phí tính `$0` mỗi token trên gói Go trở lên, không giới hạn theo ngày, và route BYOK không phụ phí.

Pi không hỗ trợ MCP, nên không có gì để tự động kết nối.
