本文核心流程可以分为 安装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发行版。
⚠️ 注意:如果执行时提示权限不足(Permission denied),可以在命令前加上 sudo。
方式二:通过Node.js的npm安装
如果你的系统已安装Node.js,此方法非常快捷。
方式三:安装桌面Beta版(适合新手)
这是2026年2月推出的新方式,提供图形界面,操作如同安装普通软件。
- 对于 .deb 文件,可以在终端中执行:sudo dpkg -i 文件名.deb,然后执行 sudo apt-get install -f 来修复可能存在的依赖问题。
- 对于 .rpm 文件,可以使用 sudo yum localinstall 文件名.rpm 或 sudo dnf localinstall 文件名.rpm。
安装前的系统依赖准备(可选) 如果你的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自身的插件管理器进行安装,安装在当前路径下。
方法二:bun交互安装
先安装bun
npm install -g bun –registry=https://registry.npmmirror.com
安装Oh-My-OpenCode
bunx oh-my-openagent install
方法三:AI辅助安装(便捷且不易出错)
这是一种更智能的方式,让OpenCode的AI来帮你完成安装过程。
💡 小贴士:如果安装时长时间卡住,可以尝试使用命令 npx oh-my-opencode install 作为备选方案。 通过以上步骤,你就可以在Linux系统上成功从零搭建起一个功能强大的OpenCode AI编程环境。






