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
- Open Cline settings.
- Record the current API Provider, Base URL, and Model ID for rollback. Skip this step for a first setup.
- Choose
OpenAI Compatibleas API Provider. - Set Base URL to
https://router-api.xiu.ai/v1. - Enter the XiuRouter API key.
- Enter the exact model ID from the current catalog.
- Save the settings.
Leave advanced context, output-limit, image, and tool settings unset until you have verified them with that model.
Verify
- Create a new Cline task.
- Ask it to read and summarize a nonsensitive file without editing it.
- In XiuRouter’s request inspection view, verify the key, model, endpoint, and success status.
- 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.