> getting started
From nothing installed to a working agent in your repo: install the opencode binary, authenticate a model provider, launch the TUI in your project, and let /init write an AGENTS.md so the agent understands the codebase. opencode is a single self-updating binary that talks to any of 75+ providers, so setup is mostly about which model you connect.
// getting started
5 commands// faq
Is opencode free?
The opencode client is open source and free. What you pay for is model usage: you bring your own provider key (Anthropic, OpenAI, OpenRouter, a local model, and so on) and are billed by that provider, or you use opencode Zen, opencode's own pay-as-you-go gateway. There is no separate opencode subscription for the CLI itself.
What is the difference between opencode and opencode-ai on npm?
The correct package is opencode-ai (npm i -g opencode-ai). The bare opencode name on npm is a different, unrelated project. If you installed opencode and the command is missing or wrong, uninstall it and install opencode-ai instead.
Who makes opencode and where is the source?
opencode is developed by the team behind SST, now under the anomalyco GitHub organization at github.com/anomalyco/opencode. The old github.com/sst/opencode URL redirects there. It is MIT-licensed and open to contributions.
Do I have to run /init?
No, but it helps. /init scans the repo and writes an AGENTS.md with build, test, and architecture notes that load into every session, which makes the agent faster and more accurate. You can also write AGENTS.md by hand or skip it and rely on an existing CLAUDE.md.