Pi (2)

Last updated Sep 10, 2026 is a coding agent you run in your terminal. It has built-in support for AI Gateway, so instead of setting a base URL you select the cloudflare-ai-gateway provider and point Pi at your gateway. Pi builds the gateway endpoint from your account ID and gateway slug and routes requests through it.

Prerequisites

Before you start, you need:

Note

The token you give Pi is your gateway token, not a model provider key. To pay for model usage, enable Unified Billing or store provider keys in AI Gateway with BYOK (Store Keys). Either way, AI Gateway handles the provider authentication for you.

  1. Set your gateway token, account ID, and gateway slug as environment variables. The following commands set them for the current session. To persist them, add them to your shell profile (for example, ~/.zshrc or ~/.bashrc).

Replace <CLOUDFLARE_API_KEY> and <CLOUDFLARE_ACCOUNT_ID> with your values. You can leave CLOUDFLARE_GATEWAY_ID as default to route through your account's default gateway, or change it to another gateway slug.

bash # 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"

powershell # 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"

Alternatively, leave out CLOUDFLARE_API_KEY and run /login inside Pi to store the token instead. 2. Start a session against a model. Requests now route through AI Gateway.

bash pi --provider cloudflare-ai-gateway --model "claude-sonnet-4-6"

To confirm traffic reaches AI Gateway, refer to Verify it works.

Was this helpful?

YesNo

On this page

Pi (2) - 图1Docs

{"@context":"https://schema.org","@type":"TechArticle","@id":"https://developers.cloudflare.com/ai-gateway/integrations/coding-agents/pi/#page","headline":"Pi","description":"Route the Pi coding agent through AI Gateway using its built-in Cloudflare AI Gateway provider.","url":"https://developers.cloudflare.com/ai-gateway/integrations/coding-agents/pi/","inLanguage":"en","image":"https://developers.cloudflare.com/ai-gateway/integrations/coding-agents/pi/og.png?v=dea731ad1efb8182","dateModified":"2026-09-10","publisher":{"@type":"Organization","name":"Cloudflare","description":"One platform for your apps, agents, and workforce. Build, secure, and scale without managing infrastructure","url":"https://www.cloudflare.com/","sameAs":["https://github.com/cloudflare","https://www.linkedin.com/company/cloudflare","https://x.com/cloudflare"],"logo":{"@type":"ImageObject","url":"https://developers.cloudflare.com/logo.svg"},"address":{"@type":"PostalAddress","streetAddress":"101 Townsend St","addressLocality":"San Francisco","addressRegion":"CA","postalCode":"94107","addressCountry":"US"},"contactPoint":[{"@type":"ContactPoint","contactType":"Customer Support","url":"https://support.cloudflare.com/","availableLanguage":["English"]},{"@type":"ContactPoint","contactType":"Sales","url":"https://www.cloudflare.com/contact/","availableLanguage":["English"]}]},"isPartOf":{"@type":"WebSite","@id":"https://developers.cloudflare.com/#website","name":"Cloudflare Docs","url":"https://developers.cloudflare.com/"}}

description: Route VS Code chat through an AI Gateway custom domain. title: Visual Studio Code image: https://developers.cloudflare.com/ai-gateway/integrations/coding-agents/vs-code/og.png?v=bb241cad8f248da5

Skip to content

Documentation Index
Fetch the complete documentation index at: https://developers.cloudflare.com/ai-gateway/llms.txt
Use this file to discover all available pages before exploring further.