OpenCode guide: install it, connect a model and track what it uses

OpenCode 2.2.5, the MIT-licensed AI coding agent from Anomaly, shipped on October 30, 2026, and a new guide documents installing it via curl script, npm (@opencode/cli) or Homebrew, connecting models from more than 75 providers listed through Models.dev, and tracking token use with the free open-source desktop tool UsageAtlas. OpenCode's app is free, while OpenCode Go costs $10 a month ($40 for Go Plus, $20 per member for Go Teams) and OpenCode Models bills per token plus 4.6% and $0.31 on each credit purchase. UsageAtlas reads OpenCode's local database to report tokens, requests, models, sessions and estimated per-model cost without reading prompts or responses, though provider invoices remain the final word on spend.

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 https://opencode.ai/v2/docs and its GitHub repository https://github.com/anomalyco/opencode , 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 1. Open a project folder in a terminal and run opencode . 2. Type /connect , choose a provider, then sign in or paste an API key. 3. Type /models and select the model you want. 4. 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 https://opencode.ai/console/go and the OpenCode Models docs https://opencode.ai/v2/docs/console/models/ . 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 https://usageatlas.com/ 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 https://usageatlas.com/guides/topics/opencode cover setup on each system.