欢迎光临
我们一直在努力

【Linux】OpenCode 安装教程

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

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

文章目录

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

安装流程概览

下图概括了从零开始的完整安装路径,帮助你快速把握全局:

#mermaid-svg-GawkMoTbDkETLIXF{font-family:\”trebuchet ms\”,verdana,arial,sans-serif;font-size:16px;fill:#333;}@keyframes edge-animation-frame{from{stroke-dashoffset:0;}}@keyframes dash{to{stroke-dashoffset:0;}}#mermaid-svg-GawkMoTbDkETLIXF .edge-animation-slow{stroke-dasharray:9,5!important;stroke-dashoffset:900;animation:dash 50s linear infinite;stroke-linecap:round;}#mermaid-svg-GawkMoTbDkETLIXF .edge-animation-fast{stroke-dasharray:9,5!important;stroke-dashoffset:900;animation:dash 20s linear infinite;stroke-linecap:round;}#mermaid-svg-GawkMoTbDkETLIXF .error-icon{fill:#552222;}#mermaid-svg-GawkMoTbDkETLIXF .error-text{fill:#552222;stroke:#552222;}#mermaid-svg-GawkMoTbDkETLIXF .edge-thickness-normal{stroke-width:1px;}#mermaid-svg-GawkMoTbDkETLIXF .edge-thickness-thick{stroke-width:3.5px;}#mermaid-svg-GawkMoTbDkETLIXF .edge-pattern-solid{stroke-dasharray:0;}#mermaid-svg-GawkMoTbDkETLIXF .edge-thickness-invisible{stroke-width:0;fill:none;}#mermaid-svg-GawkMoTbDkETLIXF .edge-pattern-dashed{stroke-dasharray:3;}#mermaid-svg-GawkMoTbDkETLIXF .edge-pattern-dotted{stroke-dasharray:2;}#mermaid-svg-GawkMoTbDkETLIXF .marker{fill:#333333;stroke:#333333;}#mermaid-svg-GawkMoTbDkETLIXF .marker.cross{stroke:#333333;}#mermaid-svg-GawkMoTbDkETLIXF svg{font-family:\”trebuchet ms\”,verdana,arial,sans-serif;font-size:16px;}#mermaid-svg-GawkMoTbDkETLIXF p{margin:0;}#mermaid-svg-GawkMoTbDkETLIXF .label{font-family:\”trebuchet ms\”,verdana,arial,sans-serif;color:#333;}#mermaid-svg-GawkMoTbDkETLIXF .cluster-label text{fill:#333;}#mermaid-svg-GawkMoTbDkETLIXF .cluster-label span{color:#333;}#mermaid-svg-GawkMoTbDkETLIXF .cluster-label span p{background-color:transparent;}#mermaid-svg-GawkMoTbDkETLIXF .label text,#mermaid-svg-GawkMoTbDkETLIXF span{fill:#333;color:#333;}#mermaid-svg-GawkMoTbDkETLIXF .node rect,#mermaid-svg-GawkMoTbDkETLIXF .node circle,#mermaid-svg-GawkMoTbDkETLIXF .node ellipse,#mermaid-svg-GawkMoTbDkETLIXF .node polygon,#mermaid-svg-GawkMoTbDkETLIXF .node path{fill:#ECECFF;stroke:#9370DB;stroke-width:1px;}#mermaid-svg-GawkMoTbDkETLIXF .rough-node .label text,#mermaid-svg-GawkMoTbDkETLIXF .node .label text,#mermaid-svg-GawkMoTbDkETLIXF .image-shape .label,#mermaid-svg-GawkMoTbDkETLIXF .icon-shape .label{text-anchor:middle;}#mermaid-svg-GawkMoTbDkETLIXF .node .katex path{fill:#000;stroke:#000;stroke-width:1px;}#mermaid-svg-GawkMoTbDkETLIXF .rough-node .label,#mermaid-svg-GawkMoTbDkETLIXF .node .label,#mermaid-svg-GawkMoTbDkETLIXF .image-shape .label,#mermaid-svg-GawkMoTbDkETLIXF .icon-shape .label{text-align:center;}#mermaid-svg-GawkMoTbDkETLIXF .node.clickable{cursor:pointer;}#mermaid-svg-GawkMoTbDkETLIXF .root .anchor path{fill:#333333!important;stroke-width:0;stroke:#333333;}#mermaid-svg-GawkMoTbDkETLIXF .arrowheadPath{fill:#333333;}#mermaid-svg-GawkMoTbDkETLIXF .edgePath .path{stroke:#333333;stroke-width:2.0px;}#mermaid-svg-GawkMoTbDkETLIXF .flowchart-link{stroke:#333333;fill:none;}#mermaid-svg-GawkMoTbDkETLIXF .edgeLabel{background-color:rgba(232,232,232, 0.8);text-align:center;}#mermaid-svg-GawkMoTbDkETLIXF .edgeLabel p{background-color:rgba(232,232,232, 0.8);}#mermaid-svg-GawkMoTbDkETLIXF .edgeLabel rect{opacity:0.5;background-color:rgba(232,232,232, 0.8);fill:rgba(232,232,232, 0.8);}#mermaid-svg-GawkMoTbDkETLIXF .labelBkg{background-color:rgba(232, 232, 232, 0.5);}#mermaid-svg-GawkMoTbDkETLIXF .cluster rect{fill:#ffffde;stroke:#aaaa33;stroke-width:1px;}#mermaid-svg-GawkMoTbDkETLIXF .cluster text{fill:#333;}#mermaid-svg-GawkMoTbDkETLIXF .cluster span{color:#333;}#mermaid-svg-GawkMoTbDkETLIXF div.mermaidTooltip{position:absolute;text-align:center;max-width:200px;padding:2px;font-family:\”trebuchet ms\”,verdana,arial,sans-serif;font-size:12px;background:hsl(80, 100%, 96.2745098039%);border:1px solid #aaaa33;border-radius:2px;pointer-events:none;z-index:100;}#mermaid-svg-GawkMoTbDkETLIXF .flowchartTitleText{text-anchor:middle;font-size:18px;fill:#333;}#mermaid-svg-GawkMoTbDkETLIXF rect.text{fill:none;stroke-width:0;}#mermaid-svg-GawkMoTbDkETLIXF .icon-shape,#mermaid-svg-GawkMoTbDkETLIXF .image-shape{background-color:rgba(232,232,232, 0.8);text-align:center;}#mermaid-svg-GawkMoTbDkETLIXF .icon-shape p,#mermaid-svg-GawkMoTbDkETLIXF .image-shape p{background-color:rgba(232,232,232, 0.8);padding:2px;}#mermaid-svg-GawkMoTbDkETLIXF .icon-shape .label rect,#mermaid-svg-GawkMoTbDkETLIXF .image-shape .label rect{opacity:0.5;background-color:rgba(232,232,232, 0.8);fill:rgba(232,232,232, 0.8);}#mermaid-svg-GawkMoTbDkETLIXF .label-icon{display:inline-block;height:1em;overflow:visible;vertical-align:-0.125em;}#mermaid-svg-GawkMoTbDkETLIXF .node .label-icon path{fill:currentColor;stroke:revert;stroke-width:revert;}#mermaid-svg-GawkMoTbDkETLIXF :root{–mermaid-font-family:\”trebuchet ms\”,verdana,arial,sans-serif;}

