
OpenCode
Made Crystal Clear
A Visual Beginner's Guide to AI Coding Agents, Open Models, and Local LLMs
Who this book is for
In plain words: OpenCode is a free, open source coding agent: it reads your project, edits files and runs commands for you, with the model you choose.
- Tech leads, founders and managers deciding on a coding agent for a team
- Developers switching from Claude Code, Copilot or Codex
- Beginners starting on free models or on models that run on their own computer
- Not for: Not for you if you are happy with one vendor's agent and its subscription. Try Claude Code Made Crystal Clear.
You want a coding agent you control: your choice of model, a bill you can predict, and no surprise edits to your project. Why use OpenCode instead of Claude Code or Codex, and what will it really cost? This visual beginner's guide answers both before you install anything. Inside, you will learn to tell the agent (OpenCode) from the model (the AI that writes) and the provider (who runs it and bills you), and switch models without changing your setup; pick one of six ways to pay for models, and see what each one costs and keeps of your code; write permission rules (what the agent may do, must ask about, or may never do) before it touches a real project; plan a change with an agent that cannot edit, then build it and undo a step you do not like; run open models on your own computer with Ollama, LM Studio or vLLM, and know where they fall short; and price a month for one person or a team, with budgets and policies in the Console. Fifteen chapters, 34 diagrams and 29 step by step recipes. Every idea has a diagram, every recipe is numbered with the result you should see, and every chapter ends with a Try it to check yourself. The words stay plain, and the real terms stay in. Whether you are a tech lead or manager deciding for a team, a founder, a developer switching from another agent, or a beginner on a small budget, one small app, Shelf, runs through every chapter, and you finish with rules, a model and a monthly budget you chose yourself.
- Pages
- 195
- Level
- Beginner to advanced
- Updated
- November 12, 2026
12 real pages. Click a page to enlarge it.
Is this you?
- You cannot see why anyone uses OpenCode instead of Claude Code or CodexChapter 1: What OpenCode Is: The Harness, Not the Model
- Zen, Go and the free models confuse you, and so does the billChapter 3: Where the Model Comes From, and What It Costs
- You cannot figure out permissions, and the agent edits files without askingChapter 4: Permissions Made Clear: What It Does Without Asking
- Your local model chats fine in Ollama but fails as an agentChapter 10: Local and Private: Ollama, LM Studio, vLLM
- You hit your usage limit within hours and do not know whyChapter 11: Long Sessions and Cost Control
- You must decide whether your team should use it, and what a month will costChapter 15: The Business Case, Your First 30 Days, and the Cheat Sheet
15 chapters · 34 diagrams · 29 recipes · 43 checklists · 126 glossary terms · 101 sources
Inside the book
- 01What OpenCode Is: The Harness, Not the Model
- 02Install and Your First Session
- 03Where the Model Comes From, and What It Costs
- 04Permissions Made Clear: What It Does Without Asking
- 05The Terminal Workbench: Sessions, Files, and Undo
- 06Plan, Then Build: Agents and Subagents
- 07Teach It Your Project: AGENTS.md, Commands, and Skills
- 08The Config File: Layers, Variables, and the First Five Settings
- 09Tools and MCP Servers: Connect Your Systems
- 10Local and Private: Ollama, LM Studio, vLLM
- 11Long Sessions and Cost Control
- 12Everywhere: Desktop, Browser, Phone, and Editor
- 13Automate: opencode run, CI, the SDK, and Plugins
- 14OpenCode for Teams: Workspaces, Budgets, and Policies
- 15The Business Case, Your First 30 Days, and the Cheat Sheet
You'll leave with
- Tell the harness from the model and the provider, and change models without changing your setup
- Pick one of six ways to pay for models and read what each costs and keeps of your code
- Write the rules that decide what the agent may do before it touches a real project
For teams
Put OpenCode on every desk at your company.
One licence, every book in the series, one link for everyone. From $250 a year.
Sources
Every source cited in OpenCode Made Crystal Clear. Each number matches the [n] marker next to that link in the book's "Go deeper" lists, so you can trace any claim back to its origin.
- [1]OpenCode home
- [2]OpenCode llms.txt site index
- [3]Product overview and FAQ
- [4]Terminal app page
- [5]Docs intro: install and connect
- [6]Troubleshooting
- [7]Migrate from V1
- [8]Changelog
Show all 101 sources
- [9]humans.txt (team and stack)
- [10]CLI intro
- [11]TUI
- [12]CLI commands
- [13]CLI settings (cli.json)
- [14]Web UI and pairing
- [15]Connect providers from the TUI and CLI
- [16]ACP (editors such as Zed)
- [17]Theme
- [18]Keybinds
- [19]Config
- [20]Config JSON Schema
- [21]Agents
- [22]Permissions
- [23]Policies
- [24]Instructions (AGENTS.md)
- [25]Skills
- [26]Commands
- [27]References
- [28]Tools
- [29]MCP servers
- [30]Snapshots (undo and redo)
- [31]Compaction
- [32]Warming
- [33]Formatters
- [34]Attachments
- [35]Web search
- [36]Plugins (load and control)
- [37]Models
- [38]Providers
- [39]models.dev catalog
- [40]Console intro
- [41]Console models and pricing
- [42]OpenCode Go
- [43]Console billing
- [44]Harnesses (Console from other agents)
- [45]Harness: Claude Code
- [46]Harness: Hermes
- [47]Workspaces
- [48]Members
- [49]Budgets
- [50]SSO
- [51]Directory sync (SCIM)
- [52]Console providers
- [53]Enterprise contact page
- [54]Desktop app
- [55]Mobile app
- [56]SDK page
- [57]Browse (agent browser extension)
- [58]Build intro
- [59]SDK docs
- [60]JavaScript client
- [61]Plugins overview (build)
- [62]GitHub repository anomalyco/opencode
- [63]GitHub releases
- [64]Press kit and facts
- [65]Brand and trademark rules
- [66]Terms of Use
- [67]Privacy Policy
- [68]Status page
- [69]Boot.dev course: AI Coding with OpenCode
- [70]TechFundingNews: the background story of OpenCode (Jan 13, 2026)
- [71]RuntimeWire: OpenCode Go passed 301,000 active subscribers (Aug 20, 2026)
- [72]VentureBeat: Anthropic cracks down on third party harnesses (Jan 9, 2026)
- [73]AlternativeTo: OpenCode 2.0 officially launches (Oct 16, 2026)
- [74]Infosecurity Magazine: OpenCode quietly patched critical RCE flaw (Oct 20, 2026)
- [75]Cloud Security Alliance: OpenCode Console provider key breach (Oct 20, 2026)
- [76]CVE-2026-22812 (Wiz vulnerability database)
- [77]AGENTS.md open format
- [78]Model Context Protocol
- [79]Agent Client Protocol
- [80]Morph: OpenCode alternatives tested
- [81]Composio: OpenCode vs Codex 2026
- [82]UsagePricing: OpenCode pricing blueprint (history)
- [83]r/opencode
- [84]r/opencodeCLI
- [85]OpenCode Discord
- [86]OpenCode on X
- [87]Hacker News: Opencode, AI coding agent built for the terminal (Jul 6, 2025)
- [88]OpenCode source: built in commands, packages/core/src/plugin/command.ts (v2.2.7)
- [89]OpenCode source: the /init prompt, packages/core/src/plugin/command/initialize.txt (v2.2.7)
- [90]Context7
- [91]Playwright MCP (microsoft/playwright-mcp README)
- [92]Bun: installation
- [93]Ollama
- [94]Ollama CLI reference
- [95]Ollama library: qwen3
- [96]LM Studio
- [97]OpenCode Mini
- [98]OpenCode: IDE extensions
- [99]Zed: external agents
- [100]Using secrets in GitHub Actions
- [101]GitHub Actions quickstart
Also in the series
41 more titles, one tool or topic each. Swipe or use the arrows.
New books, in your inbox
One short note when a new Made Crystal Clear guide ships.
No spam, unsubscribe anytime.










































