深度解析 · 2026
opencode
由 Anomaly / SST 团队构建的开源 AI 编程助手。Provider 无关、插件驱动、支持双 Agent 模式，是终端开发者的新一代智能编码工具。
TypeScript + Bun
运行时技术栈
53+ Providers
LLM 提供商支持
Plan + Build
双 Agent 架构
SKILL.md
技能插件格式
📖 什么是 opencode？
opencode 是 SST 团队（以 Anomaly 品牌发布）打造的终端原生 AI 编码助手。它以 TypeScript + Bun 为基础，在本地终端提供交互式 TUI 界面，同时支持单命令非交互执行，适合 CI/CD 集成。
与 Cursor、Copilot 等 IDE 插件不同，opencode 是 完全独立的 CLI 工具，不依赖特定编辑器。它通过 SKILL.md 插件系统实现上下文注入与能力扩展，通过 Plan + Build 双 Agent 模式将代码分析与代码修改解耦，大幅提升复杂任务的可靠性。
opencode 对标 Claude Code 但更加开放 —— 支持任意 OpenAI 兼容 endpoint，支持 Ollama 本地模型，支持通过 experimental.chat.system.transform 钩子动态修改 system prompt。
🏗️ 五层架构总览
opencode 的整体架构分为五个清晰的层次，从用户入口到技能扩展，每层职责单一、边界清晰。
L1
用户触达面
↓
L2
双智能体编排
↓
L3
LLM 适配抽象
↓
L4
能力执行引擎
↓
L5
可扩展行为注入
📚 文档导航
搭建 · 部署 · 使用
安装方式、API Key 配置、config.json 详解、TUI 与非交互模式、插件安装、slash 命令速查。
架构 · 模块 · 文件结构
Monorepo 包结构、五层分层图、Plan vs Build 对比、Provider 矩阵、SKILL.md 格式、命名约定。
运行时 · 状态机 · 流程
Agent 循环状态机、System Prompt 构建管道、Skill 注入流程、Context 压缩机制、Session 共享架构。
🔌 支持的 LLM Provider
opencode 通过统一的 Provider 适配层，支持市面上主流及长尾的 LLM 服务。凡是实现了 OpenAI API 规范的自托管端点均可接入。
Anthropic Claude
OpenAI GPT-4o
Google Gemini
Ollama (本地)
GitHub Copilot
Azure OpenAI
LM Studio
Mistral
Groq
Together AI
Fireworks
Perplexity
任意 OAI 兼容端点
✨ 核心特性
-
Provider 无关 — 通过统一接口适配 53+ LLM 提供商，一行配置即可切换，不绑定任何单一厂商。
-
Plan + Build 双 Agent — Plan Agent 负责只读分析和方案制定，Build Agent 负责执行写入；解耦分析与修改，降低副作用风险。
-
SKILL.md 插件系统 — 以 Markdown frontmatter 声明技能，opencode 在会话启动时自动语义匹配并注入相关技能上下文，无需手动 @ 触发。
-
Terminal TUI — 基于 Ink（React for CLI）构建的全功能终端 UI，支持 /compact、/share、/model 等交互命令。
-
Session 共享 — opencode --share 将当前 session 发布至 opencode.ai console，支持团队实时查看 AI 操作过程。
-
System Prompt 钩子 — experimental.chat.system.transform 允许用 JS 表达式在运行时动态修改 system prompt，实现深度定制。
🤖 Plan Agent vs Build Agent
Plan Agent
- ✓ 只读工具访问（read_file, grep, search）
- ✓ 深度理解代码库意图
- ✓ 生成结构化实施方案
- ✓ 识别潜在影响范围与风险
- ✗ 不执行文件写入
- ✗ 不执行 shell 命令
Build Agent
- ✓ 全工具访问权限
- ✓ 文件读写、创建、删除
- ✓ Shell 命令执行
- ✓ 按 Plan Agent 输出执行
- ✓ LSP 集成（类型检查）
- ✓ 浏览器工具访问
⚡ 快速开始
最快 60 秒完成安装并开始使用：
# 1. 安装 opencode curl -fsSL https://opencode.ai/install | bash # 2. 配置 API Key export ANTHROPIC_API_KEY=sk-ant-... # 3. 进入项目目录，启动 TUI cd your-project opencode # 4. 或者单命令非交互执行 opencode -p "解释这个项目的主要架构"
详细安装与配置指南 → 搭建 · 部署 · 使用
🔧 技术栈
| 层次 | 技术 | 用途 | 备注 |
|---|---|---|---|
| 运行时 | Bun ≥1.0 | TypeScript 执行 + 包管理 | 替代 Node.js + npm |
| 语言 | TypeScript | 全栈类型安全 | 严格模式 |
| TUI | Ink (React for CLI) | 终端 UI 渲染 | React 组件树 |
| Desktop | Tauri (Beta) | 桌面应用壳 | Rust + WebView |
| Web Console | SST / Serverless | Session 共享后台 | opencode.ai |
| Monorepo | Bun Workspaces | 多包管理 | packages/ 目录 |
opencode · Anomaly / SST · github.com/sst/opencode
深度文档 · 2026-05-22