OpenCode

TL;DR

来源说明：本文基于 opencode.ai 官方文档、GitHub sst/opencode 仓库、社区评测与第三方对比整理。OpenCode 迭代极快（几乎每周发版），命令和模型支持列表请以最新官方文档为准。

2026-09-25 补记（v1.18.32，2026-09-21）：本卡正文所依据的版本快照已明显滞后，先补上这次值得注意的一版。

• 新增 Grok 4.7 与 DeepSeek V4.1-Flash——两个模型都在 9 月下旬才进 OpenCode 的模型列表，且 Grok 4.7 的接入早于 xAI 官方 API 文档补齐（其官方 model card 至今缺位），走 OpenCode / GitHub Copilot 这类订阅制通道反而是目前更省事的用法。
• Bedrock 图片附件收窄到 Claude / Nova / Llama 4 三类模型：此前对不支持图片的 Bedrock 模型也会尝试附图，导致请求失败；现在按模型能力做了白名单。用 Bedrock 做多模态的人请确认自己选的模型在名单内。
• 修复 Together AI 的 streaming usage 上报：走 Together 的用量统计此前不准，涉及成本核算与限流判断的团队建议升级后重新对账。

本条依据 GitHub Release 记录整理，AI 之家 未做一手安装实测；OpenCode 发版极频繁，具体版本号请以 sst/opencode Releases 为准。

核心能力

终端原生 TUI，多会话并行

OpenCode 不是又一个"AI IDE 插件"，而是独立的终端程序。装好后在任何项目根目录跑 opencode，就进入一个全屏的 TUI（终端用户界面）：左侧文件树、中间对话、右侧 diff 预览，所有操作用键盘完成。这套交互对 Vim / Neovim / tmux 用户极度友好——不抢编辑器焦点，开个分屏就能用。

cd your-project
opencode                       # 进入 TUI 交互模式
> 把这个 Express 项目迁移到 Fastify，跑通测试再提交

它会自动：扫描相关文件 → 给出迁移计划 → 等你确认 → 多文件改写 → 跑测试 → 生成 commit message。整个过程你可以在另一个窗口继续写代码，互不干扰。

TUI 之外，OpenCode 还支持 多会话并行——一个终端里同时挂多个独立 agent 会话，每个有自己的 context 和模型配置。典型用法：一个会话用 Claude Sonnet 跑主开发，另一个用 GPT-5 跑代码审查，第三个用 DeepSeek 跑文档生成，互不污染上下文。这是 Claude Code（单会话为主，子代理是隔离派发）之外另一种"并行"思路。

75+ 模型 BYOK，一个 Agent 全通吃

OpenCode 最硬的能力是 模型中立。它不绑死任何厂商，通过 provider 配置接入 75+ 模型，包括：

• Anthropic：Claude Opus 4 / Sonnet 4 / Haiku 4 全系
• OpenAI：GPT-5 / GPT-4.1 / o 系列推理模型
• Google：Gemini 2.5 Pro / Flash
• 国产：DeepSeek-V3、Qwen-Max、GLM-5、Kimi K2
• 本地：Ollama、LM Studio 任何 GGUF 模型
• 中转：OpenRouter / 火山引擎 / 硅基流动 一个 key 调全部

配置写在 opencode.json 里，按模型 / 按场景 / 按成本分配：

{
  "models": {
    "hard": { "provider": "anthropic", "model": "claude-sonnet-4" },
    "cheap": { "provider": "deepseek", "model": "deepseek-v3" },
    "local": { "provider": "ollama", "model": "qwen2.5-coder:32b" }
  }
}

之后在 TUI 里用 /model hard 一键切换。这种"模型即配置"的设计，让省钱和跑难活不再冲突——难的活上 Sonnet，简单的活（注释、文档、测试用例）下放给 DeepSeek，单月成本能压到订阅制的零头。

Agent 工具链：文件操作、终端执行、MCP

