Cline

Compatibility first

Standalone gateway only for agent workflows. Cline uses tools and structured tool results. These are rejected by the current prepaid API, even with customer BYOK enabled.

Prepare a standalone deployment, an enabled tool-capable model, and a dedicated managed gateway key.

Configure the extension

Open Cline's settings using its gear icon. Choose OpenAI Compatible, then enter:

Field	Value
Base URL	https://STANDALONE_GATEWAY_HOST/v1
API key	Your dedicated managed ZRouter key
Model ID	Exact PROVIDER_INSTANCE/MODEL_ID returned by the gateway
Max output tokens	A limit supported by the selected model
Context window	The selected model's actual context limit

Use OpenAI Compatible, rather than assuming the native OpenAI provider offers the same custom URL settings. Only enable image or computer-use capabilities when supported by the selected provider. See Cline's official provider setup.

Verify

Save the settings and use Verify if available. Start a small task, such as reading one file and explaining it. Check gateway logs for successful inference and tool exchanges. Tools run under Cline's permission controls; routing through ZRouter does not replace those controls.

Troubleshooting

• For authentication errors, use the managed gateway key, not the upstream provider key or an operator master key.
• For 404, the base URL should end at /v1, not /v1/chat/completions.
• For unknown models, copy the gateway's exact identifier instead of a display label.
• For tools is not supported, the endpoint is using prepaid billing and cannot currently serve Cline agent sessions.

See shared troubleshooting. The settings in this guide apply to Cline's OpenAI-compatible extension configuration; other Cline interfaces may have separate settings.