Connect the API
in 5 minutes

Guide for integrating the Claude Popusk API with popular AI coding tools: Claude Code, Cline, Kilo Code, OpenCode and Roo Code.

Supported clients

Click a card to jump to the detailed instructions for that tool.

CC
Claude Code
CLI · Anthropic
CL
Cline
VS Code · OpenAI
KC
Kilo Code
VS Code · OpenAI
OC
OpenCode
CLI · OpenAI
RC
Roo Code
VS Code · OpenAI
CC

Claude Code

Official CLI by Anthropic · Anthropic Messages protocol
Before you start, make sure the legacy ANTHROPIC_AUTH_TOKEN and ANTHROPIC_BASE_URL variables are not set in your environment. If they are present in ~/.bashrc / ~/.zshrc — remove them and restart your terminal.
1

Install Claude Code

Node.js 18+ is required. Install via npm:

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

Create the configuration file

Create the file ~/.claude/settings.json (on Windows: %USERPROFILE%\.claude\settings.json) and paste the configuration below. Replace YOUR_API_KEY with your API key.

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.claude-popusk.shop",
    "ANTHROPIC_AUTH_TOKEN": "YOUR_API_KEY",
    "ANTHROPIC_MODEL": "popusk/claude-opus-4-7",
    "ANTHROPIC_SMALL_FAST_MODEL": "popusk/claude-sonnet-4-6",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "popusk/claude-sonnet-4-6",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "popusk/claude-opus-4-7"
  }
}

Alternative — export the environment variables manually:

export ANTHROPIC_BASE_URL="https://api.claude-popusk.shop"
export ANTHROPIC_AUTH_TOKEN="YOUR_API_KEY"
3

Run Claude Code in your project

cd /path/to/your/project
claude
CL

Cline

VS Code extension · OpenAI-compatible
1

Install the Cline extension

In VS Code open Extensions (Ctrl/Cmd + Shift + X), search for Cline and click Install.

Installing Cline in VS Code
2

Open API settings

In the Cline side panel click the gear icon and choose API Key as the authentication method.

Choosing API Key in Cline
3

Enter the connection parameters

  • API Provider: OpenAI Compatible
  • Base URL: https://api.claude-popusk.shop/v1
  • API Key: your API key
  • Model ID: e.g. popusk/claude-opus-4-7, popusk/gpt-5.5
Enable the «Enable streaming» toggle — Cline works better with streamed responses.
4

Start chatting

Save the settings and pick your newly connected model from the model dropdown. Cline is ready to go.

KC

Kilo Code

VS Code extension · OpenAI-compatible
1

Install Kilo Code

Find Kilo Code in the VS Code Marketplace and click Install.

Installing Kilo Code
2

Choose authentication — API Key

API Key in Kilo Code
3

Fill in the provider parameters

  • API Provider: OpenAI Compatible
  • Base URL: https://api.claude-popusk.shop/v1
  • API Key: your API key
  • Model ID: e.g. popusk/claude-opus-4-7 or popusk/gpt-5.5
4

Get to work

Save the settings and switch the model in chat to the one you just added.

OC

OpenCode

Open-source CLI agent · OpenAI-compatible
1

Install OpenCode

Via curl (recommended):

curl -fsSL https://opencode.ai/install | bash

Or via npm:

npm i -g opencode-ai
2

Create the config

Create the file ~/.config/opencode/opencode.json with the following contents:

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "claude-popusk": {
      "npm": "@ai-sdk/openai-compatible",
      "options": {
        "baseURL": "https://api.claude-popusk.shop/v1",
        "apiKey": "YOUR_API_KEY"
      },
      "models": {
        "popusk/claude-opus-4-7": { "name": "popusk/claude-opus-4-7" },
        "popusk/claude-sonnet-4-6": { "name": "popusk/claude-sonnet-4-6" },
        "popusk/gpt-5.5": { "name": "popusk/gpt-5.5" }
      }
    }
  }
}

Don't forget to substitute your YOUR_API_KEY. The models list can be extended.

3

Run and switch model

cd /path/to/your/project
opencode

Inside OpenCode run the /models command and pick the model.

RC

Roo Code

