Opencode Proxy

OpenCode-Proxy

A python proxy that lets you use OpenCode Go subscription with Claude Code.

Key Features

- Anthropic-compatible Proxy — Acts as a drop-in replacement for the Anthropic API. Claude Code sends requests to the proxy, which translates and forwards them to the OpenCode Go upstream, then converts the response back to Anthropic format seamlessly.

- Extended Thinking & Effort — Forwards thinking and budget_tokens parameters as-is to the upstream model. Also supports effort (low / medium / high) for models that use effort-based reasoning. Availability depends on the model.

- Image & Document — Passes image, PDF, DOCX, and XLSX content blocks through to the upstream model. Whether these are actually processed depends on model support.

- Web Search — Forwards web search tool calls to models that natively support it. Results are translated back to Anthropic's tool_result format for Claude Code compatibility.

Requirements

- Python 3.11+

Installation

Docker

Build and run with Docker Compose:

Or with plain Docker:

The container exposes both the API on 4000 and the dashboard on 8082, and persists the SQLite history database under logs/.

Configuration

Copy .env.example to .env and edit:

Edit values in .env:

Claude Code Configuration

To use this proxy with Claude Code, add these environment variables to your shell configuration:

Or add them to your .env file:

Note: The proxy server must be running (python opencode.py) before using Claude Code.

Running

Server will start:
- API: http://localhost:4000
- Web Dashboard: http://localhost:8082

Web Dashboard

The web interface has 2 tabs:

Token Stats
- Overview: Input, Output, Cache, Success, Failed, Avg Duration
- Charts: Token Distribution, Token % by Model, Requests % by Model
- Detailed table by…