The Unofficial OpenCode Guide

Master your local coding agent.

OpenCode is the offline-first, plugin-driven alternative to cloud coding assistants. Learn how to run it with Ollama, connect via MCP, and integrate with Neovim.

CLI First

Built for the terminal. No Electron bloat. Runs purely in your shell with full access to your local environment.

Local Models

First-class support for Ollama. Run Llama 3 or DeepSeek Coder locally without sending code to the cloud.

MCP Ready

Full implementation of the Model Context Protocol. Connect databases, APIs, and custom tools easily.

Why OpenCode?

Designed for local-first workflows, offering a different approach compared to hosted assistants like Claude Code.

Feature
OpenCode
Claude Code
Execution Environment
Local (Your Machine)
Cloud / SaaS
Model Support
Any (Ollama, OpenAI, Anthropic, etc)
Anthropic Only
Plugin System
Open Ecosystem (npm)
Controlled
Cost
Free (Open Source)
Usage-based Pricing

Ready to build your own agent?

Dive into advanced topics like setting up MCP servers or integrating directly into Neovim for a seamless workflow.