OpenCode Desktop Integration

Connect OpenCode Desktop to 210+ models through LLM Gateway. No config files — just open Settings, connect, and start building.

OpenCode Desktop is the GUI desktop app version of OpenCode — an open-source AI coding agent with a full visual interface for managing providers, models, and sessions. LLM Gateway is a built-in provider, so setup takes under a minute with no config files required.

Looking for the CLI version? See the OpenCode CLI guide.

Prerequisites

OpenCode Desktop installed — download for Windows or macOS
An LLM Gateway API key — sign up free (no credit card required)

Installation

Download OpenCode Desktop from opencode.ai/download and install it for your platform:

macOS (Apple Silicon) — .dmg installer
macOS (Intel) — .dmg installer
Windows — .exe installer

You can also install on macOS via Homebrew:

brew install --cask opencode-desktop

Setup

Open Providers Settings

Launch OpenCode Desktop. Click the Providers section in the left sidebar under Server. You'll see the list of built-in providers:

OpenCode Desktop Providers screen

Find LLM Gateway

Click Show more providers at the bottom of the list, or click + Connect on any entry to open the provider search. Type LLM in the search box — LLM Gateway will appear under "Other":

Select LLM Gateway from the list.

Enter Your API Key

OpenCode will show the Connect LLM Gateway dialog. Paste your LLM Gateway API key (starts with llmgtwy_) and click Continue:

Connect LLM Gateway — enter API key

Select a Model

Once connected, open the model picker from the chat input bar. Type llm to filter LLM Gateway models — you'll see all available models including Claude Opus 4.7, Claude Sonnet 4.6, DeepSeek, Gemini, and more:

LLM Gateway model selection

Start Building

Select a model and start chatting. All requests route through LLM Gateway — you'll see usage, costs, and logs in your dashboard:

OpenCode Desktop chat active with LLM Gateway

Why Use LLM Gateway with OpenCode Desktop

210+ models — Claude, GPT, Gemini, Llama, DeepSeek, and more from 60+ providers
One API key — Stop managing separate keys for each provider
Cost tracking — See exactly what each session costs in your dashboard
Response caching — Repeated requests hit cache automatically
Automatic fallback — If a provider is down, requests route to an alternative
Volume discounts — Check discounted models for savings up to 90%

Switching Models

You can switch models at any time from the model picker in the chat input bar. Click the current model name, type llm to filter to LLM Gateway models, and select a new one. The switch takes effect immediately for the next message.

Locking to a Specific Provider

By default, LLM Gateway automatically fails over to alternative providers if your chosen provider is experiencing downtime. To disable fallback for a specific model, you can pass the X-No-Fallback header via a custom opencode.json in your project root:

{
	"provider": {
		"llmgateway": {
			"options": {
				"headers": {
					"X-No-Fallback": "true"
				}
			}
		}
	}
}

Disabling fallback means requests will fail if the chosen provider is down. See the routing docs for details.

Need help? Join our Discord community for support and troubleshooting assistance.