OpenCode

Arbytra is in OpenCode’s provider registry, giving you access to 15 models through a single API key.

Prerequisites

OpenCode 1.4.10+
An Arbytra API key

Install OpenCode

Run the official install script:

curl -fsSL https://opencode.ai/install | bash

Or install via npm:

npm i -g opencode-ai

Or via Homebrew (macOS):

brew install opencode

Open a new terminal if you used the install script, then confirm:

opencode --version

You need version 1.4.10 or later. The install script writes PATH to ~/.bashrc, which non-interactive shells don’t source. In CI, GitHub Actions, or agent-driven sessions, add this before invoking opencode:

export PATH="$HOME/.opencode/bin:$PATH"

Set your API key

Export your API key:

export ARBYTRA_API_KEY="ak_live_..."

Your key starts with ak_live_ (production) or ak_test_ (testing). Add this line to ~/.zshrc or ~/.bashrc to persist it across terminal sessions. Reload your shell after saving:

source ~/.zshrc   # or: source ~/.bashrc

Or open a new terminal.

Verify

Run this from inside a git repository. OpenCode requires a git working tree.

opencode run "Say exactly: setup-ok" --model arbytra/claude-sonnet-4-6 --pure

OpenCode prints extra setup output on first run. The model response follows.

Set default model

To avoid passing --model on every run, create an opencode.json in your project root:

{
  "$schema": "https://opencode.ai/config.json",
  "model": "arbytra/claude-sonnet-4-6"
}

You can also place this at ~/.config/opencode/opencode.json to set a global default. A project-root config takes precedence. You don’t need a provider block. OpenCode resolves Arbytra’s models automatically.

Use different models

Pass any registered model with the --model flag:

opencode run "Summarize this repo" --model arbytra/deepseek-v4-flash
opencode run "Review my code" --model arbytra/gemini-2.5-pro

To start an interactive session:

opencode

Use /models to browse and switch models during a session. These models are registered in OpenCode’s provider registry and work without configuration:

Model	Author	Context
`claude-sonnet-4-6`	Anthropic	1M
`claude-opus-4-6`	Anthropic	1M
`claude-opus-4-7`	Anthropic	1M
`deepseek-v4-flash`	DeepSeek	1M
`deepseek-v4-pro`	DeepSeek	1M
`gemini-2.5-flash`	Google	1M
`gemini-2.5-pro`	Google	1M
`gemini-3.1-pro-preview`	Google	1M
`glm-5.1`	Z.AI	200K
`grok-4.3`	xAI	1M
`kimi-k2.5`	Moonshot	262K
`kimi-k2.6`	Moonshot	262K
`minimax-m2-7`	MiniMax	205K
`minimax-m2-7-highspeed`	MiniMax	205K
`qwen-3.6-plus`	Alibaba	1M

To list all Arbytra models (not just the 15 registered in OpenCode):

curl -s -H "Authorization: Bearer $ARBYTRA_API_KEY" \
  https://api.arbytra.com/v1/models | jq '.data[].id'

Add unregistered models

The 15 registered models work without configuration. To use any of the 250+ other models Arbytra serves, add a provider and model definition to your opencode.json:

{
  "$schema": "https://opencode.ai/config.json",
  "model": "arbytra/deepseek-v3.2",
  "provider": {
    "arbytra": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "Arbytra",
      "env": ["ARBYTRA_API_KEY"],
      "options": {
        "baseURL": "https://api.arbytra.com/v1",
        "apiKey": "{env:ARBYTRA_API_KEY}"
      },
      "models": {
        "deepseek-v3.2": {
          "name": "DeepSeek V3.2",
          "reasoning": true,
          "tool_call": true,
          "temperature": true,
          "limit": { "context": 163840, "output": 8192 },
          "modalities": { "input": ["text"], "output": ["text"] }
        }
      }
    }
  }
}

Browse model capabilities via the directory API to fill in the model definition fields.

Control routing

Configure routing in the Arbytra dashboard. See routing options for details.

Uninstall

Remove ARBYTRA_API_KEY from your shell profile (~/.zshrc or ~/.bashrc). If you created an opencode.json, remove the arbytra-related lines or delete the file.

Troubleshoot

Symptom	Cause	Fix
`Error: API key is invalid.`	`ARBYTRA_API_KEY` not set or key is wrong	Run `echo $ARBYTRA_API_KEY`. If empty, export it. If set, verify at `https://api.arbytra.com/v1/me`
`Error: Model not found: arbytra/<id>`	Model not in registry and no local definition	Add a model definition to `opencode.json` (see “Add unregistered models”)
`opencode: command not found`	Install script PATH not loaded in non-interactive shell	Run `export PATH="$HOME/.opencode/bin:$PATH"` before invoking `opencode`
Connection error	`baseURL` wrong or has trailing slash	Use exactly `https://api.arbytra.com/v1`
Config not taking effect	Local config overriding global	Check both `~/.config/opencode/opencode.json` (global) and `./opencode.json` (project root)
Empty response from `opencode run`	Not inside a git repository	Run from inside a git repo, or run `git init` first

Get Started

Guides

Response API

Frameworks

Integrations

Specifications

Platform

Changelog

Prerequisites

Install OpenCode

Set your API key

Verify

Set default model

Use different models

Add unregistered models

Control routing

Uninstall

Troubleshoot

​Prerequisites

​Install OpenCode

​Set your API key

​Verify

​Set default model

​Use different models

​Add unregistered models

​Control routing

​Uninstall

​Troubleshoot

Prerequisites

Install OpenCode

Set your API key

Verify

Set default model

Use different models

Add unregistered models

Control routing

Uninstall

Troubleshoot