【Linux】OpenCode 安装教程

本文核心流程可以分为安装OpenCode主程序 和集成Oh-My-OpenCode插件两个主要阶段。

以下是详细、清晰的步骤指南。

文章目录

• • • [🧭 安装流程概览](#🧭 安装流程概览)
    • 第一部分：安装OpenCode主程序
    • • 方式一：一键安装脚本（推荐，最简单）
      • 方式二：通过Node.js的npm安装
      • 方式三：安装桌面Beta版（适合新手）
    • 第二部分：集成Oh-My-OpenCode插件
    • • 方法一：通过OpenCode命令安装（官方推荐）
      • 方法二：bun交互安装
      • 方法三：AI辅助安装（便捷且不易出错）

🧭 安装流程概览

下图概括了从零开始的完整安装路径，帮助你快速把握全局：
推荐
备选
体验
Linux系统准备
选择安装方式
优先级判断
一键安装脚本
Node.js/npm安装
桌面Beta版
验证安装
集成Oh-My-OpenCode
通过OpenCode命令安装
通过AI辅助安装
完成

---

第一部分：安装OpenCode主程序

OpenCode提供了多种在Linux上的安装方式，你可以根据系统环境和偏好选择。

方式一：一键安装脚本（推荐，最简单）

这是官方推荐且最简单的方法，适用于大多数Linux发行版。

1. 打开终端。

2. 执行以下命令：

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

   ⚠️ 注意 ：如果执行时提示权限不足（Permission denied），可以在命令前加上 sudo。

3. 安装完成后，输入 opencode 启动程序，输入 opencode --version 验证是否安装成功。

方式二：通过Node.js的npm安装

如果你的系统已安装Node.js，此方法非常快捷。

1. 安装Node.js ：如果尚未安装，可通过系统包管理器（如 apt）或使用 nvm（Node Version Manager）进行安装。

2. 全局安装OpenCode ：

   npm install -g opencode-ai

3. 安装完成后，同样通过 opencode 命令启动。

方式三：安装桌面Beta版（适合新手）

这是2026年2月推出的新方式，提供图形界面，操作如同安装普通软件。

1. 访问OpenCode官方下载页面：https://opencode.ai/download。
2. 下载适用于Linux的安装包。根据你的发行版，选择 .deb（适用于Debian/Ubuntu/Mint）或 .rpm（适用于CentOS/RHEL/Fedora）格式的文件。
3. 安装方式 ：
   • 对于 .deb 文件，可以在终端中执行：sudo dpkg -i 文件名.deb，然后执行 sudo apt-get install -f 来修复可能存在的依赖问题。
   • 对于 .rpm 文件，可以使用 sudo yum localinstall 文件名.rpm 或 sudo dnf localinstall 文件名.rpm。
4. 安装完成后，在应用菜单中找到OpenCode图标，双击启动即可。

📖 安装前的系统依赖准备（可选） 如果你的Linux系统是精简版（无图形库），在安装OpenCode桌面版或CLI前，可能需要先安装一些基础图形库（如GTK3、X11等）。不同发行版的命令如下：

• Debian/Ubuntu系列 ：

  sudo apt update && sudo apt install -y libgtk-3-0 libx11-xcb1 libxcb-dri3-0 libgbm1 libnss3 libasound2 wget curl

• CentOS/RHEL 7系列 ：

  sudo yum install -y gtk3 libX11-devel libxcb-devel libgbm-devel nss alsa-lib wget curl

• CentOS/RHEL 8/9 / Fedora系列 ：

  sudo dnf install -y gtk3 libX11-devel libxcb-devel libgbm-devel nss alsa-lib wget curl

• Arch/Manjaro系列 ：

  sudo pacman -Syu gtk3 libx11 libxcb libgbm nss alsa-lib wget curl --noconfirm

你可以通过输入 uname -m 来验证系统架构，输出 x86_64 即为兼容。

---

第二部分：集成Oh-My-OpenCode插件

Oh-My-OpenCode是一个强大的增强插件，能提供异步调用、关键词触发等高级功能。主要有两种安装方法：

方法一：通过OpenCode命令安装（官方推荐）

这是最直接的方法，通过OpenCode自身的插件管理器进行安装，安装在当前路径下。

1. 确保OpenCode主程序已安装并成功启动。

2. 在OpenCode的界面或终端中，执行以下命令：

     opencode plugin oh-my-opencode

3. 安装完成后，可以通过编辑配置文件 ~/.opencode/config.json 来调整插件选项。

方法二：bun交互安装

先安装bun

npm install -g bun --registry=https://registry.npmmirror.com

安装Oh-My-OpenCode

bunx oh-my-openagent install

方法三：AI辅助安装（便捷且不易出错）

这是一种更智能的方式，让OpenCode的AI来帮你完成安装过程。

1. 打开OpenCode，切换到"build"模式（推荐使用MiniMax模型）。

2. 将以下官方安装说明链接 作为提示词提供给AI：

   https://raw.githubusercontent.com/code-yeongyu/oh-my-opencode/refs/heads/master/docs/guide/installation.md

3. AI会解析这个链接并根据官方要求自动执行安装。安装过程中可能会提示订阅选项，你可根据个人情况选择。

4. 等待安装完成即可。

💡 小贴士 ：如果安装时长时间卡住，可以尝试使用命令 npx oh-my-opencode install 作为备选方案。

通过以上步骤，你就可以在Linux系统上成功从零搭建起一个功能强大的OpenCode AI编程环境。