Cline

Install

Cline is an IDE extension, officially supporting VS Code, Cursor, Windsurf, VSCodium, Antigravity, and the JetBrains IDE family. Always defer to the official install docs.

VS Code / Cursor / Windsurf / VSCodium / Antigravity

Press Ctrl/Cmd + Shift + X to open the Extensions panel, search for Cline, and install. You can also install directly by Marketplace ID (Cline was formerly named Claude Dev, so the extension ID is still saoudrizwan.claude-dev):

code --install-extension saoudrizwan.claude-dev

JetBrains (IDEA / PyCharm / GoLand, etc.)

Go to Settings → Plugins → Marketplace, search for Cline, install, then restart the IDE; you can also install it from the JetBrains Marketplace page.

After installation, a Cline icon appears in the VS Code activity bar on the left; you can check the installed Cline version in the Extensions panel, and upgrading to the latest version is the recommended first step when you hit issues.

Connect TokenBay

How it works

Cline doesn’t configure the gateway via environment variables — instead, you select a provider in the extension’s settings panel and fill in the endpoint and credentials. There are two providers for connecting to TokenBay:

  • Anthropic provider (recommended): uses TokenBay’s native Anthropic endpoint with the most complete feature set (prompt caching, etc.). After checking Use custom base URL, Cline automatically appends /v1/messages to the base URL, so enter only the bare gateway host in Custom Base URL — do not include a path.
  • OpenAI Compatible provider (alternative): for non-Claude models like GPT and DeepSeek. It uses the standard /chat/completions, so the Base URL must include /v1.

Don’t get the Base URL path wrong:

  • The Anthropic provider’s Custom Base URL is https://api.tokenbay.com (bare host, no /v1, no trailing slash).
  • The OpenAI Compatible provider’s Base URL is https://api.tokenbay.com/v1 (with /v1).

1. Get an API key

Sign in to the TokenBay consoleAPI KeysCreate Key. Copy the full string starting with sk-. The plaintext is shown only once — you can’t view it again after leaving the page.

Create an API key in the console

Click the Cline icon on the left → settings icon (⚙️), and fill in the table below:

FieldValue
API ProviderAnthropic
Anthropic API KeyYour TokenBay API key (sk-...)
Use custom base URLChecked
Custom Base URLhttps://api.tokenbay.com
Modelclaude-sonnet-4.6

Saves take effect immediately, no restart needed.

3. Alternative: configure the OpenAI Compatible provider

When you need non-Claude models like GPT / DeepSeek, add a new provider:

FieldValue
API ProviderOpenAI Compatible
Base URLhttps://api.tokenbay.com/v1
API KeyYour TokenBay API key (sk-...)
Model IDgpt-5.3-codex (or any other available model)

After filling it in, click Verify to check connectivity; once it passes you’re good to go.

Use caseModel IDProvider
Main codingclaude-sonnet-4.6Anthropic
Complex refactor / long contextclaude-opus-4.8Anthropic
Lightweight / fast responseclaude-haiku-4.5Anthropic
GPT coding alternativegpt-5.3-codexOpenAI Compatible
GPT general flagshipgpt-5.5OpenAI Compatible

Model IDs are passed through to the upstream directly, with no prefix. For the full available list, see Models.

Model name format: in TokenBay model names, version numbers only accept the dot form (e.g. claude-sonnet-4.6, gpt-5.4) — don’t write them with hyphens (claude-sonnet-4-6, gpt-5-4).

The table above is illustrative; for the exact Model ID and endpoint, defer to the console Models page (or Models). Verify before connecting, and confirm the group your API key belongs to has been authorized for that model.

5. Advanced config (long tasks / proxy)

  • Auto-approval limit: Cline’s tool calls have a default cap on auto-approval rounds. For complex tasks, raise Max Requests in the settings panel to reduce frequent manual confirmations.
  • Network and timeouts: the VS Code version of Cline reuses VS Code’s own network/proxy settings. Behind a corporate network or firewall, configure http.proxy in VS Code settings (see the official networking and proxies docs). Long-context tasks take a while; if requests get interrupted, first check whether a proxy or firewall is blocking api.tokenbay.com.
  • Switching between configs: Cline supports saving multiple API Configuration Profiles — you can save “Anthropic + claude-sonnet-4.6” and “OpenAI Compatible + gpt-5.4” as two separate profiles and switch between them as needed.