Cover of OpenCode Made Crystal Clear
← Back to the series

OpenCode

Made Crystal Clear

By Christophe Paka · Updated November 12, 2026

A Visual Beginner's Guide to AI Coding Agents, Open Models, and Local LLMs

Soon on Amazon
Give feedback

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.

Page 8: OpenCode in one picture
Page 16: every client talks to the same background server, so any client can pick up any session
Page 20: your first session, from empty folder to first commit
Page 31: the provider is everything before the first slash, so the first word of a model ID tells you who bills the...
Page 53: the same command, two paths
Page 67: plan, then Build
Page 89: which config file wins
Page 92: the committed file holds only the variable's name
Page 111: where your prompt goes
Page 133: every window talks to one server
Page 137: same Wi Fi keeps the server on your network, so use it at home, never on shared Wi Fi
Page 155: one $3 request against three budgets

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

  1. 01What OpenCode Is: The Harness, Not the Model
  2. 02Install and Your First Session
  3. 03Where the Model Comes From, and What It Costs
  4. 04Permissions Made Clear: What It Does Without Asking
  5. 05The Terminal Workbench: Sessions, Files, and Undo
  6. 06Plan, Then Build: Agents and Subagents
  7. 07Teach It Your Project: AGENTS.md, Commands, and Skills
  8. 08The Config File: Layers, Variables, and the First Five Settings
  9. 09Tools and MCP Servers: Connect Your Systems
  10. 10Local and Private: Ollama, LM Studio, vLLM
  11. 11Long Sessions and Cost Control
  12. 12Everywhere: Desktop, Browser, Phone, and Editor
  13. 13Automate: opencode run, CI, the SDK, and Plugins
  14. 14OpenCode for Teams: Workspaces, Budgets, and Policies
  15. 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
Christophe Paka, author of OpenCode Made Crystal Clear

About the author

Christophe Paka writes every book on the shelf. He spent years in technical support at Salesforce and Microsoft, where the job was to make complex systems clear to customers who needed them working the same day. He has since built and run software as a founder and lead developer, worked as a Salesforce consultant, and grown a YouTube channel on tech careers past one million views.

This book was last updated on November 12, 2026.

Connect on LinkedIn →

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.

See the team licences

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. [1]OpenCode home
  2. [2]OpenCode llms.txt site index
  3. [3]Product overview and FAQ
  4. [4]Terminal app page
  5. [5]Docs intro: install and connect
  6. [6]Troubleshooting
  7. [7]Migrate from V1
  8. [8]Changelog
Show all 101 sources
  1. [9]humans.txt (team and stack)
  2. [10]CLI intro
  3. [11]TUI
  4. [12]CLI commands
  5. [13]CLI settings (cli.json)
  6. [14]Web UI and pairing
  7. [15]Connect providers from the TUI and CLI
  8. [16]ACP (editors such as Zed)
  9. [17]Theme
  10. [18]Keybinds
  11. [19]Config
  12. [20]Config JSON Schema
  13. [21]Agents
  14. [22]Permissions
  15. [23]Policies
  16. [24]Instructions (AGENTS.md)
  17. [25]Skills
  18. [26]Commands
  19. [27]References
  20. [28]Tools
  21. [29]MCP servers
  22. [30]Snapshots (undo and redo)
  23. [31]Compaction
  24. [32]Warming
  25. [33]Formatters
  26. [34]Attachments
  27. [35]Web search
  28. [36]Plugins (load and control)
  29. [37]Models
  30. [38]Providers
  31. [39]models.dev catalog
  32. [40]Console intro
  33. [41]Console models and pricing
  34. [42]OpenCode Go
  35. [43]Console billing
  36. [44]Harnesses (Console from other agents)
  37. [45]Harness: Claude Code
  38. [46]Harness: Hermes
  39. [47]Workspaces
  40. [48]Members
  41. [49]Budgets
  42. [50]SSO
  43. [51]Directory sync (SCIM)
  44. [52]Console providers
  45. [53]Enterprise contact page
  46. [54]Desktop app
  47. [55]Mobile app
  48. [56]SDK page
  49. [57]Browse (agent browser extension)
  50. [58]Build intro
  51. [59]SDK docs
  52. [60]JavaScript client
  53. [61]Plugins overview (build)
  54. [62]GitHub repository anomalyco/opencode
  55. [63]GitHub releases
  56. [64]Press kit and facts
  57. [65]Brand and trademark rules
  58. [66]Terms of Use
  59. [67]Privacy Policy
  60. [68]Status page
  61. [69]Boot.dev course: AI Coding with OpenCode
  62. [70]TechFundingNews: the background story of OpenCode (Jan 13, 2026)
  63. [71]RuntimeWire: OpenCode Go passed 301,000 active subscribers (Aug 20, 2026)
  64. [72]VentureBeat: Anthropic cracks down on third party harnesses (Jan 9, 2026)
  65. [73]AlternativeTo: OpenCode 2.0 officially launches (Oct 16, 2026)
  66. [74]Infosecurity Magazine: OpenCode quietly patched critical RCE flaw (Oct 20, 2026)
  67. [75]Cloud Security Alliance: OpenCode Console provider key breach (Oct 20, 2026)
  68. [76]CVE-2026-22812 (Wiz vulnerability database)
  69. [77]AGENTS.md open format
  70. [78]Model Context Protocol
  71. [79]Agent Client Protocol
  72. [80]Morph: OpenCode alternatives tested
  73. [81]Composio: OpenCode vs Codex 2026
  74. [82]UsagePricing: OpenCode pricing blueprint (history)
  75. [83]r/opencode
  76. [84]r/opencodeCLI
  77. [85]OpenCode Discord
  78. [86]OpenCode on X
  79. [87]Hacker News: Opencode, AI coding agent built for the terminal (Jul 6, 2025)
  80. [88]OpenCode source: built in commands, packages/core/src/plugin/command.ts (v2.2.7)
  81. [89]OpenCode source: the /init prompt, packages/core/src/plugin/command/initialize.txt (v2.2.7)
  82. [90]Context7
  83. [91]Playwright MCP (microsoft/playwright-mcp README)
  84. [92]Bun: installation
  85. [93]Ollama
  86. [94]Ollama CLI reference
  87. [95]Ollama library: qwen3
  88. [96]LM Studio
  89. [97]OpenCode Mini
  90. [98]OpenCode: IDE extensions
  91. [99]Zed: external agents
  92. [100]Using secrets in GitHub Actions
  93. [101]GitHub Actions quickstart

New books, in your inbox

One short note when a new Made Crystal Clear guide ships.
No spam, unsubscribe anytime.