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

​
Prerequisites

​
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 AURIKO_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 auriko/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": "auriko/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 Auriko’s models automatically.

​
Use different models

Pass any registered model with the --model flag: 
opencode run "Summarize this repo" --model auriko/deepseek-v4-flash
opencode run "Review my code" --model auriko/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:
ModelAuthorContext
claude-sonnet-4-6Anthropic1M
claude-opus-4-6Anthropic1M
claude-opus-4-7Anthropic1M
deepseek-v4-flashDeepSeek1M
deepseek-v4-proDeepSeek1M
gemini-2.5-flashGoogle1M
gemini-2.5-proGoogle1M
gemini-3.1-pro-previewGoogle1M
glm-5.1Z.AI200K
grok-4.3xAI1M
kimi-k2.5Moonshot262K
kimi-k2.6Moonshot262K
minimax-m2-7MiniMax205K
minimax-m2-7-highspeedMiniMax205K
qwen-3.6-plusAlibaba1M
To list all Auriko models (not just the 15 registered in OpenCode): 
curl -s -H "Authorization: Bearer $AURIKO_API_KEY" \
  https://api.auriko.ai/v1/models | jq '.data[].id'

​
Add unregistered models

The 15 registered models work without configuration. To use any of the 250+ other models Auriko serves, add a provider and model definition to your opencode.json: 
{
  "$schema": "https://opencode.ai/config.json",
  "model": "auriko/deepseek-v3.2",
  "provider": {
    "auriko": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "Auriko",
      "env": ["AURIKO_API_KEY"],
      "options": {
        "baseURL": "https://api.auriko.ai/v1",
        "apiKey": "{env:AURIKO_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 Auriko dashboard. See routing options for details.

​
Uninstall

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

​
Troubleshoot

SymptomCauseFix
Error: API key is invalid.AURIKO_API_KEY not set or key is wrongRun echo $AURIKO_API_KEY. If empty, export it. If set, verify at https://api.auriko.ai/v1/me
Error: Model not found: auriko/<id>Model not in registry and no local definitionAdd a model definition to opencode.json (see “Add unregistered models”)
opencode: command not foundInstall script PATH not loaded in non-interactive shellRun export PATH="$HOME/.opencode/bin:$PATH" before invoking opencode
Connection errorbaseURL wrong or has trailing slashUse exactly https://api.auriko.ai/v1
Config not taking effectLocal config overriding globalCheck both ~/.config/opencode/opencode.json (global) and ./opencode.json (project root)
Empty response from opencode runNot inside a git repositoryRun from inside a git repo, or run git init first