OpenCode 介绍与安装指南：GitHub 最热门的开源 AI 编程工具

发布于 2026/7/25 · 1 阅读
OpenCodeAI编程开源工具终端应用编程助手插件推荐LLM开发效率Anomaly安装指南
OpenCode 是由 Anomaly 团队打造的开源 AI 编程工具，GitHub 182K+ Star。本文涵盖核心特性、v1.18 系列亮点、全平台安装方式、使用入门和常用插件推荐。

文章目录

封面.png

0. 前言

如果你关注 AI 编程工具领域，那么 2025-2026 年间最引人瞩目的开源项目之一非 OpenCode 莫属。这款由 Anomaly 团队（前身为 SST/Serverless Stack 团队）打造的终端原生 AI 编程工具（AI Coding Agent），在上线仅一年左右的时间里便斩获了超过 182,000 颗 GitHub Star，月活跃开发者突破 800 万，成为 GitHub 上 Star 数最多的 AI 编程 Agent 项目。

OpenCode 的核心定位是"开源的 AI 编程 Agent"——它能读懂你的代码仓库、执行 shell 命令、编辑文件，并且支持接入 75+ 大语言模型（LLM）供应商。无论是 Anthropic Claude、OpenAI GPT、Google Gemini、Groq，还是通过 Ollama 运行的本地模型，OpenCode 都能无缝对接。

本文整理 OpenCode 的核心特性、v1.18 系列版本亮点、安装方式汇总、使用入门以及常用插件推荐，供读者参考。

许可证：MIT

1. 发展历程与关键数据

OpenCode 于 2025 年 6 月 19 日 正式发布，当天即登上 Hacker News 榜首。它最大的特点之一是"零门槛上手"——不需要注册账户、不需要填写邮箱、不需要绑定信用卡。

随着时间推移，OpenCode 的增长曲线愈发陡峭：

  • 2025 年底至 2026 年初：因部分商业编程工具的限制策略引发开发者不满，OpenCode 在两周内暴涨 18,000 Star。
  • 2026 年 4 月：147,000+ Star，月活开发者 650 万。
  • 2026 年 7 月：182,000+ Star，月活开发者约 800 万，累计提交超过 15,000 次。

值得关注的一个事件是 2026 年 1 月的 Anthropic OAuth 封锁——Anthropic 部署了服务端校验，拒绝来自第三方工具（包括 OpenCode）的 OAuth 令牌。OpenCode 于 2 月移除了所有 Claude OAuth 相关代码，并随后推出了商业替代方案（Zen、Go、Black），完成了从"依赖第三方"到"独立生态"的转型。

在行业层面，2026 年上半年也出现了明显的整合趋势：Gemini CLI 于 6 月退役，转向闭源的 Antigravity CLI；Roo Code 于 5 月关闭；Aider 的开发节奏明显放缓。这些变化都在客观上推动了更多开发者涌向 OpenCode。

2. 核心特色

2.1 多形态使用

OpenCode 提供了多种使用形态，适配不同场景：

形态 说明
终端 TUI（opencode） 核心体验，终端交互式界面，适合偏好命令行的开发者
无头 CLI（opencode run） 适用于脚本化、CI/CD 流水线等自动化场景
服务/API（opencode serve / opencode web） 以服务器模式运行，提供 HTTP API 和 Web 界面
桌面应用（beta） 图形化桌面客户端，v1.18 已默认启用 Desktop v2 布局
IDE 扩展 与 VS Code 等编辑器的集成方案

2.2 双 Agent 架构

OpenCode 内置两种 Agent，可按 Tab 键快速切换：

  • Build（构建模式）：默认模式，拥有完整的文件编辑和命令执行权限，适合日常开发工作。
  • Plan（规划模式）：只读模式，默认拒绝文件编辑，运行 bash 命令前需要确认。适合探索陌生代码库或规划改动方案。

此外还包含一个 General 子 Agent，用于复杂搜索和多步骤任务，可在消息中输入 @general 调用。

v1.18.2 新增了 subagent_depth 配置选项（默认为 1），可限制子 Agent 的嵌套层级，防止 Agent 递归失控消耗大量 token。

2.3 75+ LLM 供应商支持

OpenCode 基于 AI SDK 和 models.dev，支持接入超过 75 个 LLM 供应商，涵盖：

  • 主流云端模型：Anthropic Claude、OpenAI GPT、Google Gemini、Groq、OpenRouter、AWS Bedrock、Azure
  • 本地模型：Ollama、LM Studio、llama.cpp 等
  • 自定义端点：任意兼容 OpenAI API 格式的服务