作为 Agent，OpenCode 内置了完整的工具链：读写文件、执行 shell 命令、跑测试、grep 搜索、git 操作。所有工具调用都在 TUI 里可见可审批，你可以随时打断、回滚。

它同样支持 MCP 协议——配置 .mcp.json 后就能在对话里调数据库、调浏览器、调任意 MCP server。这一点和 Claude Code 是同一套生态，迁移成本低。

开源 + 自托管

OpenCode 是 MIT 协议开源，TypeScript 全栈，可读可改可自托管。企业担心数据出墙的，可以自建一套：本地 Ollama 模型 + 本地 MCP server + 内网 git，全程不出公司网络。这是闭源的 Claude Code / Cursor 拿不到的优势。

社区活跃度是它的隐形护城河——GitHub 99.8K Star、issue 响应快、第三方插件（LSP 集成、自定义工具、模型 adapter）持续涌现。一个开源 Agent 能跑到这个量级，意味着生态可持续。

使用体验

上手 5 分钟

# macOS / Linux
curl -fsSL https://opencode.ai/install.sh | bash

# Windows PowerShell
irm https://opencode.ai/install.ps1 | iex

# 或 npm 全局安装（需 Node 18+）
npm install -g opencode

# 验证
opencode --version

# 配置 API key（任选其一）
export ANTHROPIC_API_KEY=sk-ant-...
export OPENAI_API_KEY=sk-...
export OPENROUTER_API_KEY=sk-or-...      # 一个 key 调 75+ 模型

# 进项目启动
cd your-project
opencode                          # 进入 TUI

日常体感

实际用下来，OpenCode 的 TUI 体验是开源侧最接近 Claude Code 的。键盘流操作丝滑，diff 实时预览，会话切换比 Claude Code 的 /resume 更直观（直接在侧栏点）。多模型切换是杀手锏：跑一个大 refactor 前先 /model hard 上 Sonnet，跑完切 /model cheap 让 DeepSeek 补文档，成本可控。

但 稳定性是短板。BYOK 模式下，体验强依赖你接的 API 质量：第三方中转偶尔限流、国产模型长任务容易断、本地模型质量参差。同样一个任务，Claude Code 用官方 API 能稳跑完，OpenCode 接中转可能中途报错重来。社区也承认这一点，正在做重试、断点续跑等加固。

配置门槛

第一次配 opencode.json 会有学习成本——provider 字段、base_url、模型映射、工具白名单都要手填。社区有模板可抄，但想用好（比如按场景自动路由模型）还是得读文档。相比之下 Claude Code 的 claude 一键启动确实更省心。

价格与运行成本

OpenCode 本身 完全免费——开源、无订阅、无增值版。你只为你调用的模型 API 付费（BYOK）。这意味着成本完全可控：

对比 Claude Code Max $200/月：用 OpenCode + DeepSeek，同样强度的编码量，单月可能只要 ¥50。这就是开源 + BYOK 的红利——你为用量付费，不为订阅定额买单。

但要注意 隐性成本：多模型配置的时间、调试中转稳定性的精力、偶尔重跑任务的 token 浪费。对这些"折腾税"敏感的，订阅制反而更省心。

适用场景

• 预算敏感的个人开发者：想用 Agent 但不想每月 $20+，OpenCode + DeepSeek 是最经济解
• 模型自由爱好者：想同时对比 Claude / GPT / DeepSeek / 本地模型在同一个 Agent 里的表现
• Vim / Neovim / tmux 重度用户：终端原生 TUI，不破坏既有工作流
• 需要自托管 / 隐私的团队：MIT 开源 + 本地模型，数据不出内网
• Claude Code 想找平替：交互逻辑接近，迁移成本低，省下订阅费

不适用场景

