【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发行版。打开终端。执行以下命令curl-fsSLhttps://opencode.ai/install|bash⚠️注意如果执行时提示权限不足Permission denied可以在命令前加上sudo。安装完成后输入opencode启动程序输入opencode --version验证是否安装成功。方式二通过Node.js的npm安装如果你的系统已安装Node.js此方法非常快捷。安装Node.js如果尚未安装可通过系统包管理器如apt或使用nvmNode Version Manager进行安装。全局安装OpenCodenpminstall-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图标双击启动即可。 安装前的系统依赖准备可选 如果你的Linux系统是精简版无图形库在安装OpenCode桌面版或CLI前可能需要先安装一些基础图形库如GTK3、X11等。不同发行版的命令如下Debian/Ubuntu系列sudoaptupdatesudoaptinstall-ylibgtk-3-0 libx11-xcb1 libxcb-dri3-0 libgbm1 libnss3 libasound2wgetcurlCentOS/RHEL 7系列sudoyuminstall-ygtk3 libX11-devel libxcb-devel libgbm-devel nss alsa-libwgetcurlCentOS/RHEL 8/9 / Fedora系列sudodnfinstall-ygtk3 libX11-devel libxcb-devel libgbm-devel nss alsa-libwgetcurlArch/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交互安装先安装bunnpminstall-gbun--registryhttps://registry.npmmirror.com安装Oh-My-OpenCodebunx oh-my-openagentinstall方法三AI辅助安装便捷且不易出错这是一种更智能的方式让OpenCode的AI来帮你完成安装过程。打开OpenCode切换到“build”模式推荐使用MiniMax模型。将以下官方安装说明链接作为提示词提供给AIhttps://raw.githubusercontent.com/code-yeongyu/oh-my-opencode/refs/heads/master/docs/guide/installation.mdAI会解析这个链接并根据官方要求自动执行安装。安装过程中可能会提示订阅选项你可根据个人情况选择。等待安装完成即可。小贴士如果安装时长时间卡住可以尝试使用命令npx oh-my-opencode install作为备选方案。通过以上步骤你就可以在Linux系统上成功从零搭建起一个功能强大的OpenCode AI编程环境。