> ## Documentation Index
> Fetch the complete documentation index at: https://docs.nomask.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Cline

> Set up NoMask in the Cline editor extension.

Connect Cline in VS Code to NoMask for chat, workspace tools and file edits.

## Before you start

* Create a key on the [API Keys page](https://nomask.ai/api/keys) and add funds to your API balance.
* Choose a text model with **Function calling** and streaming on the [Models page](https://nomask.ai/models). Copy its exact model ID.
* Use the connection values below. Replace key placeholders locally; keep secrets out of project files and source control.

| Setting | Value |
| - | - |
| **API base URL** | `https://api.nomask.ai/v1` |
| **Model ID** | `your-model-id` |
| **API key** | Your NoMask API key |

> [!NOTE]
>
> Replace `your-model-id` throughout the examples with the exact ID of a text model that supports function calling and streaming. Check the [Models page](https://nomask.ai/models) for current availability and limits.

Examples use your selected model. If you change it, also update context, output and image settings to match that model. These guides cover text models; Image Studio models use separate image endpoints.

## Configure Cline

In VS Code, open Extensions with `Ctrl/Cmd + Shift + X`, search for Cline, and install the official extension. Open its sidebar panel and open a workspace folder.

1. Open Cline's settings using the gear icon. If the welcome screen asks how to connect, choose the option to use your own API key.
2. Set **API Provider** to **OpenAI Compatible** and enter the connection values below.
3. Choose or type the exact Model ID. Keep streaming enabled for the first test.
4. If Cline uses different models for Plan and Act, configure this connection for both modes, or turn that option off while testing.
5. Save the settings and use Verify if your version shows that button.

| Setting | Value |
| - | - |
| **API Provider** | OpenAI Compatible |
| **Base URL** | `https://api.nomask.ai/v1` |
| **API Key** | Your NoMask API key, without adding `Bearer`. |
| **Model ID** | `your-model-id` |
| **API protocol** | OpenAI Chat Completions |

Use the base URL exactly as shown, ending in `/v1`. Cline adds `/chat/completions`; do not append it yourself. A built-in connection that requires `/responses` is not the NoMask connection.

### Model configuration

* Context window: copy the selected model’s context length from Models.
* Maximum output: use the selected model’s output limit or lower.
* Enable image input only when the selected text model supports vision. An image-generation model cannot power Cline's coding conversation.

### Connection reference

This JSON summarizes the values to enter in the settings UI. It is not an import file for the extension.

```json theme={"system"}
{
  "base_url": "https://api.nomask.ai/v1",
  "api_key": "YOUR_NOMASK_API_KEY",
  "model": "your-model-id",
  "api": "chat/completions"
}
```

## Test chat and tools

Open a small test folder in the editor and add a file named `hello.txt` containing `Hello`. Start a new task with the NoMask connection selected.

1. Ask for a short text reply first: `Reply with the word ready.`
2. Ask `Read hello.txt and tell me what it contains.` Approve the file-read action if prompted.
3. Choose **Act mode**, then ask `Change hello.txt to say Hello from NoMask. Do not change any other file.`
4. Review the proposed diff, approve it, and check the saved file. A reply alone does not verify that file editing works.

Text, a file-read tool action and an applied edit confirm the complete connection. These tasks make billable API requests; inspect their usage on your [API overview](https://nomask.ai/api/overview).

Plan mode can inspect files but does not make edits. If the model replies with an edit plan without changing the file, switch to Act and check its permissions.

## Troubleshooting

* **401:** check that your key is active and available to the process running the tool. Restart the tool after changing environment variables.
* **402:** add funds to your API balance or reduce the requested output.
* **404:** check the exact model ID and base URL. Direct connections use Chat Completions, not Responses or Anthropic Messages.
* **429:** wait for `Retry-After`. API keys share account limits; creating another key does not reset usage. Check the key's monthly spending cap too.
* **Context or tool errors:** start a shorter task, lower the output limit and confirm the model supports function calling. A plain text reply alone does not confirm file-editing tools work.

Check [API Overview](https://nomask.ai/api/overview) for usage and recent errors. Include the request ID when contacting support; never send your key. See [Errors](https://docs.nomask.ai/errors.md) and [Rate Limits](https://docs.nomask.ai/rate-limits.md).

## Official references

Setup checked against the documentation below. Tool versions may change their settings or configuration format.

* [Cline installation](https://docs.cline.bot/getting-started/installing-cline)
* [Cline OpenAI-compatible settings](https://docs.cline.bot/provider-config/openai-compatible)
* [Cline Plan and Act modes](https://docs.cline.bot/core-workflows/plan-and-act)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.