OpenCode is a free, open source AI coding agent that runs in your terminal, as a desktop app or in a browser, and it works with almost any model you connect to it. This guide walks through installing OpenCode, picking a model, what it costs and how to keep a record of the tokens it burns, with UsageAtlas as our pick for that last job.
Facts come from OpenCode's documentation and its GitHub repository, checked on November 3, 2026.
What OpenCode is
OpenCode is made by Anomaly and released under the MIT license. You open it inside a project, describe a change in plain language, and it reads files, edits them and runs commands with the permissions you allow. Two built-in agents handle most of the work. Build is the default and makes changes. Plan explores the code and writes up an approach without touching your project files. You can add your own agents as Markdown files in .opencode/agents/.
What sets it apart from vendor tools is model choice. The provider list comes from Models.dev and covers more than 75 providers, including Anthropic, OpenAI, Google and xAI. You can also run local models through Ollama, LM Studio or vLLM, or sign in with a ChatGPT Plus, ChatGPT Pro or GitHub Copilot plan you already pay for.
Install it
OpenCode 2 is the current line; version 2.2.5 shipped on October 30, 2026. Pick one method:
- Install script for macOS and Linux:
curl -fsSL https://opencode.ai/v2/install | bash - npm:
npm install -g @opencode/cli - Homebrew:
brew install anomalyco/tap/opencode-v2
Windows package managers are not supported for version 2, so on Windows you download the standalone binary or the desktop app from the docs. OpenCode 1 still gets updates, but both versions use the opencode command, so keep only one under that name.
Connect a model and start
- Open a project folder in a terminal and run
opencode. - Type
/connect, choose a provider, then sign in or paste an API key. - Type
/modelsand select the model you want. - Describe the task. For anything big, start in Plan, read what it proposes, then switch to Build.
For scripts and CI jobs, opencode run takes a prompt and prints the result without the full-screen interface.
What OpenCode costs
| Option | Price as of November 2026 |
|---|---|
| The OpenCode app | Free, MIT licensed |
| Free models | $0 for a limited time, with a daily request limit |
| OpenCode Models | Pay per token, plus 4.6% and $0.31 on each credit purchase |
| OpenCode Go | $10 a month; Go Plus $40; Go Teams $20 per member |
| Your own key or plan | Whatever that provider charges |
Prices are from the OpenCode Go page and the OpenCode Models docs.
Track OpenCode usage with UsageAtlas
One OpenCode setup can draw on several providers in the same week, so no single bill tells you what your coding actually used. OpenCode keeps those numbers in a local database on your computer, and UsageAtlas reads it and draws the picture.
UsageAtlas is a free, open source desktop tracker for Windows, macOS and Linux. Install it on the machine where OpenCode runs and you get:
- tokens, requests, models and sessions from OpenCode's local history
- an estimated cost per model, clearly marked as an estimate
- day-by-day history, with a filter for OpenCode alone or next to Claude Code, Codex and Cursor
Local tracking needs no account, and UsageAtlas does not read prompts or responses. A free account is optional and only backs up your history so you can restore it on another computer. For money, the invoices from each provider behind OpenCode remain the final word.
When something simpler is enough
If you only want a quick total, OpenCode 1 has an opencode stats command that prints token use and cost in the terminal, and a single provider's console shows spend for that one account. Choose UsageAtlas once you want history over weeks and every coding tool in one place. Its OpenCode guides cover setup on each system.