Setup guide

Use Toolgram with Cline in VS Code

Cline is a coding agent that runs inside VS Code. It can use any OpenAI-compatible endpoint, which means you are not locked into one provider's subscription.

Updated 22 October 2026 · Toolgram

Quick answer

In Cline open the settings gear, set the API provider to OpenAI Compatible, enter https://toolgram.app/api/v1 as the base URL, paste a Toolgram API key, and set the model ID from toolgram.app/app/models. Add USDT credit first, because every task bills per token.

Before you start

You need a Toolgram key and a funded balance. Both are at toolgram.app/app. Add at least $2 of USDT on TON, then create a key in the API tab.

Step by step

  1. Install Cline. Add the extension from the VS Code marketplace and open the Cline panel in the sidebar.
  2. Open the settings. Click the gear icon in the Cline panel.
  3. Set the provider. Choose OpenAI Compatible from the API provider list.
  4. Enter the base URL. Paste https://toolgram.app/api/v1.
  5. Paste the key. Add the Toolgram key. Remove any trailing space.
  6. Set the model ID. Copy the exact ID from the models page. A wrong ID is the most common failure.
  7. Run a small task. Ask Cline to read one file and summarise it. Then check the balance to confirm billing works.

The settings at a glance

API Provider:  OpenAI Compatible
Base URL:      https://toolgram.app/api/v1
API Key:       sk-...  (from the API tab)
Model ID:      deepseek-v4.1-flash  (any ID from /app/models)
Context:       match the model's context window

Choosing a model for coding

Cline works by sending the model file contents and tool definitions, then acting on the answer. That makes two properties matter more than raw benchmark scores: a large context window and reliable tool calling. The models page lists both.

Long agent sessions also send a lot of repeated context, so cost per turn is dominated by input tokens. A model with cheap input and solid tool calls usually beats a stronger model that re-reads the whole repository on every step.

Troubleshooting

Invalid API key

Check three things in order: the provider is OpenAI Compatible, the base URL ends in /api/v1, and the key has no spaces. If all three are right, create a new key.

Model not found

The ID must match the catalog exactly. Copy it from the models page. Do not prefix it with a provider name and do not add a second /v1 to the URL.

Requests fail mid-task

A long agent task can exhaust a small balance. Check the dashboard. Top up and re-run; the key stays the same.

Images are ignored

Only vision models accept images. If the selected model is text-only, Cline drops the image context.

Related

Frequently asked questions

Which API provider do I choose in Cline?

Choose OpenAI Compatible. Cline then asks for a base URL, an API key, and a model ID. Use https://toolgram.app/api/v1 as the base URL and paste a Toolgram key. Do not choose OpenAI, because Cline would then send the key to OpenAI's own endpoint.

Which model should I use for coding in Cline?

Pick a model with tool calling and a large context window, because Cline reads files and sends several tool calls per task. The models page shows context size and whether tools are supported. Start with a mid-priced model and move up only if the diffs are weak.

Why does Cline say invalid API key?

Either the key is wrong or the base URL still points at another provider. Confirm the provider is OpenAI Compatible, the base URL ends in /api/v1, and the key was copied from the API tab without extra spaces. A revoked key fails the same way.

Why does the model fail with 404 or model not found?

Cline sends the model ID exactly as typed. Copy the ID from toolgram.app/app/models and paste it in. Do not add a provider prefix. If the base URL already contains /v1, do not add another one.

Does Cline support vision and file reads with Toolgram?

Cline can send images only if the selected model supports vision, and file reads use the model's tool calling. Check both capabilities on the models page before relying on screenshots or large refactors. A text-only model will ignore image context.

Do I need a subscription to use Cline?

No. Cline is free and open source. You pay only for the tokens your tasks consume, deducted from the prepaid Toolgram balance. There is no seat fee and no monthly minimum, and unused credit does not expire.

Start with $2

Top up with USDT on TON, create a key, and point your client at one base URL. No card, no subscription, credit never expires.