OpenCode — 开源 AI 编程 CLI 工具详细介绍

一、产品概述

OpenCode 是一款开源的、基于终端（CLI）的 AI 编程协作工具，采用 MIT 开源协议，定位为"终端中的 AI 程序员助手"。它由社区驱动开发，于 2025 年 6 月在 GitHub 正式发布。

OpenCode 最核心的价值主张是模型中立（Model-Neutral）——支持 75+ AI 模型提供商，开发者可以用同一款工具自由切换 OpenAI、Anthropic Claude、Google Gemini、DeepSeek、Groq、Mistral、Ollama 本地模型等，完全避免供应商锁定。

截至 2026 年 6 月，OpenCode 在 GitHub 上获得约 17.2 万颗星，月活开发者达 650 万–800 万，是 GitHub 上最受欢迎的开源 AI 编码工具之一。

产品形态速览

维度	说明
产品形态	开源 CLI 编程工具（基于 Go + Bubble Tea TUI 框架）
所属层级	模型与编码执行层（工具链第 0 层）
核心角色	模型中立的终端编码 Agent
是否可独立运行	是，开箱即用
开源协议	MIT
代码仓库	github.com/kodrunhq/opencode
GitHub Stars	~172,000（2026 年 6 月）
月活用户	650 万–800 万开发者
通俗类比	开源版的 Claude Code，但能接任何模型，不受供应商锁定

---

二、发展历程

时间	里程碑
2025 年 2 月	创始团队受 Claude Code 启发，开始开发
2025 年 6 月	在 GitHub 正式发布
2025 年末	星标数突破 5 万（用时 5 个月）
2026 年 1 月	星标数超 8 万；Anthropic 封禁第三方调用 Claude Code → 成为 OpenCode 增长的关键转折点
2026 年 1 月 12 日	单日新增 2,087 颗星
2026 年 5 月	GitHub 星标约 15.7 万–17.2 万，月活开发者达 650 万–800 万
2026 年 6 月	小米基于 OpenCode 二次开发并开源 MiMo Code V0.1.0

---

三、安装与环境配置

3.1 系统要求

OpenCode 基于 Go 语言构建，支持多平台。无需 Node.js 运行时。

3.2 安装方式（多种选择）

# 方式一：Shell 安装脚本（推荐）
curl -fsSL https://opencode.ai/install | bash

# 方式二：Homebrew（macOS/Linux）
brew install anomalyco/tap/opencode

# 方式三：npm
npm install -g opencode-ai

# 方式四：Docker
docker pull opencodeai/opencode

# 方式五：Bun
bun install -g opencode-ai

# 方式六：Windows
scoop install opencode        # Scoop
choco install opencode         # Chocolatey

# 方式七：Arch Linux
pacman -S opencode

3.3 配置模型提供商

# 启动 OpenCode 后配置模型
opencode

# 在交互界面中选择模型提供商：
> /model
# 可选：openai / anthropic / google / deepseek / groq / mistral / ollama / ...

# 配置 API Key
export OPENAI_API_KEY=sk-xxx        # 如果用 OpenAI
export ANTHROPIC_API_KEY=sk-xxx     # 如果用 Anthropic
export GOOGLE_API_KEY=xxx           # 如果用 Gemini
# ... 按需配置

---

四、核心特性详解

4.1 模型无关（最核心差异）

支持 75+ AI 模型提供商，包括但不限于：

类别	提供商
国际大厂	OpenAI（GPT 系列）、Anthropic（Claude 系列）、Google（Gemini 系列）
开源模型	DeepSeek、Mistral、Llama（通过 Ollama 本地运行）
高性能推理	Groq、Together AI、Fireworks
中国模型	通义千问、文心一言、GLM 等

核心价值： 不绑定任何模型供应商。你可以上午用 Claude 写复杂逻辑，下午切到 DeepSeek 省钱做简单重构，任务级别自由切换。

4.2 Plan/Build 双模式

模式	行为	适用场景
Plan 模式	只分析不修改，先出方案	复杂需求先看方案再决定是否执行
Build 模式	执行修改，落地代码	方案确认后的执行阶段

这是 OpenCode 独有的设计——Plan 模式让开发者先审查 AI 的解决方案，确认无误后再切换到 Build 模式执行，降低"AI 乱改代码"的风险。

4.3 多 Agent 协作体系

OpenCode 内置多角色 Agent 系统：

Agent 角色	职责	权限
Orchestrator（调度者）	接收需求、分配任务、协调各 Agent	调度权限
Advisor（方案分析师）	分析需求、设计技术方案	只读
Researcher（研究员）	只读搜索代码库、文档、相关文件	只读
Reviewer（审查者）	代码审查、质量把关	只读
Implementer（执行者）	执行代码修改、文件操作	读写

