Guides

Client setup

Almost every tool needs the same two values: a base URL and a key. This page gives the exact field names for the editors and extensions people use most, plus the pattern for everything else.

Any OpenAI-compatible app (permalink)

If a tool asks for an OpenAI API key and lets you override the endpoint, it will work. Fill in the fields it offers using this mapping, and ignore the ones it does not.

Generic OpenAI-compatible configuration
Field	Value
Base URL	`https://api.korlogic.com/v1`. Some tools label this API Base, Endpoint, Host or Custom URL.
API key	Your key, in the shape `kl_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx`.
Model	Any id from the catalogue, such as `claude-sonnet-5`.
Organisation or project id	Leave blank. Not used.

One judgement call: if the tool appends /v1 to whatever you type, give it https://api.korlogic.com instead, so the path is not doubled. A 404 on the very first request is the symptom.

Cursor (permalink)

Open Cursor Settings, then Models.

Under the model list choose Add model and type the exact id, for example claude-sonnet-5. Cursor only sends model names it already knows about.
Open the OpenAI API Key section and paste your key.
Enable Override OpenAI Base URL and set it to https://api.korlogic.com/v1.
Press Verify. Cursor sends a test completion, and a green tick means the key and the base URL agree.

Turn off the built-in models you do not want, so Cursor stops falling back to them. Some Cursor features are served by Cursor’s own infrastructure whatever this setting says. Chat and edits are the parts that follow your override.

Cline (permalink)

In the Cline sidebar, open the settings gear and set the provider to OpenAI Compatible.

Cline configuration
Field	Value
API Provider	OpenAI Compatible
Base URL	`https://api.korlogic.com/v1`
API Key	Your key
Model ID	`claude-sonnet-5`

Leave the model-capability toggles at their defaults unless the model you picked lacks the feature. The catalogue lists what each one supports.

Roo Code (permalink)

Roo Code uses the same provider form as Cline. Open Settings, then Providers and select OpenAI Compatible.

Roo Code configuration
Field	Value
API Provider	OpenAI Compatible
Base URL	`https://api.korlogic.com/v1`
API Key	Your key
Model	`claude-sonnet-5`

Roo Code keeps a separate profile per mode. If you use custom modes, point each one at the same profile so a single key covers all of them.

Continue (permalink)

Continue is configured from a file in your home directory: ~/.continue/config.yaml on current versions, ~/.continue/config.json on older ones. Add one entry per model you want in the picker.

YAML~/.continue/config.yaml

models:
  - name: Korlogic claude-sonnet-5
    provider: openai
    model: claude-sonnet-5
    apiBase: https://api.korlogic.com/v1
    apiKey: kl_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
    roles:
      - chat
      - edit

JSON~/.continue/config.json

{
  "models": [
    {
      "title": "Korlogic claude-sonnet-5",
      "provider": "openai",
      "model": "claude-sonnet-5",
      "apiBase": "https://api.korlogic.com/v1",
      "apiKey": "kl_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
    }
  ]
}

The provider stays openai even for Claude models. It describes the wire format, not the model vendor.

Claude Code (permalink)

Claude Code speaks the Anthropic Messages format and appends /v1/messages itself, so give it the base URL without the trailing /v1.

ShellShell session

export ANTHROPIC_BASE_URL="https://api.korlogic.com"
export ANTHROPIC_AUTH_TOKEN="kl_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
export ANTHROPIC_MODEL="claude-sonnet-5"
export ANTHROPIC_SMALL_FAST_MODEL="claude-haiku-4-5-20251001"

claude

To make it permanent, put the same values in your Claude Code settings file instead of exporting them.

JSON~/.claude/settings.json

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.korlogic.com",
    "ANTHROPIC_AUTH_TOKEN": "kl_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
    "ANTHROPIC_MODEL": "claude-sonnet-5",
    "ANTHROPIC_SMALL_FAST_MODEL": "claude-haiku-4-5-20251001"
  }
}

Claude Code environment variables
Field	Value
ANTHROPIC_BASE_URL	`https://api.korlogic.com`
ANTHROPIC_AUTH_TOKEN	Your key. Sent as `Authorization: Bearer`.
ANTHROPIC_API_KEY	Alternative to the token above, sent as `x-api-key`. Both headers are accepted, so set one, not both.
ANTHROPIC_MODEL	The main model, for example `claude-sonnet-5`.
ANTHROPIC_SMALL_FAST_MODEL	The background model used for titles and summaries, for example `claude-haiku-4-5-20251001`.

Common problems (permalink)

Client troubleshooting
Symptom	Cause and fix
404 Not Found	The path was doubled or truncated. Check whether your tool appends `/v1`: give it `https://api.korlogic.com` if it does, `https://api.korlogic.com/v1` if it does not.
401 on a key you trust	The key belongs to the other billing surface. Try `https://api.korlogic.com/token/v1`.
Empty model dropdown	The tool never called `/models`, or filtered the result to names it recognises. Type the model id by hand.
Works in chat, fails in agent mode	Agent modes often switch to a different model. Make sure every model the tool reaches for is on your key’s allowlist.
Streaming shows nothing	Something between you and the gateway is buffering. Streamed responses leave here as `text/event-stream` with `no-transform` set, so the buffering is downstream of us.
400 from an Anthropic-style tool	The Messages API requires `max_tokens` on every request. Most tools set it, but a hand-rolled integration often does not.

Still stuck

Reproduce the call with curl from Quickstart. If curl works, the problem is the tool’s configuration, not the key.
Read the status and the error.code in the response body. Errors maps every one of them to a fix.

Any OpenAI-compatible app# (permalink)

Cursor# (permalink)

Cline# (permalink)

Roo Code# (permalink)

Continue# (permalink)

Claude Code# (permalink)

Common problems# (permalink)