OpenCode Zen

Overview

OpenCode Zen is designed for users who want a hassle-free setup without configuring individual API keys for OpenAI, Anthropic, Google, or other providers. The opencode team curates, tests, and verifies the model lineup, so you always have access to reliable, high-quality models.

• Single billing point — One subscription, one bill, no multiple provider accounts.
• Curated selection — Models are tested and verified by the opencode team.
• No API keys — No need to sign up for individual provider accounts.
• Works out of the box — Connect once and choose a model.

tip

No API keys from external providers are needed — Zen handles model access for you.

Setup

Step 1: Connect

Open the command palette and run:

/connect

Step 2: Select OpenCode Zen

From the provider list, choose OpenCode Zen.

Step 3: Sign In

A browser window opens to https://opencode.ai/auth. Sign in with your opencode account. If you do not have one, create it — the process takes less than a minute.

Step 4: Get Your API Key

After signing in:

1. Navigate to the API Keys section of your opencode dashboard.
2. Generate a new API key.
3. Copy the key to your clipboard.

Step 5: Paste the Key

Return to the terminal and paste the API key when prompted. opencode confirms the connection.

Step 6: Choose a Model

Run:

/models

Browse the Zen model lineup and select one. The list includes the models currently recommended by the opencode team.

Available Models

The Zen model roster changes over time as new models are released and tested. At any time, you can see the full list by running /models. Models are categorized by capability:

• Flagship — Best overall performance for complex coding tasks.
• Balanced — Good performance with lower latency.
• Fast — Quick responses for simple edits and completions.
• Specialized — Models tuned for specific domains (security, documentation, etc.).

Each model listing in /models shows:

• Model name and identifier.
• Capability rating (speed, quality, context window).
• Recommended use cases.

Billing

Billing is handled through the opencode.ai website.

Subscription Management

1. Visit https://opencode.ai/account/subscription.
2. View your current plan and usage.
3. Upgrade, downgrade, or cancel as needed.

Usage Tracking

Your opencode dashboard shows:

• Total tokens consumed.
• Model-wise breakdown.
• Session history.
• Monthly spending.

Comparison with Other Providers

Aspect	OpenCode Zen	Direct Provider (OpenAI, Anthropic, etc.)
Setup	Single connection, one API key	Multiple accounts, multiple keys
Billing	One bill from opencode	Separate bills per provider
Model curation	Tested and verified by opencode team	Full provider catalog
Availability	Dependent on opencode service	Dependent on each provider
Cost	Subscription-based	Pay-per-token per provider

OpenCode Zen is completely optional. It works exactly like any other provider in opencode. You can switch between Zen and other providers at any time.

note

Billing is handled through opencode.ai — your Zen subscription is separate from any direct provider accounts.

Troubleshooting

Connection Fails

If the connection to OpenCode Zen fails:

• Verify your internet connection.
• Ensure https://opencode.ai is accessible from your network.
• Check that your API key has not expired. Generate a new one from the dashboard.

No Models Listed

If /models shows no results:

• Confirm the API key is correctly configured.
• Run /connect and re-authenticate.
• Check your subscription status at https://opencode.ai/account/subscription.

Authentication Errors

• Generate a fresh API key from the dashboard.
• Ensure you copied the entire key without extra whitespace.
• Keys are tied to your account — make sure you are signed into the correct account.