Skip to content

Use OpenCode with amazee.ai

OpenCode is an open-source terminal coding agent that supports multiple AI providers. Connect it to amazee.ai to use Claude and other models through your regional endpoint.

Prerequisites

Connect OpenCode to amazee.ai

Create or edit .opencode.json in your home directory or project root:

{
  "provider": "openai",
  "providers": {
    "openai": {
      "apiKey": "your-amazee-ai-api-key",
      "baseURL": "https://llm.[your-region].amazee.ai/v1"
    }
  },
  "model": "claude-sonnet-4-5"
}

Replace [your-region] with your region code (e.g. ch103, us103, de103).

Alternatively, use environment variables:

export OPENAI_API_KEY="your-amazee-ai-api-key"
export OPENAI_BASE_URL="https://llm.[your-region].amazee.ai/v1"

Start OpenCode

cd /path/to/your/project
opencode

Switching models

Change the model field in .opencode.json to any model from Available Models.

Troubleshooting

Auth errors : Check that your API key is correct in .opencode.json or the environment variable.

Model not found : Use the exact model ID from Available Models.

Config not loading : OpenCode checks $HOME/.opencode.json, $XDG_CONFIG_HOME/opencode/.opencode.json, and ./.opencode.json in the current directory.