OpenCode vs Claude Code

Problem: OpenCode has 112,837 GitHub stars, a Tauri desktop app, 75+ provider support, and a hybrid routing strategy that cuts per-feature costs to $2.50. Claude Code ships from Anthropic, holds your whole repo in context, and runs quality gates before every commit. You need to know which one to reach for without reading 40 GitHub issues first.

Both tools drive Claude Sonnet 4.6 through a terminal. The similarity stops there.

What OpenCode Actually Is

OpenCode is a coding agent from the SST/Anomaly team. It is written in TypeScript (84% TS), MIT licensed, and carries 779 contributors. The project ships in three forms: a desktop app built with Tauri, a VS Code extension, and a terminal TUI.

The architecture is client/server. Sessions persist across restarts because the server keeps state even when the client disconnects. MCP tools load per-agent, not eagerly for every request, which keeps context tight.

The star count got there partly via a now-closed shortcut. OpenCode originally routed Claude Pro and Claude Max subscription tokens through the API. Anthropic blocked it on January 9, 2026, when a Claude Code update changed tool naming. OpenCode pulled Claude subscription support and cited "Anthropic legal requests." To fill the gap, the team launched two paid tiers:

Direct Anthropic API keys still work. The gateway tiers bundle the API cost into a subscription.

What Claude Code Actually Is

Claude Code is Anthropic's terminal-based coding agent. It reads your repo, maps file relationships and architecture, and holds up to 200K tokens of context so a full project can sit in memory during a session.

Permission controls are conservative by default. File reads need no approval. Writes and shell commands require approval unless you add an allow rule. The --dangerously-skip-permissions flag exists for isolated containers, not laptops.

CLAUDE.md feeds project context into every session. Hooks let you fire shell commands on lifecycle events. Extended thinking runs on Opus for deep planning work.

Multi-Model Routing: Where OpenCode Has a Real Edge

Claude Code runs Claude models only. OpenCode routes across 75+ providers. That matters because the models are not interchangeable in cost.

Netanel Eliav's hybrid routing strategy puts this gap to use. The approach assigns tasks by cost-to-quality ratio:

• Sonnet 4.6 for the planning pass (small context, high value)
• GLM-5 for build, backend, and frontend work
• MiniMax M2.5 for fast QA
• Opus for deep QA where quality is non-negotiable

Blended cost: $2.50 to $3.50 per feature. Sonnet-only: $9.15. The difference adds up across a full project.

The caveat is that Claude Code Max at $200/month delivers roughly $2,600 in API equivalent value (Anthropic subsidizes about 90%). If you are already on Max, the per-token math changes.

Benchmark: Same Model, Same Task

Builder.io ran both tools against the same task: fresh Docker container, identical prompt, Claude Sonnet 4.5 for both.

Claude Code finished about 45% faster. OpenCode passed more tests. Code quality was equivalent. Neither tool failed; they just made different trade-offs under time pressure.

This is a single benchmark on a single model version. It shows a real speed difference. It does not settle which tool is better for your specific workflow.

The Snapshot Bug (Still Open)

GitHub issue #3176 documents a storage problem that has not shipped a fix as of March 2026. OpenCode snapshots project state using git add . with no size check.

One user kicked off a session from their home directory. OpenCode staged and snapshotted 45GB across 54,000 files. Another user's ~/.local/share/opencode/snapshot/ grew to 250GB in two days. A third found 292,342 JSON files accumulating 2.2GB with no cleanup pass.

The workaround is adding "snapshot": false to opencode.json. That is not the default.

If you run OpenCode on a project, set this before the first session:

{
  "snapshot": false
}

Permission Models: Night and Day

This is the sharpest practical difference between the two tools.

Claude Code is conservative. Reads run freely. Writes and commands stop for approval. You can relax that with explicit allow rules per command, or go all the way with --dangerously-skip-permissions inside a container.

OpenCode's Build agent runs skip-permissions by default. On r/opencodeCLI, the original poster put it plainly: "It just implements the stuff without asking you anything, and can run any command on your system, which is extremely dangerous." The poster called that a feature. Whether you agree depends on how much you trust the agent's judgment on your machine.

