Coding Assistants

Use this guide to add Phaseo as the model provider in coding assistants that support custom OpenAI-compatible or Anthropic-compatible endpoints.

Set up with the Phaseo CLI

phaseo login
phaseo codex

This command installs the harness when it is missing, creates its dedicated key, and writes its Phaseo configuration. OpenCode, DeepSeek Harness, Pi, and Prime Agent also receive every active text model compatible with Chat Completions. Use --skip-install, --catalog default, or --dry-run when you need narrower behavior. Use the lower-level command for other integrations or when installation is managed separately:

phaseo integrations setup codex

Supported integration names are codex, claude-code, opencode, deepseek-harness, pi, openclaw, hermes, aider, cline, roo-code, kilo-code, continue, cursor, and zed. The CLI creates a separate, non-expiring API key named for that assistant. It configures Aider and Continue automatically on clean installations, and writes Zed’s provider/model settings automatically. For assistants that keep secrets exclusively in an editor UI, it prints the exact remaining fields, links the dedicated guide, and lets you copy only that assistant’s key:

phaseo integrations credential codex

Preview any file changes before setup, and disconnect cleanly later:

phaseo integrations setup codex --dry-run
phaseo integrations remove codex

Removal deletes Phaseo-owned configuration and revokes that assistant’s key. It does not remove unrelated settings.

Provider settings

Use these values unless the tool asks for a different field name:

Setting	Value
Provider type	OpenAI Compatible
Base URL	`https://api.phaseo.app/v1`
API key	Your Phaseo API key
Model	A Phaseo model id, such as `openai/gpt-5-nano`

For Anthropic-compatible tools, use:

Setting	Value
Base URL	`https://api.phaseo.app`
Auth token	Your Phaseo API key
Model	A Phaseo model id, such as `anthropic/claude-sonnet-4.5`

Cursor

Cursor supports custom OpenAI-compatible endpoints through its OpenAI API key settings.

Open Cursor Settings.
Go to Models.
Enable or add the OpenAI API Key entry.
Paste your Phaseo API key.
Enable Override OpenAI Base URL.
Set the base URL to https://api.phaseo.app/v1.
Add a custom model using A Phaseo model id, for example openai/gpt-5-nano.
Enable the model and verify it from the Cursor model picker.

If Cursor rejects a model id with /, create the closest local alias the UI allows and route that alias to the Phaseo model in your own config when the client supports aliases.

VS Code

VS Code supports adding models through the Language Models editor when the OpenAI-compatible provider is available in your VS Code or Insiders build.

Open the Command Palette.
Run Chat: Manage Language Models.
Choose OpenAI Compatible or OAI Compatible.
Enter your Phaseo API key.
Set the endpoint or base URL to https://api.phaseo.app/v1.
Add A Phaseo model id, for example openai/gpt-5-nano.
Select the new model from the chat model picker.

If your VS Code build does not show an OpenAI-compatible provider, use an extension that supports custom providers, such as Continue, Cline, Roo Code, or Kilo Code.

Continue

Continue can use Phaseo through its OpenAI provider with a custom API base.

name: Phaseo
version: 0.0.1
schema: v1

models:
  - name: Phaseo GPT-5 Nano
    provider: openai
    model: openai/gpt-5-nano
    apiKey: ${{ secrets.PHASEO_API_KEY }}
    apiBase: https://api.phaseo.app/v1
    roles:
      - chat
      - edit
      - apply

For models where Continue defaults to Responses but your workflow needs Chat Completions compatibility, set useResponsesApi: false.

Cline, Roo Code, and Kilo Code

These tools expose similar provider settings.

Open the extension settings.
Choose OpenAI Compatible as the provider.
Set the base URL to https://api.phaseo.app/v1.
Paste your Phaseo API key.
Enter A Phaseo model id.
Save and run a small chat request before using file-editing tools.

Aider

Set OpenAI-compatible environment variables and pass the model on launch:

export OPENAI_API_BASE="https://api.phaseo.app/v1"
export OPENAI_API_KEY="your_phaseo_api_key"
aider --model openai/openai/gpt-5-nano

Aider often expects OpenAI-compatible custom models to be prefixed with openai/. Because Phaseo model ids already include provider prefixes, the full Aider model string may look like openai/openai/gpt-5-nano.

