| name | intro |
| description | Introduction to OpenCode - overview of what OpenCode is and how to get started |
| author | Tim Sonner |
| license | MIT |
| compatibility | opencode |
| metadata | {"audience":"developers","workflow":"introduction","language":"markdown"} |
OpenCode Introduction
Get started with OpenCode.
OpenCode is an open source AI coding agent. It’s available as a terminal-based interface, desktop app, or IDE extension.

Let’s get started.
To use OpenCode in your terminal, you’ll need:
-
A modern terminal emulator like:
-
API keys for the LLM providers you want to use.
The easiest way to install OpenCode is through the install script.
Terminal window
curl -fsSL https://opencode.ai/install | bash
You can also install it with the following commands:
-
Using Node.js
Terminal window
npm install -g opencode-ai
Terminal window
bun install -g opencode-ai
Terminal window
pnpm install -g opencode-ai
Terminal window
yarn global add opencode-ai
-
Using Homebrew on macOS and Linux
Terminal window
brew install anomalyco/tap/opencode
We recommend using the OpenCode tap for the most up to date releases. The official brew install opencode formula is maintained by the Homebrew team and is updated less frequently.
-
Installing on Arch Linux
Terminal window
sudo pacman -S opencode # Arch Linux (Stable)paru -S opencode-bin # Arch Linux (Latest from AUR)
Recommended: Use WSL
For the best experience on Windows, we recommend using Windows Subsystem for Linux (WSL). It provides better performance and full compatibility with OpenCode’s features.
-
Using Chocolatey
Terminal window
choco install opencode
-
Using Scoop
Terminal window
scoop install opencode
-
Using NPM
Terminal window
npm install -g opencode-ai
-
Using Mise
Terminal window
mise use -g github:anomalyco/opencode
-
Using Docker
Terminal window
docker run -it --rm ghcr.io/anomalyco/opencode
Support for installing OpenCode on Windows using Bun is currently in progress.
You can also grab the binary from the Releases.