这种"自带密钥"（Bring Your Own Key）的模式让开发者完全掌控模型选择和成本。

2.4 其他关键能力

  • MCP 支持：兼容本地和远程 Model Context Protocol 服务器，可连接数据库、API 和第三方服务。
  • LSP 集成：20+ 语言服务器协议集成（Rust、Python、TypeScript、Go 等），提供实时代码智能分析。
  • 插件系统：基于 JS/TS 的事件驱动插件体系（v2 API 支持 Effect 和 Promise）。
  • 自定义 Agent 与技能：Agent markdown 文件、SKILL.md 自动发现（兼容 Claude Code 技能格式）、自定义斜杠命令。
  • 隐私优先：默认不存储代码和上下文；支持完全离线使用本地模型。

2.5 方案选择

方案 说明
免费版 自带密钥，功能完整
OpenCode Zen 按量计费的精选模型网关
OpenCode Go $10/月，开放模型的统一费率

3. v1.18 系列版本亮点

v1.18 系列于 2026 年 7 月 14 日至 24 日快速迭代，从 v1.18.0 至 v1.18.5 共发布了 6 个版本。

3.1 Desktop v2 默认启用

v1.18 最显著的变化是 Desktop v2 布局成为默认界面。主要改进包括：

  • 标签页（Tabs）：桌面窗口标签页支持跨重启持久化——打开多个会话后关闭应用，重新打开时标签页会自动恢复。
  • Home 标签页切换：可在主页和最近活动会话之间快速跳转。
  • 可关闭的引导弹窗：首次使用 v2 的用户会看到引导提示，可一键关闭。
  • 设置开关：如果偏好旧版布局，可在设置中切换回 Legacy 模式。

注意：Git Worktree 功能在 Desktop v2 中尚未支持，依赖此功能的用户建议暂时保持 Legacy 布局。

3.2 Agent 深度限制（v1.18.2）

新增 subagent_depth 配置，默认为 1，即子 Agent 不可再派生子 Agent。这有效防止了此前版本中可能发生的 Agent 递归失控——一次无意义的中间任务可能消耗 50,000+ token。

{
  "subagent_depth": 1
}

3.3 性能与体验优化

  • 冷启动时间大幅缩短
  • 时间线（Timeline）底部锚定更可靠
  • 重连后时间线正确重新同步
  • Mod+N 快捷键新建标签页
  • 命令面板支持搜索和打开会话

3.4 v1.18.5 更新内容

v1.18.5（2026-07-24）作为 v1.18 系列的最新稳定版，聚焦于 Bug 修复和桌面端完善：

核心修复：

  • 改进 Claude 自适应思考（Adaptive Thinking）在多种响应形态下的处理
  • 避免 OpenAI Responses 阶段处理可能打断部分对话的问题
  • 保留 grep 搜索结果中的符号链接路径
  • 跨对话轮次保留 Mistral 推理历史
  • 稳定 Mistral 提示缓存
  • 修正各 SDK 的提示缓存键
  • 修复 MiniMax M3 思考变体选择

桌面端改进：

  • 支持当前版本服务器终端传输
  • 支持桌面应用中的当前服务器 review 数据
  • 更新服务器发现流程
  • 支持当前服务器会话操作（提示和命令）
  • 渲染当前服务器会话时间线
  • 桌面应用中流式传输当前服务器事件
  • 兼容旧版和新版服务器

社区贡献：此版本包含 2 位社区贡献者的 PR（@dleopold、@remixz）。

4. 安装方式汇总

OpenCode 提供终端应用和桌面应用两种形态，覆盖 Windows、macOS、Linux 三大平台。以下方式整理自 README 和官方网站（opencode.ai/zh）。

4.1 终端应用（命令行）

一键安装（全平台）：

curl -fsSL https://opencode.ai/install | bash

包管理器安装：

方式 命令 适用平台
npm npm i -g opencode-ai@latest 全平台（亦可用 bun/pnpm/yarn）
Homebrew（推荐） brew install anomalyco/tap/opencode macOS、Linux
Homebrew（官方） brew install opencode macOS、Linux
Scoop scoop install opencode Windows
Chocolatey choco install opencode Windows
Pacman sudo pacman -S opencode Arch Linux（稳定版）
AUR paru -S opencode-bin Arch Linux（最新）
mise mise use -g opencode 全平台
Nix nix run nixpkgs#opencode 全平台

