OpenCode

Edgee’s OpenAI-compatible API works with OpenCode, letting you use OpenCode’s CLI agent while routing every request through Edgee for compression and observability.

Edgee CLI setup (recommended)

The fastest way to connect OpenCode to Edgee is the CLI. It authenticates, merges an Edgee provider into your OpenCode config (populated from the live Edgee model catalog), and starts OpenCode, no config file to edit by hand.

Install the Edgee CLI

macOS / Linux
Homebrew (macOS)
Windows (PowerShell)

curl -fsSL https://edgee.ai/install.sh | bash

brew install edgee-ai/tap/edgee

irm https://edgee.ai/install.ps1 | iex

Launch OpenCode through Edgee

edgee launch opencode

The CLI authenticates, adds the edgee provider, and starts OpenCode. Token compression is enabled automatically. Pick an Edgee model from OpenCode’s model picker.

After the session ends, the CLI prints a link to view token usage, compression savings, and cost breakdown in the Edgee Console.

Model context windows and pricing

Each model the CLI writes into the edgee provider carries its context window and its per-million-token rates, read from the Edgee model catalog:

{
  "models": {
    "anthropic/claude-sonnet-4-5": {
      "name": "anthropic/claude-sonnet-4-5",
      "limit": { "context": 1000000, "output": 32000 },
      "cost": { "input": 3, "output": 15, "cache_read": 0.3, "cache_write": 3.75 }
    }
  }
}

Those are Claude Sonnet 4.5’s catalog values: a 1M context window,

3 and

15 per million input and output tokens,

0.30 per million cached-read tokens,

3.75 per million cache-write tokens. Why it matters: OpenCode defaults both to 0 for a config-defined model. Without limit, its context gauge and auto-compaction have nothing to measure against; without cost, every session reports as free. Details on what the CLI emits:

limit.context comes from the catalog. When a model is served by several LLM providers with different windows, the value is the author’s own provider entry, or the smallest declared window when the author doesn’t serve it — overstating the window makes the agent compact too late and the request gets rejected.
limit.output is always 32000. OpenCode clamps every request’s max_tokens to its own 32k ceiling anyway, and its schema requires output whenever limit is set.
cost is in US dollars per million tokens, the same unit as OpenCode’s own catalog. A model that is genuinely free gets zeroed rates rather than an omitted cost.
Tiered long-context pricing is not emitted. The catalog carries a premium above 200k tokens for a few models (Claude Sonnet 4.5 goes to $6 /$ 22.50 there), and OpenCode’s config schema has a cost.context_over_200k slot, but its config merge drops that field — it survives only on the models.dev path. Declaring it would imply a tier that never takes effect.
Models the catalog has no entry for keep working; they just ship without limit or cost. The fetch is best-effort — if it fails, launch continues with no declared metadata.

Manual setup (advanced)

Prefer to configure OpenCode yourself? Open or create ~/.config/opencode/opencode.json and add the following configuration:

{
  "$schema": "https://opencode.ai/config.json",
  // Theme configuration
  "theme": "opencode",
  "autoupdate": true,
  "provider": {
    "edgee": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "edgee",
      "options": {
        "baseURL": "https://edgee.io/v1",
        "apiKey": "sk-edgee-..."
      },
      "models": {
        "anthropic/claude-sonnet-4-5": {
          "name": "claude sonnet 4.5 (edgee)",
          "limit": { "context": 1000000, "output": 32000 },
          "cost": { "input": 3, "output": 15, "cache_read": 0.3, "cache_write": 3.75 }
        },
        "openai/gpt-5.2": {
          "name": "gpt-5.2 (edgee)",
          "limit": { "context": 400000, "output": 32000 },
          "cost": { "input": 1.75, "output": 14, "cache_read": 0.175, "cache_write": 0 }
        }
      }
    }
  }
}

Make sure to replace "sk-edgee-..." with your actual Edgee API key. Model ids use the provider/model form the Edgee catalog exposes. limit and cost are optional, but a model without them gets no context gauge, no auto-compaction, and a $0 cost readout — the same reason edgee launch opencode declares them for you. Keep limit.output at 32000: OpenCode clamps max_tokens to that ceiling regardless.

Usage

Once configured, you can select the configured models directly within the OpenCode CLI interface. When you launch OpenCode, you will be able to choose from the models you defined in the models section of your configuration (e.g., “mistral small (edgee)”, “gpt-4 (edgee)”, etc.).

Authentication

Edgee uses standard Bearer token authentication. Your API key configured in opencode.json is automatically used to authenticate requests to the Edgee API.

Token compression is only available when routing through Edgee. You can use your own provider keys via BYOK — compression still applies as long as requests go through Edgee.

Benefits of Using OpenCode with Edgee

Unified Infrastructure

Access all LLM providers through Edgee while using OpenCode’s developer-friendly CLI.

Cost Control

Leverage Edgee’s cost tracking and routing while building applications with OpenCode.

Reliability

Combine OpenCode’s agent capabilities with Edgee’s automatic failover and load balancing.

Observability

Monitor your OpenCode sessions with Edgee’s built-in observability features.

Next Steps

Explore OpenCode’s documentation for more features
Set up observability to monitor your OpenCode sessions

Introduction

Quickstart

Features

Self-Hosting

Integrations

Edgee CLI setup (recommended)

Model context windows and pricing

Manual setup (advanced)

Usage

Authentication

Benefits of Using OpenCode with Edgee

Unified Infrastructure

Cost Control

Reliability

Observability

Next Steps

​Edgee CLI setup (recommended)

​Model context windows and pricing

​Manual setup (advanced)

​Usage

​Authentication

​Benefits of Using OpenCode with Edgee

Unified Infrastructure

Cost Control

Reliability

Observability

​Next Steps

Edgee CLI setup (recommended)

Model context windows and pricing

Manual setup (advanced)

Usage

Authentication

Benefits of Using OpenCode with Edgee

Next Steps