For the few who know, the pool awaits. Unlimited resources. Zero friction.
# Using NPM (All Platforms) npm install -g @openai/codex # Using Homebrew (macOS) brew install codex
macOS / Linux (bash)
Windows (PowerShell)
Automatically retrieves auth token and configures local environment.
Target: ~/.codex/auth.json
Target: ~/.codex/config.toml
# Using NPM (All Platforms) npm install -g @google/gemini-cli # Using Homebrew (macOS) brew install gemini-cli
macOS / Linux (bash)
Windows (PowerShell)
Automatically retrieves OAuth token and configures endpoint settings.
Target: ~/.gemini/settings.json + environment variable
macOS / Linux (bash/zsh)
Windows (PowerShell)
Target: ~/.gemini/settings.json
# Using NPM (All Platforms) npm install -g @anthropic-ai/claude-code # Using Homebrew (macOS) brew install claude-code
macOS / Linux (bash/zsh)
Windows (PowerShell)
Sets ANTHROPIC_BASE_URL, CLAUDE_CODE_OAUTH_TOKEN, and skips onboarding.
Add to ~/.bashrc or ~/.zshrc (macOS/Linux) or $PROFILE (PowerShell). Claude Code reads env vars for auth.
macOS / Linux (bash/zsh)
Windows (PowerShell)
Add to ~/.claude.json
{"hasCompletedOnboarding": true}
Use these model names in Claude Code (routed through the pool)
Claude Code ignores auth in ~/.claude/settings.json; this is optional for other settings
Use the pool token as an Anthropic API key. Official Anthropic clients send it as x-api-key, and the pool routes Claude models natively while translating GPT/Kimi/MiniMax/GLM models through the same /v1/messages interface.
ANTHROPIC_API_KEY can be the pool token.
Claude models plus GPT/Kimi/MiniMax/GLM via translation.
pip install anthropic
This is the normal Anthropic Python SDK. The only difference is base_url and the pool token.
npm install @anthropic-ai/claude-agent-sdk
Use this when you want Claude Code's agent loop programmatically. It reads ANTHROPIC_BASE_URL and CLAUDE_CODE_OAUTH_TOKEN.
Use the pool with the official OpenAI SDK, the OpenAI Agents SDK, Cursor, Continue, Aider, LiteLLM, or any OpenAI-compatible client. Chat Completions and Responses both work; model names route to the right provider automatically.
OPENAI_API_KEY is the same pool token.
chat.completions, responses, and Agents SDK models.
Set these in your shell or tool config.
macOS / Linux (bash/zsh)
Windows (PowerShell)
pip install openai
Use this for older packages that still call /v1/completions. The pool translates it to Codex Responses and returns normal text_completion JSON.
The proxy normalizes the official SDK's Responses payload into the Codex backend shape and returns normal non-streaming Responses JSON.
images.generate supports n by fanning out through the pool. images.edit accepts the official SDK multipart upload and translates it to the Responses image_generation tool with an input image.
pip install openai-agents
Use OpenAIResponsesModel for the normal Agents path. OpenAIChatCompletionsModel also works if a project is built around chat completions.
npm install @openai/agents openai zod
This follows the current OpenAI Agents SDK shape: create an OpenAI client with the pool base URL, set it as the default client, then use Responses or Chat Completions models.
This gives another agent or code assistant the exact base URL, auth header, model names, and endpoint choices it needs to swap an OpenAI client onto the pool.
Use any model name. Requests are auto-routed to the right provider and translated if needed.
Claude models sent to /v1/chat/completions are translated to Anthropic Messages and back. OpenAI models sent to /v1/messages are translated to Codex Responses and back.
Pi gets its own models.json. Codex runs through openai-codex-responses, while Claude, Kimi, and MiniMax run through anthropic-messages.
Target: ~/.pi/agent/models.json
macOS / Linux (bash/zsh)
Windows (PowerShell)
Pi only gets the pool-backed providers, so the built-in Anthropic clutter stays out of the picker.
Replace the file, then fully restart Pi so it reloads the provider list.
Installs cute-code, writes pool settings to ~/.claude/settings.json, and registers Codex/OpenAI, Claude, Kimi, MiniMax, and GLM models.
macOS / Linux (bash/zsh)
Windows (PowerShell)
Target: ~/.claude/settings.json
After setup, run cute-code --model gpt-5.5 or pick any configured model in the model selector.