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

# OpenCode Desktop | AI Gateway

> Route OpenCode Desktop model calls through Orq.ai AI Gateway for unified observability, cost tracking, and model governance.

Route every model call OpenCode Desktop makes through the [**Orq.ai AI Gateway**](/docs/ai-gateway/get-started/quickstart) by adding a custom provider in the app. Requests appear in [Traces](/docs/ai-gateway/traces) automatically.

## Prerequisites

* OpenCode Desktop installed:

```bash Homebrew theme={"theme":{"light":"github-light","dark":"github-dark"}}
brew install --cask opencode-desktop
```

Or download the installer from [opencode.ai/download](https://opencode.ai/download).

* Active **Orq.ai** account with **AI Gateway** access
* [Orq.ai API key](/docs/ai-gateway/api-keys)

## Setup

In OpenCode Desktop, open **Settings** > **Providers** > **Connect custom provider** and fill in:

* **ID**: `orq`
* **Display name**: `Orq`
* **Base URL**: `https://api.orq.ai/v3/router`
* **API key**: your [Orq.ai API key](/docs/ai-gateway/api-keys)
* **Model ID**: any identifier from the **AI Gateway** catalog, for example `anthropic/claude-sonnet-4-6`, with a **display name**

Add more models by giving each its own **Model ID** and display name. Pick the model from the model selector in the chat input bar.

<Frame caption="Connecting Orq.ai as a custom provider in OpenCode Desktop">
  <img src="https://mintcdn.com/orqai/Cl5LYVadY_TFIxXO/images/opencode-desktop-integration.png?fit=max&auto=format&n=Cl5LYVadY_TFIxXO&q=85&s=d5f6699b9b67ab25cc38fd26925a9ee9" alt="OpenCode Desktop custom provider form filled in with the Orq ID, Orq display name, router base URL, API key, and a model ID" width="1248" height="1008" data-path="images/opencode-desktop-integration.png" />
</Frame>

## Verification

Send a prompt in OpenCode Desktop. The response appears in the app and the trace appears in [**Orq.ai** Traces](/docs/ai-gateway/traces) with the selected model identifier.