Pi, Prime Agent, OpenClaw, and Hermes Agent

phaseo pi installs Pi and a dedicated provider extension that resolves its key from the Phaseo CLI at runtime. phaseo prime-agent installs Prime Agent on macOS or Linux and writes a command-backed provider to ~/.prime/agent/models.json. Both receive the compatible Phaseo model catalog. phaseo openclaw installs OpenClaw and registers the compatible model catalog plus an exec-backed SecretRef, without placing the API key in openclaw.json. phaseo hermes installs and configures the current Nous Research agent. It saves the previous Hermes model settings, configures Phaseo as the custom endpoint, and uses Hermes’ official hermes config set command to place the dedicated key in ~/.hermes/.env as OPENAI_API_KEY. Hermes deliberately uses this plaintext file for provider credentials; protect it like any other API-key file. Removal restores the previous model settings, removes OPENAI_API_KEY, deletes Phaseo’s recovery state, and revokes the key.

Zed

Run phaseo integrations setup zed, then follow the printed steps to add an OpenAI-compatible provider in Zed’s settings. Use the generated key only in Zed’s credential prompt.

Codex

Use the dedicated Codex guide for Codex CLI, Codex App, and the Codex IDE extension. The short version is:

model = "openai/gpt-5.5"
model_provider = "phaseo"

[model_providers.phaseo]
name = "Phaseo"
base_url = "https://api.phaseo.app/v1"
env_key = "PHASEO_API_KEY"
wire_api = "responses"

Codex custom providers use the Responses wire protocol.

OpenCode

Use the dedicated OpenCode guide when you want OpenCode to call Phaseo through an OpenAI-compatible custom provider.

Claude Code

Use the dedicated Claude Code guide. Claude Code uses Anthropic-compatible gateway environment variables:

export ANTHROPIC_BASE_URL="https://api.phaseo.app"
export ANTHROPIC_AUTH_TOKEN="your_phaseo_api_key"
export ANTHROPIC_API_KEY=""

Then start Claude Code from the same shell:

claude

Claude Desktop

Claude Desktop supports MCP servers, but it does not expose the same custom model-provider setup as coding assistants such as Cursor, Codex, or Claude Code. Use Docs MCP to add Phaseo documentation context to Claude Desktop. Use Claude Code when you need Phaseo to be the model gateway.

Deep Agents CLI and LangChain tools

Use the same base URL and API key settings as LangChain. If the tool reads OpenAI environment variables, set:

export OPENAI_API_KEY="your_phaseo_api_key"
export OPENAI_BASE_URL="https://api.phaseo.app/v1"

Then pass A Phaseo model id in the tool’s model field.

Notes

Coding assistants vary in how they handle slashes in model ids. If the UI rejects openai/gpt-5-nano, create a local alias if the tool supports aliases.
Test file-editing workflows carefully. phaseo:apply_patch is Responses-only.
Add Docs MCP when you want the assistant to read Phaseo docs during a session.
Prefer Chat Completions for older coding tools unless the tool explicitly supports Responses events and server tools.

Overview

Models & Routing

Features

Integrations

Workspace & Access

Reliability & Operations

Platform & Research

Migration Guides

Community

Set up with the Phaseo CLI

Provider settings

Cursor

VS Code

Continue

Cline, Roo Code, and Kilo Code

Aider

Pi, Prime Agent, OpenClaw, and Hermes Agent

Zed

Codex

OpenCode

Claude Code

Claude Desktop

Deep Agents CLI and LangChain tools

Notes

​Set up with the Phaseo CLI

​Provider settings

​Cursor

​VS Code

​Continue

​Cline, Roo Code, and Kilo Code

​Aider

​Pi, Prime Agent, OpenClaw, and Hermes Agent

​Zed

​Codex

​OpenCode

​Claude Code

​Claude Desktop

​Deep Agents CLI and LangChain tools

​Notes

​Related

Set up with the Phaseo CLI

Provider settings

Cursor

VS Code

Continue

Cline, Roo Code, and Kilo Code

Aider

Pi, Prime Agent, OpenClaw, and Hermes Agent

Zed

Codex

OpenCode

Claude Code

Claude Desktop

Deep Agents CLI and LangChain tools

Notes

Related