若需要最新开发分支版本，Nix 用户可使用 nix run github:anomalyco/opencode。

自定义安装目录：

安装脚本按以下优先级决定安装路径：

  1. $OPENCODE_INSTALL_DIR —— 自定义安装目录
  2. $XDG_BIN_DIR —— XDG 规范路径
  3. $HOME/bin —— 用户二进制目录（如存在或可创建）
  4. $HOME/.opencode/bin —— 默认备用路径
# 示例
OPENCODE_INSTALL_DIR=/usr/local/bin curl -fsSL https://opencode.ai/install | bash
XDG_BIN_DIR=$HOME/.local/bin curl -fsSL https://opencode.ai/install | bash

4.2 桌面应用（Beta）

可直接从 GitHub Releases 页面或 opencode.ai/download 下载对应平台的安装包。

平台 安装包
macOS（Apple Silicon） opencode-desktop-mac-arm64.dmg
macOS（Intel） opencode-desktop-mac-x64.dmg
Windows opencode-desktop-windows-x64.exe
Linux .deb、.rpm 或 .AppImage

通过包管理器安装桌面应用：

# macOS（Homebrew Cask）
brew install --cask opencode-desktop

# Windows（Scoop）
scoop bucket add extras; scoop install extras/opencode-desktop

4.3 安装注意事项

  • 安装前请先移除 0.1.x 之前的旧版本。
  • 桌面应用目前处于 Beta 阶段，v1.18 版本默认启用了全新的 Desktop v2 布局。
  • 如依赖 Git Worktree 功能，建议在桌面应用中切换回 Legacy 布局。

5. 使用入门

5.1 首次启动

安装完成后，在项目目录下运行：

opencode

OpenCode 会自动检测当前目录的代码仓库，启动 TUI（终端交互界面）。首次使用时，需要先连接一个模型提供商——OpenCode 本身不自带模型，需"自带密钥"。

5.2 连接模型

三种方式接入模型：

方式 说明
自带 API 密钥 设置环境变量（如 ANTHROPIC_API_KEY、OPENAI_API_KEY），或在 TUI 内运行 /connect 命令，凭据保存在 ~/.local/share/opencode/auth.json
OpenCode Zen / Go 官方提供的精选模型网关，按量计费或按月订阅，免去自行管理多供应商密钥的麻烦
关联已有订阅 可关联 ChatGPT Plus/Pro、GitHub Copilot、GitLab Duo 等现有订阅

注意：2026 年 1 月起 Anthropic 限制了 OpenCode 对 api.anthropic.com 的直接 API 密钥访问。目前可通过 OAuth（/connect）或经 OpenAI 兼容代理服务来使用 Claude 模型。

5.3 配置文件

OpenCode 的行为由 opencode.json（支持 JSONC 注释格式）控制。配置文件可从多个位置加载，按优先级合并（高优先级覆盖低优先级）：

  1. macOS 托管偏好（.mobileconfig，企业 MDM 下发）
  2. 托管配置文件（/Library/Application Support/opencode/）
  3. 内联配置（OPENCODE_CONFIG_CONTENT 环境变量）
  4. .opencode 目录（agents、commands、plugins）
  5. 项目配置 —— opencode.json（项目根目录，推荐）
  6. 自定义路径（OPENCODE_CONFIG 环境变量）
  7. 全局配置 —— ~/.config/opencode/opencode.json
  8. 远程配置（.well-known/opencode）

一个典型的项目级配置示例：

{
  "$schema": "https://opencode.ai/config.json",
  "model": "anthropic/claude-sonnet-4-5",
  "autoupdate": true,
  "agent": {
    "build": {
      "mode": "primary",
      "permission": { "edit": "allow", "bash": "allow" }
    },
    "plan": {
      "mode": "primary",
      "permission": { "edit": "deny", "bash": "deny" }
    }
  }
}

如需接入自定义 OpenAI 兼容端点：

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "my-provider": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "My Provider",
      "options": {
        "baseURL": "https://your-api-endpoint.com/v1",
        "apiKey": "{env:MY_API_KEY}"
      },
      "models": {
        "model-name": {
          "name": "Display Name",
          "id": "model-id"
        }
      }
    }
  },
  "model": "my-provider/model-name"
}

{env:MY_API_KEY} 是 OpenCode 的环境变量引用语法，密钥不会硬编码在配置文件中。

