These docs track the main branch and may describe unreleased features. The stable documentation lives at docs.docker.com.

OpenCode Go

Use OpenCode Go models with docker-agent.

Overview

OpenCode Go is a low-cost subscription service ($5 first month, then $10/month) that provides reliable access to popular open-source coding models. It serves models through both OpenAI-compatible and Anthropic-compatible APIs from globally distributed endpoints.

docker-agent includes built-in support for OpenCode Go as an alias provider.

Setup

  1. Subscribe to OpenCode Go at opencode.ai/auth
  2. Copy your API key from the console

  3. Set the environment variable:

    export OPENCODE_API_KEY=your-api-key

Usage

Inline Syntax

The simplest way to use OpenCode Go:

agents:
  root:
    model: opencode-go/deepseek-v4-flash
    description: Assistant using OpenCode Go
    instruction: You are a helpful assistant.

Named Model

For more control over parameters:

models:
  my_model:
    provider: opencode-go
    model: deepseek-v4-pro
    temperature: 0.7
    max_tokens: 8192

agents:
  root:
    model: my_model
    description: Assistant using OpenCode Go
    instruction: You are a helpful assistant.

Available Models

You can retrieve the full, up-to-date model list at any time:

curl https://opencode.ai/zen/go/v1/models

OpenAI-Compatible

These models use the /v1/chat/completions endpoint and work directly with the opencode-go alias:

Model Description
deepseek-v4-flash Fast and cost-effective DeepSeek model
deepseek-v4-pro Most capable DeepSeek model
kimi-k2.7-code Kimi K2.7 optimized for code
kimi-k2.6 Kimi K2.6 model
kimi-k2.5 Kimi K2.5 model
glm-5.2 GLM 5.2 flagship model
glm-5.1 GLM 5.1 model
glm-5 GLM 5 model
mimo-v2.5 MiMo V2.5 efficient model
mimo-v2.5-pro MiMo V2.5 Pro model
mimo-v2-pro MiMo V2 Pro model
mimo-v2-omni MiMo V2 Omni model
hy3-preview HY3 preview model

Anthropic-Compatible

These models use the /v1/messages endpoint and require a custom provider definition:

Model Description
minimax-m3 MiniMax M3 model
minimax-m2.7 MiniMax M2.7 model
minimax-m2.5 MiniMax M2.5 model
qwen3.7-max Qwen 3.7 Max model
qwen3.7-plus Qwen 3.7 Plus model
qwen3.6-plus Qwen 3.6 Plus model
qwen3.5-plus Qwen 3.5 Plus model

To use an Anthropic-compatible model, define a custom provider:

providers:
  opengo-ant:
    provider: anthropic
    base_url: https://opencode.ai/zen/go
    token_key: OPENCODE_API_KEY

models:
  qwen:
    provider: opengo-ant
    model: qwen3.7-max

agents:
  root:
    model: qwen
    description: Assistant using Qwen through OpenCode Go
    instruction: You are a helpful assistant.

How It Works

OpenCode Go is implemented as a built-in alias in docker-agent:

This means OpenCode Go uses the same client as OpenAI, making it fully compatible with all OpenAI features supported by docker-agent.

For Anthropic-compatible models (MiniMax, Qwen), docker-agent uses a custom provider pointing to the Anthropic client at https://opencode.ai/zen/go with the same token.

Example: Code Assistant

agents:
  coder:
    model: opencode-go/deepseek-v4-flash
    description: Expert code assistant
    instruction: |
      You are an expert programmer using DeepSeek V4 Flash.
      Write clean, efficient, well-documented code.
      Explain your reasoning when helpful.
    toolsets:
      - type: filesystem
      - type: shell
      - type: think

Usage Limits

OpenCode Go subscriptions include the following limits:

Limits are defined as dollar values. More expensive models allow fewer requests per limit period. You can also add Zen balance to continue usage beyond the limits.

← Previous OpenAI