This configuration works for both Claude Code CLI and Claude Code in Visual Studio Code. Install either the CLI (npm install -g @anthropic-ai/claude-code) or the Claude Code extension from the Visual Studio Code Marketplace. Node.js >= 18 is required either way.

npm install -g @anthropic-ai/claude-code

Verify Connection

Run claude in any folder and send a prompt. Response without 401 error confirms setup.

• Claude Desktop installed (macOS or Windows) — see Step 2 below to enable Developer Mode, a required step before anything else here.
• Quit the app completely before editing the file. As with Cline, edits made while the app is running get overwritten when it saves its own state.
• Only the macOS path is verified. The Windows path is inferred from where the app conventionally stores its config — if your machine has no such folder, use the lookup command in the Windows tab below.

Verify Connection

Reopen Claude. If it shows a sign-in screen, choose Continue with Gateway (do not sign in with a claude.ai account). If that screen shows “Your provider setup needs a fix”, your inferenceModels field is still wrong — see the note above. Once past that screen, start a new session and send a short prompt to confirm the gateway points at SubPool.

• Codex CLI installed via npm, or the Codex extension from the VS Code Marketplace — both share the config below.
• Configured via TOML format — [model_providers.subpool] header is case sensitive.
• If this machine has previously installed Codex and done `codex login` with a ChatGPT account, log out first: open a terminal and run codex logout.

Verify Connection

Open Codex, start a new chat session, and send a short message. A normal reply (no 401 or invalid api key error) confirms it's talking to SubPool.

• ChatGPT (Desktop App) installed, with the Codex tab open in the app.
• ChatGPT Desktop App reads the same ~/.codex/config.toml and auth.json as Codex CLI/the VS Code extension (confirmed in OpenAI's official docs) — there's no separate config file for it.
• If this machine has previously signed in to a ChatGPT account in Codex/ChatGPT App, sign out first: run codex logout in a terminal if Codex CLI is installed, or sign out directly in the app (account/profile menu) if you have no terminal.

Verify Connection

Open the Codex tab in ChatGPT (Desktop App), start a new session, and send a short message. A normal reply (no auth error) confirms it's talking to SubPool.

• OpenCode CLI installed.

Verify Connection

Run opencode models subpool or use /models in the TUI. If the provider is missing, check provider.subpool and the models section in opencode.json.

Prerequisites

• Latest version of Cursor IDE installed.
• SubPool Key created in advance.

Configuration Steps

1. Open Cursor → top right or menu Cursor → Settings → Cursor Settings (Cmd + , on macOS, Ctrl + , on Windows/Linux).
2. In Settings window, select Models tab on left sidebar.
3. Scroll down to API Keys, find OpenAI API Key — paste your SubPool key.
4. Enable Override OpenAI Base URL switch, enter official Base URL (ending with /v1).
5. Click Verify (if present) or close Settings — Cursor tests key automatically.
6. Open AI chat (Cmd/Ctrl + L), select Add model if needed, type exact Model ID.

OpenAI Base URL: /v1
OpenAI API Key:  sk-xxxxxxxxxxxxxxxx-xxxxxx-xxxxxxxx

Verify Connection

Open chat panel, send a test prompt. Normal response confirms active connection.

Prerequisites

• VS Code and Cline extension installed.
• Cline stores settings in 2 JSON files — editing directly on disk is faster and reliable.

Configuration Steps

1. Quit VS Code completely before editing files.
2. Edit ~/.cline/data/globalState.json for provider and model configuration.
3. Edit ~/.cline/data/secrets.json for API key declaration.
4. Reopen VS Code and confirm active model in Cline panel.

{
  "actModeApiProvider": "openai",
  "planModeApiProvider": "openai",
  "openAiBaseUrl": "",
  "openAiModelId": "switch-default",
  "planModeOpenAiModelId": "switch-default"
}

{
  "openAiApiKey": "sk-xxxxxxxxxxxxxxxx-xxxxxx-xxxxxxxx"
}

Verify Connection

Send a prompt in Cline panel. Response with tool execution indicates success.

Prerequisites

• Continue extension installed in VS Code or JetBrains.

Configuration Steps

1. Open Continue settings or ~/.continue/config.json.
2. Add SubPool configuration object to models array.
3. Save file — Continue auto-reloads configuration.
4. Select SubPool model from Continue chat dropdown.

{
  "models": [
    {
      "title": "SubPool",
      "provider": "openai",
      "model": "switch-default",
      "apiBase": "/v1",
      "apiKey": "sk-xxxxxxxxxxxxxxxx-xxxxxx-xxxxxxxx"
    }
  ]
}

Verify Connection

Send a chat prompt in Continue. Streaming response confirms success.

Prerequisites

• Hermes Agent installed.
• Hermes separates config (YAML) and secrets (.env) — edit both.

Configuration Steps

1. Configure ~/.hermes/config.yaml for model and custom provider.
2. Configure ~/.hermes/.env with OPENAI_API_KEY.
3. Restart Hermes Agent.

model:
  default: "switch-default"
  provider: "custom"
  base_url: "/v1"

OPENAI_API_KEY=sk-xxxxxxxxxxxxxxxx-xxxxxx-xxxxxxxx

Verify Connection

Run Hermes Agent and send a prompt. No auth errors confirms connection.

Prerequisites

• OpenClaw framework installed.

Configuration Steps

1. Open/create ~/.openclaw/openclaw.json.
2. Declare subpool provider in models.providers and set primary model to subpool/custom.
3. Specify exact Model ID for both id and name.
4. Restart OpenClaw.

{
  "agents": {
    "defaults": {
      "model": {
        "primary": "subpool/custom"
      }
    }
  },
  "models": {
    "providers": {
      "subpool": {
        "baseUrl": "/v1",
        "apiKey": "sk-xxxxxxxxxxxxxxxx-xxxxxx-xxxxxxxx",
        "apiType": "openai",
        "models": [{ "id": "switch-default", "name": "switch-default" }]
      }
    }
  }
}

Verify Connection

Run default agent and verify subpool provider log activity.

Prerequisites

• Qwen Code installed via npm: npm install -g @qwen-code/qwen-code

Configuration Steps

1. Open/create ~/.qwen/settings.json.
2. Set security.auth.selectedType to openai and paste SubPool key into openaiApiKey.
3. Set model.openaiBaseUrl and model.name.
4. Run qwen in terminal.

{
  "security": {
    "auth": {
      "selectedType": "openai",
      "openaiApiKey": "sk-xxxxxxxxxxxxxxxx-xxxxxx-xxxxxxxx"
    }
  },
  "model": {
    "openaiBaseUrl": "/v1",
    "name": "switch-default"
  }
}

Verify Connection

Run qwen and send a prompt. Normal response confirms connection.

Prerequisites

• DeepSeek CLI installed.

Configuration Steps

1. Open/create ~/.deepseek/config.toml.
2. Declare [providers.openai] table with base_url, api_key, model.
3. Save file and restart DeepSeek CLI.

[providers.openai]
base_url = "/v1"
api_key = "sk-xxxxxxxxxxxxxxxx-xxxxxx-xxxxxxxx"
model = "switch-default"

Verify Connection

Open new CLI session after saving configuration.