Overview

OpenCode (slug opencode) is a coding agent CLI driven non-interactively through its opencode run subcommand. It reaches its model through OpenRouter, so an OpenCode run reports OpenRouter-style model IDs and is priced from the model’s list price. The harness itself is documented at opencode.ai.

Model IDs

OpenCode’s model IDs are OpenRouter slugs carrying an openrouter/ prefix. A run adds that prefix at launch when the model is bound to the OpenRouter provider. The following are illustrative, not exhaustive:

• openrouter/minimax/minimax-m3
• openrouter/google/gemini-3.5-flash

Invocation

The harness probes and invokes the opencode binary. It is installed into the run container at run time with:

npm install -g opencode-ai && npm cache clean --force

A session runs the run subcommand with these flags, followed by the prompt as the final positional argument:

Flag	Purpose
--format json	Emit the line-delimited JSON stream consumed for events and usage.
--dangerously-skip-permissions	Run unattended, without per-action approval prompts.
--model <id>	The model to run.

Authentication

OpenCode authenticates with an OpenRouter API key, sourced from OPENROUTER_API_KEY on the host and injected into the run container under the same name. See Authentication.

Pricing

The leading openrouter/ is stripped before the catalog lookup, so openrouter/minimax/minimax-m3 is priced as minimax/minimax-m3. OpenCode reports no run cost of its own, so its actual cost equals the comparable cost. See Metrics.