Pi · Cloudflare AI Gateway docs

Pi ↗ 是你在终端中运行的编码智能体。它内置支持 AI Gateway，因此你无需设置 base URL，而是选择 cloudflare-ai-gateway 提供商并将 Pi 指向你的 gateway。Pi 会根据你的账户 ID 和 gateway slug 构建 gateway 端点，并通过它路由请求。

前提条件

开始之前，你需要：

一个已认证的 gateway 及其 gateway 令牌。该 gateway 令牌必须具有 Run 权限。
你的 Cloudflare 账户 ID。查找方法请参阅查找账户和 zone ID。
已安装并更新到最新版本的 Pi。

将 gateway 令牌、账户 ID 和 gateway slug 设为环境变量。以下命令为当前会话设置这些变量。若要持久化，请将其添加到 shell 配置文件（例如 ~/.zshrc 或 ~/.bashrc）。

将 <CLOUDFLARE_API_KEY> 和 <CLOUDFLARE_ACCOUNT_ID> 替换为你的值。可以将 CLOUDFLARE_GATEWAY_ID 保留为 default，以通过账户的默认 gateway 路由；也可以改为其他 gateway slug。

# Run `wrangler auth token` to get an auth token.
export CLOUDFLARE_API_KEY="<CLOUDFLARE_API_KEY>"
# Run `wrangler whoami` to get your account ID.
export CLOUDFLARE_ACCOUNT_ID="<CLOUDFLARE_ACCOUNT_ID>"
# Use `default` to route through your account's default gateway.
export CLOUDFLARE_GATEWAY_ID="default"

# Run `wrangler auth token` to get an auth token.
$env:CLOUDFLARE_API_KEY = "<CLOUDFLARE_API_KEY>"
# Run `wrangler whoami` to get your account ID.
$env:CLOUDFLARE_ACCOUNT_ID = "<CLOUDFLARE_ACCOUNT_ID>"
# Use `default` to route through your account's default gateway.
$env:CLOUDFLARE_GATEWAY_ID = "default"

或者，省略 CLOUDFLARE_API_KEY，并在 Pi 内运行 /login 来存储令牌。

针对某个模型启动会话。请求现在会通过 AI Gateway 路由。
```
pi --provider cloudflare-ai-gateway --model "claude-sonnet-4-6"
```

要确认流量已到达 AI Gateway，请参阅验证是否生效。