VS Code extension · OpenAI-compatible
1

Install Roo Code

Find Roo Code in the VS Code Marketplace and install it.

Installing Roo Code
2

Open provider settings

In the Roo Code side panel open Settings → Providers.

3

Fill in the parameters

  • API Provider: OpenAI Compatible
  • Base URL: https://api.claude-popusk.shop/v1
  • API Key: your API key
  • Model ID: e.g. popusk/claude-sonnet-4-6
4

Let's go

Save the settings. Pick your model from the chat header — and start writing tasks.

Available models

Use the exact model name when configuring your client. Click any item to copy.

Opus

  • popusk/claude-opus-4-7
  • popusk/claude-opus-4-6
  • popusk/claude-opus-4-5-20251101
  • popusk/claude-opus-4-5
  • popusk/claude-opus-4-1-20250805
  • popusk/claude-opus-4-1
  • popusk/claude-opus-4-20250514
  • popusk/claude-opus-4-0

Sonnet

  • popusk/claude-sonnet-4-6
  • popusk/claude-sonnet-4-5-20250929
  • popusk/claude-sonnet-4-5
  • popusk/claude-sonnet-4-20250514
  • popusk/claude-sonnet-4-0

Haiku

  • popusk/claude-haiku-4-5-20251001
  • popusk/claude-haiku-4-5

GPT-5.5

  • popusk/gpt-5.5
  • popusk/gpt-5.5-2026-04-23
  • popusk/gpt-5.5-pro
  • popusk/gpt-5.5-pro-2026-04-23

GPT-5.4

  • popusk/gpt-5.4
  • popusk/gpt-5.4-2026-03-05
  • popusk/gpt-5.4-pro
  • popusk/gpt-5.4-pro-2026-03-05
  • popusk/gpt-5.4-mini
  • popusk/gpt-5.4-mini-2026-03-17
  • popusk/gpt-5.4-nano
  • popusk/gpt-5.4-nano-2026-03-17

GPT-5.3

  • popusk/gpt-5.3-chat-latest
  • popusk/gpt-5.3-chat
  • popusk/gpt-5.3-codex

GPT-5.2

  • popusk/gpt-5.2
  • popusk/gpt-5.2-2025-12-11
  • popusk/gpt-5.2-pro
  • popusk/gpt-5.2-pro-2025-12-11
  • popusk/gpt-5.2-chat-latest
  • popusk/gpt-5.2-chat
  • popusk/gpt-5.2-codex

GPT-5.1

  • popusk/gpt-5.1
  • popusk/gpt-5.1-2025-11-13
  • popusk/gpt-5.1-chat-latest
  • popusk/gpt-5.1-codex
  • popusk/gpt-5.1-codex-max
  • popusk/gpt-5.1-codex-mini

GPT-5

  • popusk/gpt-5
  • popusk/gpt-5-2025-08-07
  • popusk/gpt-5-chat-latest
  • popusk/gpt-5-chat
  • popusk/gpt-5-pro
  • popusk/gpt-5-pro-2025-10-06
  • popusk/gpt-5-mini
  • popusk/gpt-5-mini-2025-08-07
  • popusk/gpt-5-nano
  • popusk/gpt-5-nano-2025-08-07
  • popusk/gpt-5-codex
  • popusk/gpt-5-search-api
  • popusk/gpt-5-search-api-2025-10-14

o3

  • popusk/o3
  • popusk/o3-2025-04-16
  • popusk/o3-pro
  • popusk/o3-pro-2025-06-10
  • popusk/o3-deep-research
  • popusk/o3-deep-research-2025-06-26

o3-mini

  • popusk/o3-mini
  • popusk/o3-mini-2025-01-31

o4-mini

  • popusk/o4-mini
  • popusk/o4-mini-2025-04-16
  • popusk/o4-mini-deep-research
  • popusk/o4-mini-deep-research-2025-06-26

Gemini

  • popusk/gemini-3.1-pro-preview
  • popusk/gemini-3.1-pro-preview-customtools
  • popusk/gemini-3.1-flash-lite-preview
  • popusk/gemini-3-pro-preview
  • popusk/gemini-3-deep-think-preview
  • popusk/gemini-3-flash-preview