Cline
Connect the Cline agent in VS Code to OneProvider: choose OpenAI Compatible, enter the base URL and model ID, run a small task and verify usage.
Open-source coding agent for VS Code using OneProvider's OpenAI-compatible API.
All models, capabilities, and prices Documentation index for AI agents:https://oneprovider.dev/docs/llms.txt Cline coding agent for VS Code
Official documentationWhat works
Cline sends OpenAI-compatible text and coding-agent requests through OneProvider with a compatible model ID you select from the catalog.
Client limitation
Image, tool-use, and context capabilities depend on the exact selected model; verify with a small text task first.
Before you start: a key from your cabinet Open your cabinet: the Telegram bot @oneprovider_robot (Account) or app.oneprovider.dev . Press “Issue a key”, give it a name (for example, this client) and a spend limit, and copy the key. You top up the balance in the same place. More about the cabinet and keys .Setup
-
Choose OpenAI Compatible
In Cline API Provider settings, choose OpenAI Compatible and paste your OneProvider key.
API Provider: OpenAI Compatible API Key: sk-your-key-here -
Set the custom base URL
Set the base URL to https://api.oneprovider.dev/v1 and the exact model ID to gpt-5.6-terra.
Base URL: https://api.oneprovider.dev/v1 Model ID: gpt-5.6-terra -
Start a small text task
Open a new Cline session and request one small read-only explanation before enabling model-specific capabilities.
Verify the connection
Confirm the request in Dashboard Usage
The request should show the configured model and a settled OpenAI-compatible usage row.
Connection details
- Protocol
- openai-chat
- Endpoint
- https://api.oneprovider.dev/v1
Key security
Use a dedicated key with model, rate, spend, and expiry limits; never commit the key in workspace settings.
Which model to choose
Cline uses the OpenAI Compatible provider, so enter the model id exactly as in the catalog . gpt-5.6-terra is a balanced default for coding tasks, gpt-6.1-sol suits large multi-file work, gpt-5.6-luna is cheap for quick questions. Claude ids also work through the same provider, for example claude-sonnet-5-5. Image input, tool use and context size depend on the exact model, so start with one small read-only task. If Cline asks for a context window or max output, copy the values from the model row in the catalog.
Common errors and fixes
404 or “Invalid URL”
Base URL must be https://api.oneprovider.dev/v1: with /v1, without /chat/completions.
401 Unauthorized
The key is missing a character or has a space or quote around it, or the balance is empty. Paste the whole key again and check the cabinet.
“Model not found” or a 400 about the model
The id has a typo or is not in the catalog. Copy it from the models page; the match is exact and case-sensitive.
429 “Insufficient balance”
The balance or the key’s spend limit is used up. Retrying does not help: top up or raise the limit.
The agent stops after one step
The selected model may not support tool calls well. Pick a frontier or balanced model and keep the task small.
Streams break or hang
Turn off VPN or VLESS proxies: they buffer SSE. OneProvider itself does not.
FAQ
Which provider do I choose in Cline?
OpenAI Compatible. Paste the OneProvider key and the base URL above.
Can I use Claude models in Cline?
Yes, enter a Claude id in the same OpenAI Compatible provider, or use Cline’s Anthropic provider with the custom base URL https://api.oneprovider.dev if your version offers it.
Is my key stored in the repository?
No, Cline keeps it in VS Code’s secret storage. Still, use a dedicated key with a spend limit and never commit it in workspace settings.
Where do I see usage?
In the dashboard Usage page: each request shows the model and a settled charge.
Quick answers
Which base URL do I use?
Claude Code and Anthropic SDKs use https://api.oneprovider.dev. OpenAI SDKs and OpenAI-compatible clients use https://api.oneprovider.dev/v1. One key works behind both; the model list is on the models page ; rates are on the pricing page .
How do I authenticate?
Send the raw sk-… key in x-api-key or Authorization: Bearer: one of them, never both. Keep the key in an environment variable, not in a file that gets committed. More on authentication .
Where do I get a key?
Open your cabinet in the Telegram bot @oneprovider_robot or at app.oneprovider.dev, top up the balance and press “Issue a key”. Each key can carry its own spend limit. Cabinet & API keys .
What do 401, 404 and 429 mean?
401: the key is missing, mistyped or sent in the wrong header; paste the whole key without quotes or spaces. 404: usually a wrong base URL, for example a missing or doubled /v1. 429 with “Insufficient balance”: the cabinet balance or the key’s spend limit is used up, so top up instead of retrying; any other 429 is a rate limit, so wait for Retry-After. Details: error codes and troubleshooting .
Why do streams cut off or reset?
VPN and VLESS proxies often buffer SSE or break HTTP/2 negotiation. OneProvider has no regional restrictions and does not buffer streams, so turn the proxy off and retry.
Where do I ask if this is not enough?
Message @Oneproviderhelpbot on Telegram or open “Support” in the web cabinet, with the HTTP status code and the exact error message. How support works .
Last updated: 2026-10-05 Found a bug? @Oneproviderhelpbot