【Linux】OpenCode 安装教程
本文核心流程可以分为安装OpenCode主程序和集成Oh-My-OpenCode插件两个主要阶段。
以下是详细、清晰的步骤指南。
文章目录
- 🧭 安装流程概览
- 第一部分：安装OpenCode主程序
- 方式一：一键安装脚本（推荐，最简单）
- 方式二：通过Node.js的npm安装
- 方式三：安装桌面Beta版（适合新手）
- 第二部分：集成Oh-My-OpenCode插件
- 方法一：通过OpenCode命令安装（官方推荐）
- 方法二：bun交互安装
- 方法三：AI辅助安装（便捷且不易出错）
🧭 安装流程概览
下图概括了从零开始的完整安装路径，帮助你快速把握全局：
第一部分：安装OpenCode主程序
OpenCode提供了多种在Linux上的安装方式，你可以根据系统环境和偏好选择。
方式一：一键安装脚本（推荐，最简单）
这是官方推荐且最简单的方法，适用于大多数Linux发行版。
- 打开终端。
- 执行以下命令：
curl-fsSLhttps://opencode.ai/install|bash⚠️注意：如果执行时提示权限不足（Permission denied），可以在命令前加上
sudo。 - 安装完成后，输入
opencode启动程序，输入opencode --version验证是否安装成功。
方式二：通过Node.js的npm安装
如果你的系统已安装Node.js，此方法非常快捷。
- 安装Node.js：如果尚未安装，可通过系统包管理器（如
apt）或使用nvm（Node Version Manager）进行安装。 - 全局安装OpenCode：
npminstall-gopencode-ai - 安装完成后，同样通过
opencode命令启动。
方式三：安装桌面Beta版（适合新手）
这是2026年2月推出的新方式，提供图形界面，操作如同安装普通软件。
- 访问OpenCode官方下载页面：https://opencode.ai/download。
- 下载适用于Linux的安装包。根据你的发行版，选择
.deb（适用于Debian/Ubuntu/Mint）或.rpm（适用于CentOS/RHEL/Fedora）格式的文件。 - 安装方式：
- 对于
.deb文件，可以在终端中执行：sudo dpkg -i 文件名.deb，然后执行sudo apt-get install -f来修复可能存在的依赖问题。 - 对于
.rpm文件，可以使用sudo yum localinstall 文件名.rpm或sudo dnf localinstall 文件名.rpm。
- 对于
- 安装完成后，在应用菜单中找到OpenCode图标，双击启动即可。
- Debian/Ubuntu系列：
sudoaptupdate&&sudoaptinstall-ylibgtk-3-0 libx11-xcb1 libxcb-dri3-0 libgbm1 libnss3 libasound2wgetcurl - CentOS/RHEL 7系列：
sudoyuminstall-ygtk3 libX11-devel libxcb-devel libgbm-devel nss alsa-libwgetcurl - CentOS/RHEL 8/9 / Fedora系列：
sudodnfinstall-ygtk3 libX11-devel libxcb-devel libgbm-devel nss alsa-libwgetcurl - Arch/Manjaro系列：
sudopacman-Syugtk3 libx11 libxcb libgbm nss alsa-libwgetcurl--noconfirm
你可以通过输入uname -m来验证系统架构，输出x86_64即为兼容。
第二部分：集成Oh-My-OpenCode插件
Oh-My-OpenCode是一个强大的增强插件，能提供异步调用、关键词触发等高级功能。主要有两种安装方法：
方法一：通过OpenCode命令安装（官方推荐）
这是最直接的方法，通过OpenCode自身的插件管理器进行安装，安装在当前路径下。
- 确保OpenCode主程序已安装并成功启动。
- 在OpenCode的界面或终端中，执行以下命令：
opencode plugin oh-my-opencode - 安装完成后，可以通过编辑配置文件
~/.opencode/config.json来调整插件选项。
方法二：bun交互安装
先安装bun
npminstall-gbun--registry=https://registry.npmmirror.com安装Oh-My-OpenCode
bunx oh-my-openagentinstall方法三：AI辅助安装（便捷且不易出错）
这是一种更智能的方式，让OpenCode的AI来帮你完成安装过程。
- 打开OpenCode，切换到“build”模式（推荐使用MiniMax模型）。
- 将以下官方安装说明链接作为提示词提供给AI：
https://raw.githubusercontent.com/code-yeongyu/oh-my-opencode/refs/heads/master/docs/guide/installation.md - AI会解析这个链接并根据官方要求自动执行安装。安装过程中可能会提示订阅选项，你可根据个人情况选择。
- 等待安装完成即可。
💡小贴士：如果安装时长时间卡住，可以尝试使用命令
npx oh-my-opencode install作为备选方案。
通过以上步骤，你就可以在Linux系统上成功从零搭建起一个功能强大的OpenCode AI编程环境。