Skip to content

Cline: CLI and VS Code configuration

Use Cline with one raw CloudService credential and the base URL that matches the key's billing mode.

Automatic configuration

bash
cloudservice update

Select Cline. CloudService configures the supported Cline surface only after Cline and VS Code are fully closed, preserves unrelated settings, writes private atomic files, and verifies that no custom authentication header was stored. Restart Cline or reload VS Code after setup.

Choose the matching base URL

Start with the key you bought

Choose one billing path

Your choice is remembered across the documentation. Then select the card that matches your client protocol.

For a key funded with a dollar credit balance.

OpenAI-compatible Chat Completions or Responses

Use with: Codex, OpenCode, Cursor, Roo Code, SDKs, and direct HTTP

Base URL to enter

https://api.yourdomain.example/v1

Native Anthropic Messages

Use with: Claude Code, Claude Desktop, and native Messages clients

Base URL to enter

https://api.yourdomain.example

The protocol decides whether the client field ends in /v1. OpenAI-compatible clients use a base URL ending in /v1. Native Anthropic clients use the origin only, without /v1, because they append /v1/messages themselves. A Claude token key therefore reaches /token/v1/messages when the native client builds its request.

Use the key's matching billing surface and only models returned by its authenticated catalog. A Claude token key and an OpenAI token key are provider-scoped; neither can be swapped onto the other's models.

Manual Cline for VS Code setup

  1. Open Cline settings and select its OpenAI-compatible provider.
  2. Paste the matching base URL from the table above.
  3. Paste only the raw ak_live_… API key.
  4. Choose an exact model ID returned by cloudservice models.
  5. Leave custom request headers empty, save, and reload VS Code.

Important authentication rule

Do not paste Bearer before the key and do not add a custom Authorization orx-api-key header. Cline generates the Bearer header from its API Key field. A second stored header can override it, causing model discovery to work while inference reports authentication or load failures.

Verify

bash
cloudservice doctor
cloudservice models

If a task still fails, copy the request ID and status code—not the API key—and follow the troubleshooting guide.