OpenCode（原 sst/opencode，现在 anomalyco/opencode）是 provider-agnostic、开源的终端编码 Agent。MIT 协议，内置 Anthropic、OpenAI、Google、Bedrock、Vertex、Groq 以及任意兼容 OpenAI 接口（Ollama、LM Studio、OpenRouter）的 provider。v1.17.20 自带打磨过的 TUI、多 session 支持，以及 LSP 感知的编辑流水线。本文讲安装、最小 provider 配置和第一天的用法。
Ubuntu 22.04 / 24.04 安装
OpenCode 提供了官方一行 bash 安装脚本：
curl -fsSL https://opencode.ai/install | bash脚本自动识别 OS/arch，把单个二进制下到 ~/.opencode/bin/，给 shell rc 加一行 PATH。source 一下或开新终端：
opencode --version
opencode --helpnpm 同版本同等：
npm i -g opencode-ai@latest也可以走 Linux Brew tap（brew install anomalyco/tap/opencode）。
选 provider
OpenCode 默认是 BYOK、多 provider。配置一个（或几个）：
opencode config set provider anthropic
opencode config set model claude-sonnet-4-2026
opencode config set provider openai
opencode config set base_url http://localhost:11434/v1
opencode config set model qwen3:30b-a3bAPI key 放 ~/.opencode/.env（安装脚本不读你 shell 的环境），或者每次单独 --api-key 传。多 provider 同时配也行，在 TUI 里 Ctrl+P 可以中途切换。
第一个 session
cd ~/work/my-app
opencode进 TUI：左边 session 侧栏，右边聊天。开口问，三条入门问题：
- 「走一遍这个仓库的结构。」——OpenCode 的 repo map 很快，大 monorepo 也不卡。
- 「把
<file>重构成errors.ts里那个新的错误处理模式。」——OpenCode 每个 edit 都跑 LSP 类型检查，类型破了立刻标红。 - 「给
<feature>加个集成测试。」——感受一下 OpenCode 的 spec-then-implement 循环。
TUI 几个键你肯定会用：Tab（接受建议）、Shift+Tab（循环 mode）、Ctrl+P（命令）、/（命令面板）、?（完整键位）。
跟 Claude Code 的差别
两个都是终端原生、用同样的 Anthropic 模型，但三个轴上有分叉：
- Provider-agnostic：Anthropic、OpenAI、Groq、Ollama、OpenRouter 代理之间切就是改一行 config，不是换一个产品。Anthropic 不是唯一选项——OpenCode 承认这件事。
- MIT 协议核心：可以 fork、可以审计、可以在严格防火墙后面跑。对合规要求高的团队是必备。
- TUI-first，没有 Electron overlay：比 Claude Code 的「终端 + Desktop」二分更轻。有
opencode desktop可选装但不是必需。
日常的好用模式
- 多 session：用侧栏保留并行 context——一个 active dev、一个 review、一个 research。
- 自定义命令：把 Markdown prompt 模板丢
~/.opencode/commands/，斜杠调用，跟 Claude Code 一样。 - 插件：
opencode plugin install <name>装进程内扩展（TypeScript 模块）。公共 registry 还小但在长。
什么时候选 OpenCode 而不是别的
- 想要 provider 灵活性（BYOK + 本地），又不想 fork。
- 团队接受 MIT 开源工具胜过闭源 Claude Code。
- 主要活在 TUI，不是 IDE。
如果你是 Claude Code 重度用户，喜欢 plan-first 默认，OpenCode 也支持 /plan，但周围的生态（skills、MCP 市场）还在追。
评论