【Linux】OpenCode 安装教程

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

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

文章目录

🧭 安装流程概览

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


第一部分:安装OpenCode主程序

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

方式一:一键安装脚本(推荐,最简单)

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

  1. 打开终端。

  2. 执行以下命令:

    bash 复制代码
    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 :

    bash 复制代码
    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系列 :

    bash 复制代码
    sudo apt update && sudo apt install -y libgtk-3-0 libx11-xcb1 libxcb-dri3-0 libgbm1 libnss3 libasound2 wget curl
  • CentOS/RHEL 7系列 :

    bash 复制代码
    sudo yum install -y gtk3 libX11-devel libxcb-devel libgbm-devel nss alsa-lib wget curl
  • CentOS/RHEL 8/9 / Fedora系列 :

    bash 复制代码
    sudo dnf install -y gtk3 libX11-devel libxcb-devel libgbm-devel nss alsa-lib wget curl
  • Arch/Manjaro系列 :

    bash 复制代码
    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的界面或终端中,执行以下命令:

    bash 复制代码
      opencode plugin oh-my-opencode
  3. 安装完成后,可以通过编辑配置文件 ~/.opencode/config.json 来调整插件选项。

方法二:bun交互安装

先安装bun

bash 复制代码
npm install -g bun --registry=https://registry.npmmirror.com

安装Oh-My-OpenCode

bash 复制代码
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编程环境。

相关推荐
Decay__8 小时前
PostgreSQL 数据库全栈运维实战系列 — 合集索引(24 篇)
运维·数据库·sql·mysql·架构
戊本菌8 小时前
进程(三)runqueue 与 Linux 的 O(1) 调度
linux·运维·服务器
光电笑映10 小时前
TCP 为什么可靠?从三次握手、滑动窗口到拥塞控制全面拆解(下)
linux·网络·网络协议·tcp
yz_aiks11 小时前
Termux 使用教程:把安卓手机变成随身 Linux(装 Python、SSH 远程、跑自动化脚本)
android·linux·python·智能手机·ssh·termux
csdn_aspnet13 小时前
在 Docker 容器中本地运行 SQL Server
运维·docker·容器·sqlserver
叼烟扛炮14 小时前
[LangChain] 学习笔记(15):为什么你的重试没用——429、抖动、fallback 与熔断
java·服务器·前端
hi_ro_a14 小时前
Ext系列⽂件系统详解
linux·服务器·操作系统
Z21-X16 小时前
云原生运维学习笔记:Kubernetes Volume 与 Secret 实验
运维·笔记·学习·云原生·kubernetes
你住过的屋檐17 小时前
【SeaweedFS】Linux上搭建SeaweedFS文件存储服务完整教程
linux·运维·服务器
Decay__18 小时前
PostgreSQL 体系架构全解 —— 进程模型、共享内存、MVCC 与 WAL 预写日志深入
运维·数据库·sql·mysql·架构