MCP Context: Eager vs. Per-Agent

Claude Code loads MCP tool definitions eagerly. With many MCP servers active, that consumes roughly 134K tokens before your first prompt (about 25% of the 200K window gone before you type anything). Anthropic shipped MCP Tool Search to compress this down to around 5K tokens, but it is opt-in and not yet the default.

OpenCode declares tools per-agent. Each agent loads only the MCP tools its task needs. The context budget goes to your actual work, not to tool definitions that may not fire this session.

This matters most at scale. A single MCP server is fine either way. Five or more, and the difference in available context becomes real.

Feature Comparison

Neither tool wins every row. Claude Code owns the Anthropic-native features: CLAUDE.md, hooks, extended thinking, auto memory. OpenCode owns the open-source and multi-model side: MIT license, provider flexibility, local-first, per-agent tool loading.

Cadence and Stability Trade-off

HN comments have been blunt about OpenCode's release pace: "constantly releases at extremely high cadence, don't spend time to test or fix things." Resource usage also draws complaints. A TUI using 1GB of RAM regularly is unusual.

A separate issue: OpenCode attempts to pull config from a provider-based URL by default at startup. For teams on strict network policies, that is a flag to investigate before deployment.

Claude Code moves at Anthropic's pace. Slower cadence, fewer releases, more testing before anything ships.

Which One to Pick

Claude Code fits better when:

• You want deep repo context across large codebases
• Hooks, CLAUDE.md, and lifecycle automation matter to your workflow
• You are on Claude Pro or Max and the API subsidy makes the per-token math favorable
• Permission guardrails are a requirement, not a preference
• You need Jupyter, extended thinking, or auto memory

OpenCode fits better when:

• You want to route tasks across cheap models and control per-feature costs
• MIT licensing is a hard requirement for your organization
• Air-gapped or local-model deployment is on the table
• Per-agent MCP tool loading matters for your context budget
• Session persistence across disconnects is something you hit regularly

The hybrid that works: Start on Claude Code for four to eight weeks. Profile which task types you run most. If routine build and test tasks dominate, migrate those to OpenCode with GLM-5 or MiniMax. Keep planning and architecture passes on Sonnet. AiGentic Lab's advice for early-stage teams is direct: "Start with Claude Code API. Your constraint is capacity, not cost. Don't deploy OpenCode yet."

The snapshot bug and default skip-permissions behavior are real concerns. Both have workarounds. Neither is fatal. But neither is something to ignore on a production machine without reading the docs first.

Two tools, different defaults, different cost curves, and different trust models. The right one depends on what you are optimizing for this week.

Common Questions

Is OpenCode better than Claude Code?

Neither is universally better. Claude Code leads on repo context depth, hooks, CLAUDE.md project memory, and Anthropic-native features. OpenCode leads on multi-model routing, MIT licensing, session persistence, and per-feature cost control. A Builder.io benchmark on the same model showed Claude Code 45% faster; OpenCode passed more tests on that same run.

Is OpenCode free to use?

OpenCode is free to download and MIT licensed. Running it costs money because you supply your own API keys or pay for an OpenCode Black subscription ($20 to $200 per month). The Zen tier is pay-as-you-go against your own API key. There is no zero-cost usage tier.

Is OpenCode safe to use?

OpenCode's Build agent runs with skip-permissions enabled by default, meaning it writes files and executes shell commands without asking. Claude Code requires approval for writes and commands by default. OpenCode is manageable in a controlled environment, but requires deliberate configuration before running on a machine with sensitive files.

Does OpenCode work with Claude?

Yes. OpenCode accepts a direct Anthropic API key and routes to Claude Sonnet, Opus, or Haiku. What no longer works is routing Claude Pro or Max subscription tokens through OpenCode. Anthropic blocked that path in January 2026. You need a paid API key, not a Claude.ai subscription, to use Claude models in OpenCode.

What is the OpenCode snapshot bug?

GitHub issue #3176 documents OpenCode's snapshot system running git add . on the working directory with no size limit. Users reported snapshot folders growing to 250GB and beyond within days. The fix is adding "snapshot": false to your opencode.json before the first session. As of March 2026, this is not the default.