• 零配置开箱即用：多模型路由要折腾 opencode.json，新手劝退
• 企业级稳定性 SLA：开源项目无承诺，中转 / 国产模型偶发抖动
• IDE 内 inline 补全：OpenCode 是 Agent 不是补全器，要 Tab 补全去 Cursor / Copilot
• 纯 Windows 原生：TUI 在 Windows Terminal 可用，但部分功能建议 WSL
• 不碰终端的用户：这是 CLI 工具，全程命令行交互

与同类怎么选

选 OpenCode 如果你：

• 想用 Claude Code 的体验但不想付订阅
• 需要在多个模型间灵活切换（省钱 / 跑难活 / 隐私）
• 是 Vim / 终端重度用户，不想装 IDE
• 团队要自托管，数据不出墙

别选 OpenCode 如果你：

• 要开箱即用、零配置（去 Claude Code / Cursor）
• 要 IDE 内 inline 补全（去 Cursor / Copilot）
• 企业要求稳定 SLA（开源 + BYOK 抖动难避免）

FAQ

Q：OpenCode 真的完全免费吗？ A：工具本身免费开源（MIT）。但调模型 API 要花钱——除非你只用本地 Ollama 模型。所谓"免费"指的是不收订阅费，BYOK 模式下你为 token 买单。

Q：和 Claude Code 比，差在哪？ A：长任务稳定性、上下文管理（Claude Code 的 /compact 更成熟）、官方模型深度调优。OpenCode 胜在模型自由和免费。简单说：要稳选 Claude Code，要省和自由选 OpenCode。

Q：国内怎么用最省心？ A：用 OpenRouter 一个 key 调全部模型（支持支付宝），或直接接 DeepSeek / Qwen 国产模型。网络压力小，成本最低。

Q：能接本地模型吗？ A：能。Ollama / LM Studio 跑 GGUF 模型，OpenCode 通过 OpenAI 兼容接口接入。完全离线可用，适合隐私场景。

Q：OpenCode 和 Aider 都是开源 CLI，区别？ A：Aider 更老牌、更轻量，专注"每改即 commit"的 git 流；OpenCode 更现代，TUI 体验和多会话并行更强，模型生态更广。要轻量选 Aider，要体验选 OpenCode。

Q：会取代 Claude Code 吗？ A：对预算敏感、爱折腾的用户，是的。对要稳定 + 长任务 + 不差钱的，Claude Code 仍是最优解。两者更像互补——OpenCode 日常省钱，Claude Code 跑关键大活。

相关阅读

• 同类对比：Claude Code / Codex CLI / Aider / Gemini CLI
• 概念：AI Agent / MCP / BYOK / Context Engineering
• 模型：Claude Sonnet 4 / GPT-5 / DeepSeek-V3 / Qwen-Max
• 进阶：Vibe Coding / Prompt Engineering

Long-tail quick picks

长尾检索速查：下面三项对应「OpenCode 开源版 / 免费版 / 国内可用」等搜索意图，方便直接跳转。

Open-source alternatives

• 是否开源：是（支持自托管）
• 想找开源替代？看这几个：Trae · Cline · Aider

Free tier

• 是否有免费档：是
• 价格概要：完全免费（BYOK）
• 预算敏感用户可先用免费档；进阶需求参考 通义灵码 / CodeGeex（国内免费额度更友好）。

China availability

• 是否国内可用：否
• 中文友好度评分：3 / 5
• 国内访问需稳定代理；高频切 IP 可能触发风控。中文场景可考虑 Trae / 通义灵码 / Comate。

相关替代品：

• claude-code
• codex
• aider

来源

• 官网：https://opencode.ai
• 官方文档：https://opencode.ai/docs
• GitHub：https://github.com/sst/opencode
• 模型支持：https://opencode.ai/docs/models
• 对比文档：https://opencode.ai/docs/comparisons/claude-code

本卡片由 AI 之家 编辑部根据官方公开资料与第三方评测整理。所有事实点均标注来源；如发现价格 / 命令 / 功能与最新官方信息不一致，请通过 反馈邮箱 反馈。