推荐

备选

体验

Linux系统准备

选择安装方式

优先级判断

一键安装脚本

Node.js/npm安装

桌面Beta版

验证安装

集成Oh-My-OpenCode

通过OpenCode命令安装

通过AI辅助安装

完成


第一部分:安装OpenCode主程序

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

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

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

  • 打开终端。
  • 执行以下命令:curl -fsSL https://opencode.ai/install | bash

    ⚠️ 注意:如果执行时提示权限不足(Permission denied),可以在命令前加上 sudo。

  • 安装完成后,输入 opencode 启动程序,输入 opencode –version 验证是否安装成功。
  • 方式二:通过Node.js的npm安装

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

  • 安装Node.js:如果尚未安装,可通过系统包管理器(如 apt)或使用 nvm(Node Version Manager)进行安装。
  • 全局安装OpenCode:npm install -g opencode-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系列: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自身的插件管理器进行安装,安装在当前路径下。

  • 确保OpenCode主程序已安装并成功启动。
  • 在OpenCode的界面或终端中,执行以下命令: opencode plugin oh-my-opencode
  • 安装完成后,可以通过编辑配置文件 ~/.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来帮你完成安装过程。

  • 打开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编程环境。

    赞(0)
    未经允许不得转载:171主机测评 » 【Linux】OpenCode 安装教程
    分享到: 更多 (0)

    评论 抢沙发

    • 昵称 (必填)
    • 邮箱 (必填)
    • 网址