5.4 常用命令速查

在 TUI 中输入以下斜杠命令进行操作：

命令 用途
/connect 添加/配置 API 密钥或 OAuth 认证
/models 当前会话中切换模型
/init 扫描项目并生成 AGENTS.md，帮助 Agent 理解代码库
/new 创建新的并行会话
/sessions 在不同会话之间切换
/undo / /redo 撤销或重做更改
/export 导出当前对话记录
/share / /unshare 将对话分享为网页（或取消分享）

5.5 快速上手流程

  1. 在项目目录运行 opencode
  2. 执行 /connect 连接模型提供商
  3. 执行 /init 生成项目上下文文件
  4. 按 Tab 在 build（编辑模式）和 plan（只读分析）之间切换
  5. 开始用自然语言描述需求

6. 插件推荐

OpenCode 的插件生态建立在 JS/TS 事件驱动体系之上，通过 opencode.json 中的 plugin 数组声明即可启用。社区维护的 awesome-opencode 是目前最完整的插件索引（7,000+ Star，持续更新）。以下按使用场景分类整理，安装方式和说明均来自社区已验证信息。

6.1 多 Agent 协作

这类插件从根本上改变 OpenCode 的工作方式，让它从单一助手变成能分工协作的团队。

oh-my-opencode（OMO） —— 社区公认首选

引入多 Agent 协作系统，包含代码探索（explore）、架构分析（oracle）、代码审查（momus）等专业 Agent，可并行处理复杂任务。适合中大型项目。

npx oh-my-opencode@latest install

注意：其前身 oh-my-openagent 曾有 Token 消耗较高的问题，建议先从免费模式开始体验。另有精简版 oh-my-opencode-slim 可供选择。

@bluelovers/opencode-arise —— 轻量级编排

一套轻量级编排层，以"暗影军团"主题设计了 7 个角色化 Agent（Monarch 编排、Beru 探索、Igris 实现、Bellion 规划、Tusk 前端、Tank 调研、Shadow Sovereign 推理），支持按 Agent 分别配置模型，实现并行后台任务执行。适合觉得 OMO 太重，又需要多 Agent 协作的场景。

bunx @bluelovers/opencode-arise install

FlowDeck —— 重型工作流引擎

包含 25 个专业 Agent、24 个技能、17 条命令，支持持久化状态和 AI 安全层，适合大型团队和复杂工程流程。

6.2 记忆与上下文

解决 AI "失忆"问题——让 Agent 在数天甚至数周后依然记得项目背景。

opencode-supermemory —— 云端记忆服务

社区使用最广泛的记忆方案（1,200+ 周下载量，v2.0.8）。基于 Supermemory.ai 云端服务，支持自动上下文注入、关键词检测、代码库索引和预压缩。

bunx opencode-supermemory@latest install

opencode-supermemory-max —— 增强版分叉

在官方版基础上增加了日文支持、渐进式捕获、实体上下文、信号提取、三级作用域（用户/项目/仓库）和会话结束自动保存，记忆利用更积极。

opencode-mnemosyne —— 全本地记忆

无需任何云端 API，基于 Mnemosyne 引擎，使用 SQLite FTS5 + 向量搜索 + ONNX Runtime 实现纯本地持久记忆。注册 5 个工具：memory_recall、memory_store、memory_delete 等，支持项目级、全局级和核心级记忆作用域。

@arwiesner/agent-mem —— 独立记忆平台

带 Web UI（http://127.0.0.1:4747）的本地向量数据库（SQLite + HNSW），支持 12+ 本地嵌入模型、智能去重和隐私保护。可作为独立服务运行。

6.3 效率与成本

opencode-token-monitor —— 成本控制

实时追踪输入/输出/推理/缓存 token 消耗，按 Agent 和模型分别统计并提供成本估算。重度用户必备。

npm install -g opencode-token-monitor

opencode-observability —— 可视化监控

社区开发的全链路可观测插件：收集工具执行状态、会话生命周期、消息交互、权限变更等完整数据，通过 WebSocket 推送到 Vue 仪表盘，支持 OpenTelemetry 导出到 Grafana / Datadog。需本地部署后端服务，启动后访问 http://localhost:5173。

注意：出于性能和隐私考虑，该插件仅记录事件骨架（会话 ID、消息角色、时间戳），不记录完整对话文本。

opencode-wakatime —— 时间追踪

