Skip to main content

​
Overview

The models command displays all AI models available from your configured providers. Use this to:
  • Discover available models
  • Find exact model names for configuration
  • Filter models by provider
  • View model metadata and pricing

​
Usage

opencode models [provider]
Models are displayed in the format provider/model, which is the format used in configuration files and the --model flag.

​
Options

​
provider
string
Optional provider ID to filter models. Only shows models from this provider.
​
--refresh
flag
Refresh the models cache from models.dev. Use this when new models are released.
​
--verbose
flag
Show detailed model information including pricing, context windows, and capabilities.

​
Examples

​
List All Models

Show models from all configured providers: 
opencode models
Output: 
anthropic/claude-4.5-sonnet
anthropic/claude-4.0-opus
anthropic/claude-3.5-sonnet
anthropic/claude-3-haiku
openai/gpt-4o
openai/gpt-4-turbo
openai/gpt-3.5-turbo
opencode/claude-max
opencode/gpt-plus
...

​
Filter by Provider

Show only Anthropic models: 
opencode models anthropic
Output: 
anthropic/claude-4.5-sonnet
anthropic/claude-4.0-opus
anthropic/claude-3.5-sonnet
anthropic/claude-3-haiku

​
Show Detailed Information

View model metadata: 
opencode models anthropic --verbose
Output: 
anthropic/claude-4.5-sonnet
{
  "id": "claude-4.5-sonnet",
  "name": "Claude 4.5 Sonnet",
  "contextWindow": 200000,
  "maxTokens": 8192,
  "pricing": {
    "input": 0.003,
    "output": 0.015
  },
  "capabilities": ["vision", "function-calling", "streaming"]
}

​
Refresh Model Cache

Update the cached model list from models.dev: 
opencode models --refresh
This fetches the latest model information and is useful when:
  • New models are released
  • Model pricing changes
  • You add a new provider

​
Model Format

All models follow the provider/model format: 
provider/model
   │       │
   │       └─ Model ID within provider
   └─────────Provider ID from models.dev
Examples:
  • anthropic/claude-4.5-sonnet
  • openai/gpt-4o
  • google/gemini-2.0-flash-exp
  • opencode/claude-max

​
Using Model Names

​
In Configuration

Set default model in opencode.json: 
{
  "model": "anthropic/claude-4.5-sonnet"
}

​
With CLI Flags

Specify model when starting OpenCode: 
opencode --model anthropic/claude-4.5-sonnet
Or with the run command: 
opencode run --model openai/gpt-4o "Explain recursion"

​
Model Switching

Switch models mid-session using the /model command: 
/model anthropic/claude-4.5-sonnet

​
Provider Order

Models are displayed in a specific order:
  1. OpenCode providers (e.g., opencode/claude-max) - shown first
  2. Other providers - alphabetically by provider ID
Within each provider, models are alphabetically sorted.

​
Model Information

With --verbose, you can see:
  • Context window: Maximum input tokens
  • Max tokens: Maximum output tokens
  • Pricing: Input and output costs per 1K tokens
  • Capabilities: Features like vision, function calling, streaming
  • Modalities: Supported input/output types

​
Understanding Provider IDs

Common provider IDs:
ProviderIDAuthentication
OpenCodeopencodeOpenCode API key
AnthropicanthropicClaude API key
OpenAIopenaiOpenAI API key
GooglegoogleGoogle AI API key
GitHub Copilotgithub-copilotGitHub Copilot subscription
OpenRouteropenrouterOpenRouter API key
VercelvercelVercel API key
Amazon Bedrockamazon-bedrockAWS credentials

​
Models.dev

OpenCode uses models.dev as the central registry for AI models. This provides:
  • Unified model metadata
  • Up-to-date pricing information
  • Capability and feature information
  • Support for 50+ providers

​
Cache Management

Model information is cached locally for performance. The cache:
  • Updates automatically on first run each day
  • Can be manually refreshed with --refresh
  • Is stored in ~/.local/share/opencode/models.json

​
Provider Configuration

Before using models from a provider, you must authenticate: 
# Add authentication for a provider
opencode auth login

# Select provider and enter credentials
# Then list models from that provider
opencode models <provider-id>
See the auth command for authentication details.

​
Filtering and Searching

While the command doesn’t have built-in search, you can use standard Unix tools:

​
Search by Name

opencode models | grep claude
opencode models | grep -i gpt

​
Count Models

opencode models | wc -l
opencode models anthropic | wc -l

​
Show Specific Range

opencode models | head -10
opencode models | tail -20

​
Troubleshooting

​
No Models Shown

Problem: Command returns empty or shows no models Solutions:
  • Run opencode models --refresh to update cache
  • Check internet connectivity
  • Verify you’ve authenticated with opencode auth login
  • Check provider is enabled in config

​
Provider Not Found

Problem: Provider not found: <provider> Solutions:
  • Check provider ID spelling
  • Run opencode models without arguments to see available providers
  • Ensure provider is configured in opencode.json
  • Authenticate with the provider: opencode auth login

​
Models Out of Date

Problem: New models missing from list Solutions:
  • Run opencode models --refresh
  • Check models.dev for latest models
  • Verify OpenCode is up to date: opencode upgrade

​
Environment Variables

The models command respects these environment variables:
VariableDescription
OPENCODE_DISABLE_MODELS_FETCHDisable fetching models from remote sources
OPENCODE_MODELS_URLCustom URL for fetching model configuration
OPENCODE_ENABLE_EXPERIMENTAL_MODELSShow experimental/beta models

auth

Authenticate with model providers

Configuration

Configure default models

Providers

Learn about available providers

TUI

Using models in the interface