4.4 LSP 集成（Language Server Protocol）

支持 30+ 语言服务器（LSP），提供：

• 代码智能诊断（错误、警告）
• 跳转到定义
• 查找引用
• 代码补全建议
• 悬停信息

这让 OpenCode 不仅能"写代码"，还能像 IDE 一样"理解代码"。

4.5 MCP 协议支持

通过 Model Context Protocol 连接数据库、API 等第三方服务，扩展 Agent 的能力边界。

4.6 Skills 技能系统

预置 200+ 开发技能模板，覆盖常见开发任务模式，支持自定义扩展。类似于 Superpowers 的技能插件概念，但内置于 OpenCode 生态中。

4.7 终端优先的 TUI 体验

基于 Go + Bubble Tea 框架构建的终端用户界面（TUI），提供：

• 漂亮的终端交互界面
• SSH 远程连接支持（可连到远程服务器开发）
• 轻量、快速、无 Electron 包袱

---

五、实操 Demo

场景：使用 OpenCode 开发用户分页接口

# 第一步：进入项目目录
cd ./my-project

# 第二步：启动 OpenCode
opencode

# 第三步：使用 Plan 模式先看方案
> /plan
> 我需要给 User 模块新增分页查询接口 GET /api/users，支持 pageNum 和 pageSize 参数。
  请先分析项目结构，给出实现方案，不要修改代码。

# OpenCode 输出方案：
# - 分析现有路由结构
# - 建议在 routes/user.js 中新增路由
# - 推荐使用 mongoose-paginate 或手动实现分页
# - 列出需要修改的文件清单

# 第四步：确认方案后，切到 Build 模式执行
> /build
> 按照刚才的方案执行，写完自动运行 npm test

使用不同模型

# 复杂逻辑用 Claude
> /model anthropic
> 重构 User 模块的权限校验逻辑

# 简单任务用 DeepSeek 省钱
> /model deepseek
> 给所有接口加统一的时间戳字段

---

六、适用场景

✅ 最适合的场景

场景	原因
多模型切换需求	不同任务用不同模型，追求性价比或能力匹配
避免供应商锁定	不想绑定单一模型厂商
开源合规要求	MIT 协议，可自由修改和二次开发（如小米 MiMo Code）
低成本开发	简单任务切便宜模型，复杂任务切强模型
SSH 远程开发	终端优先 + SSH 支持
本地隐私开发	通过 Ollama 接本地模型，数据不出本机

⚠️ 需注意的场景

场景	注意事项
Anthropic 重度用户	2026 年 1 月 Anthropic 封禁了第三方调用，需关注合规方式
追求极致简单	多模型配置比单一模型工具稍复杂
企业级治理	无内置的预算/权限/审计平台级功能

---

七、与竞品的对比

维度	OpenCode	Claude Code	OpenAI Codex
开源协议	MIT	专有	Apache 2.0
模型支持	75+ 提供商	仅 Anthropic Claude	仅 OpenAI GPT
GitHub Stars	~172,000	专有（无公开仓库）	~90,000
Plan/Build 模式	✅ 独有	❌	❌
LSP 集成	✅ 30+ 语言	❌	❌
安装方式	7 种以上	npm	npm
月活用户	650 万–800 万	~42 万（2026 年初）	500 万+
最适合	模型灵活、避免锁定	Anthropic 生态深度用户	OpenAI 生态深度用户

---

八、优势与局限总结

优势

优势	说明
模型中立	75+ 模型自由切换，不受任何供应商锁定
开源自由	MIT 协议，可二次开发（小米 MiMo Code 即基于此）
Plan/Build 分离	先审查方案再执行，降低 AI 盲写风险
多 Agent 协作	Orchestrator + Advisor + Researcher + Reviewer + Implementer
LSP 原生集成	代码智能诊断、跳转、引用查找
安装友好	7+ 种安装方式，覆盖所有主流平台
社区巨大	17 万+ Stars，650 万+ 月活，社区生态丰富

局限

局限	说明
Anthropic 合规风险	第三方调用 Claude 模型需关注 Anthropic 政策变化
多模型配置复杂	切换模型需分别配置 API Key
无平台级治理	缺少内置的预算/权限/审计等团队级功能
相对年轻	2025 年中才发布，企业级功能仍在完善

一句话总结

OpenCode 是模型中立的开源 Claude Code 替代方案。它的核心护城河不是技术更强，而是不绑定模型——开发者保留选择模型的自由，这是 Claude Code 和 Codex 都无法提供的。2026 年 1 月 Anthropic 封禁第三方调用后，OpenCode 成为大量开发者的首选替代。