# OpenCode

[OpenCode](https://opencode.ai/) is a terminal coding assistant. It
expects an OpenAI-compatible endpoint, which is what LowRouter
exposes.

## Configure

OpenCode reads its config from `~/.config/opencode/opencode.json`.
Point the OpenAI provider entry at LowRouter:

```json
{
  "providers": {
    "openai": {
      "baseURL": "https://lowrouter.ai/api/v1",
      "apiKey": "lr-sk-..."
    }
  },
  "defaultModel": "lowrouter/auto"
}
```

Restart OpenCode after editing the file.

## Picking a model

Inside OpenCode, run `/model` and pick from the list. If a model isn't
listed, type the LowRouter model ID directly — any model on the
[model browser](/models) is routable.

For coding tasks, the auto route (`lowrouter/auto`) generally picks
something appropriate. If you want a specific model:

- For long contexts: a model with ≥128K context window. The model
  browser tags context length per model.
- For latency-sensitive iteration: an `*-mini` or `*-haiku-*` variant.
- For careful reasoning: a top-tier reasoning model.

## Recommended setup

- **Dedicated key with a daily limit.** OpenCode is interactive and
  it's easy to lose track of how many tokens you spent in an
  afternoon. A daily limit on the key bounds the surprise.
- **Disable shell-execution tools by default.** OpenCode supports
  letting the model run shell commands; turn that off until you've
  reviewed the prompts the agent sends. Enable it per-session for the
  workflow that needs it.
- **Stream on.** Default in OpenCode; mentioned for completeness.

## Troubleshooting

- **Hangs on the first request**: confirm `baseURL` ends with `/v1`
  (no trailing slash). OpenCode appends `/chat/completions` itself.
- **Model "not found"**: the model isn't in OpenCode's autocomplete
  list, but it is routable. Run `/model lowrouter/auto` to confirm
  the gateway is reachable, then use the explicit model ID.