---
title: "Connect Cline to XiuRouter"
description: "Configure Cline with an OpenAI-compatible connection and verify read-only tasks and reversible edits."
image: "https://docs.xiu.ai/og.png"
---

> XiuAI documentation index
> Full documentation index: https://docs.xiu.ai/en/llms.txt
> Check the index for current pages before reading.

# Connect Cline to XiuRouter

Choose OpenAI Compatible and enter the XiuRouter URL, key, and exact model ID. If you already use Cline, record the original provider, Base URL, and model first.

## Choose a setup method

- First setup: enter the XiuRouter connection details.
- Existing setup: record the original settings before switching.
- Chat-assisted setup: unavailable; the extension's settings UI stores the provider and credentials.

## Before you start

- Install the current stable Cline extension in VS Code.
- Create a dedicated XiuRouter key for Cline.
- Copy a model ID from the current XiuRouter catalog.

## Configure Cline

1. Open Cline settings.
2. Record the current API Provider, Base URL, and Model ID for rollback. Skip this step for a first setup.
3. Choose `OpenAI Compatible` as API Provider.
4. Set Base URL to `https://router-api.xiu.ai/v1`.
5. Enter the XiuRouter API key.
6. Enter the exact model ID from the current catalog.
7. Save the settings.

Leave advanced context, output-limit, image, and tool settings unset until you have verified them with that model.

## Verify

1. Create a new Cline task.
2. Ask it to read and summarize a nonsensitive file without editing it.
3. In XiuRouter's request inspection view, verify the key, model, endpoint, and success status.
4. Request a reversible edit to a test file and confirm the tool call and result return correctly.

A settings-page verification message does not prove that the agent's tools work. Complete at least one read and one reversible edit.

## Troubleshoot

| Symptom | Next step |
| --- | --- |
| Key validation fails | Include `/v1` in the Base URL and check key validity and model scope |
| Chat works but file editing fails | Use a model with verified tool support and check Cline's advanced capability settings |
| Long tasks stop | Use the direct `router-api.xiu.ai` Base URL |
| Unexpected model or route | Stop the task and inspect the key, model, endpoint, and timestamp in request logs |

## Roll back

Restore the original provider, Base URL, and model in Cline settings. Verify a new task uses the old route before revoking the XiuRouter test key.

## Sources and review date

Reviewed on 2026-08-31. This translation preserves that date. Basic setup requires a complete reply and the matching successful XiuRouter request record.

Source: https://docs.xiu.ai/en/router/integrations/cline/index.mdx