Share feedback
Answers are generated based on the documentation.

OpenCode Go

Table of contents

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:

ModelDescription
deepseek-v4-flashFast and cost-effective DeepSeek model
deepseek-v4-proMost capable DeepSeek model
kimi-k2.7-codeKimi K2.7 optimized for code
kimi-k2.6Kimi K2.6 model
kimi-k2.5Kimi K2.5 model
glm-5.2GLM 5.2 flagship model
glm-5.1GLM 5.1 model
glm-5GLM 5 model
mimo-v2.5MiMo V2.5 efficient model
mimo-v2.5-proMiMo V2.5 Pro model
mimo-v2-proMiMo V2 Pro model
mimo-v2-omniMiMo V2 Omni model
hy3-previewHY3 preview model

Anthropic-Compatible

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

ModelDescription
minimax-m3MiniMax M3 model
minimax-m2.7MiniMax M2.7 model
minimax-m2.5MiniMax M2.5 model
qwen3.7-maxQwen 3.7 Max model
qwen3.7-plusQwen 3.7 Plus model
qwen3.6-plusQwen 3.6 Plus model
qwen3.5-plusQwen 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:

  • API Type: OpenAI-compatible (openai_chatcompletions)
  • Base URL: https://opencode.ai/zen/go/v1
  • Token Variable: OPENCODE_API_KEY

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:

  • 5-hour rolling limit — $12 of usage
  • Weekly limit — $30 of usage
  • Monthly limit — $60 of usage

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.