OpenCode

OpenCode is an open-source, terminal-based coding agent with full support for custom OpenAI-compatible endpoints. Pointing it at OpenDunes takes one config change and gives you access to any model in the catalog, billed in Algerian Dinars.

Configure via environment variables#

OpenCode picks up the standard OpenAI base URL and key variables:

export OPENAI_BASE_URL="https://opendunes.com/v1"
export OPENAI_API_KEY="$OPENDUNES_API_KEY"

Add these to your shell profile for a permanent setup:

# ~/.zshrc or ~/.bashrc
export OPENAI_BASE_URL="https://opendunes.com/v1"
export OPENAI_API_KEY="sk-0a1b2c3d..."

Configure via opencode.json#

OpenCode also reads a opencode.json config file. Create or update it in your home directory or project root:

{
  "provider": {
    "openai": {
      "baseUrl": "https://opendunes.com/v1",
      "apiKey": "${OPENDUNES_API_KEY}"
    }
  },
  "model": "anthropic/claude-opus-4.8"
}

The ${OPENDUNES_API_KEY} syntax reads from your environment at runtime — your key never sits in plain text in the config file.

Choose a model#

Pass a model flag when invoking OpenCode, or set it in opencode.json. Use the provider/model slug from the OpenDunes catalog:

opencode --model anthropic/claude-opus-4.8 "Add input validation to the registration form"

Models with the tools capability work best with OpenCode's agentic loop (file reads, writes, shell execution). Check the models page for the capability filter.

Verify the setup#

opencode --model anthropic/claude-sonnet-5 "What files are in the current directory?"

OpenCode should list directory contents by invoking a shell tool, then return the summary. Check Dashboard → Analytics to confirm the request was routed through OpenDunes.

Set a DA budget#

OpenCode agentic sessions can generate many sequential requests. Create a dedicated key with a spend cap to keep costs predictable:

1. Go to Dashboard → Keys → New key.
2. Name it opencode, set a budget (e.g., 400 DA = 4,000,000 micro-DA).
3. Export that key as OPENAI_API_KEY.

When the budget is exhausted, OpenCode will receive a 402 (payment_required) and halt. Raise the cap or add DA to continue.

Troubleshooting#

Next steps#

• Models — find the right model for agentic coding tasks.
• API Keys — create and budget keys for long-running agents.
• Cursor — configure Cursor IDE through OpenDunes.