自动记录 OpenCode 编程活动，用于分析时间分配。官方文档常用它作为 npm 安装类插件的示例。

opencode plugin --global opencode-wakatime

6.4 沙盒与安全

@daytonaio/opencode（Daytona Sandbox） —— 隔离执行

让 Agent 在独立沙箱中编译、测试甚至运行长时间任务，修改通过 Git 分支回传，不直接影响本地系统。对安全性有较高要求的用户值得关注。

Envsitter Guard —— 敏感文件保护

阻止 Agent 读取或修改 .env 等包含密钥的敏感文件，同时允许安全审查。

opencode-vibeguard —— 隐私脱敏

在 LLM 调用前自动遮蔽代码中的密钥和 PII（个人身份信息），防止敏感数据泄露到模型供应商。

6.5 工程规范类

Superpowers —— TDD 开发流程

来自 obra/superpowers 项目（15,000+ GitHub Star），提供一整套 TDD 驱动的开发工作流技能：交互式头脑风暴、实现计划编写、子 Agent 分派执行、代码审查、Git Worktree 等。通过 Git 地址安装，每次启动自动更新。

{ "plugin": ["superpowers@git+https://github.com/obra/superpowers.git"] }

@fro.bot/systematic —— 全流程技能集

捆绑 40+ 技能和 50+ 专业 Agent，覆盖头脑风暴、规划、实现、审查、知识捕获全流程，零配置开箱即用。也可通过 npx skills 跨平台使用（Claude Code、Cursor、Copilot 等）。

{ "plugins": ["@fro.bot/systematic@latest"] }

opencode-eslint-formatter —— 代码风格自动对齐

将 ESLint 规则集成到 AI 输出流程中，让生成代码自动符合项目风格规范，缩短"生成到提交"的周期。

npm install -g opencode-eslint-formatter

6.6 认证与集成

Antigravity Auth / Multi-Auth —— 免费使用 Gemini 与 Claude

通过 Google Antigravity IDE 的 OAuth 认证，可免费使用 Gemini 3 Pro 和 Claude Opus 4.5 等模型。Multi-Auth 版支持多 Google 账号轮换，在触发速率限制时自动切换。

注意：2026 年 1 月曾出现 Antigravity 版本校验问题导致认证失败，社区已通过固定版本号（1.15.8）修复。使用前确认已安装最新版本。

opencode-google-search —— 实时搜索

通过 Google OAuth 赋予 Agent 实时网络搜索能力，处理新框架、新 API 或前沿问题时尤为有用。

Context7 —— 最新库文档

拉取主流框架的最新文档与代码示例，避免 Agent 基于过时训练数据生成幻觉代码。对 Next.js、React、Stripe 等更新频繁的框架几乎必不可少。

npx ctx7 setup --opencode

Composio —— 外部工具集成

通过 MCP 接入 1,000+ 外部工具（GitHub、Linear、Jira、Slack、Figma、Stripe 等），将 OpenCode 从代码编辑器扩展为全栈工程助手。

6.7 选用建议

场景 推荐组合
刚入门 零插件，先用原生功能熟悉基本流程
简单修 Bug / 单文件编辑 opencode-eslint-formatter
中等规模功能开发 oh-my-opencode + opencode-token-monitor
复杂项目 / 陌生代码库 以上 + Context7 + opencode-supermemory + Daytona Sandbox
追求工程规范 Superpowers 或 @fro.bot/systematic
团队协作 另加 Composio + @nano-step/skill-manager
成本敏感 / 本地优先 opencode-mnemosyne（本地记忆）+ Ollama 本地模型

插件在于补齐短板而非堆砌数量。建议先找出当前工作流中最大的瓶颈，再针对性安装。更多插件可在 awesome-opencode 中按需检索。

7. 结语

OpenCode 的成功并非偶然。它以 MIT 许可证开源、支持 75+ 供应商的模型自由、提供从终端到桌面的完整使用体验，加上活跃的社区贡献（15,000+ 提交），构成了一个飞轮：越开放，越多开发者使用；越多使用，越多反馈和贡献；越多贡献，产品进化越快。

在 AI 编程工具竞争日益激烈的 2026 年，OpenCode 选择了一条与 Claude Code、Cursor 等商业产品不同的路径——不是追求单一供应商的深度集成，而是做开放生态的"通用基座"。这种策略能否持续赢得开发者，值得长期关注。

本文基于 OpenCode v1.18.5 官方 README、Release Notes 及公开资料整理。