【无标题】

一、升级 Node.js(必须先做)

OpenCode 要求 Node.js 18+,你当前的 v10.24.0 跑不起来 。

  1. 安装 nvm(国内镜像,绕过 GitHub)

创建 nvm 目录并手动下载核心文件(绕过 git clone)

mkdir -p ~/.nvm && cd ~/.nvm

wget https://gitee.com/mirrors/nvm/raw/v0.39.7/nvm.sh -O nvm.sh

wget https://gitee.com/mirrors/nvm/raw/v0.39.7/nvm-exec -O nvm-exec

wget https://gitee.com/mirrors/nvm/raw/v0.39.7/bash_completion -O bash_completion

chmod +x nvm-exec

配置 shell

cat >> ~/.bashrc << 'EOF'

export NVM_DIR=" H O M E / . n v m " − s " HOME/.nvm" \[ -s " HOME/.nvm"\[−s"NVM_DIR/nvm.sh" && . " N V M D I R / n v m . s h " − s " NVM_DIR/nvm.sh" \[ -s " NVMDIR/nvm.sh"\[−s"NVM_DIR/bash_completion" && . "$NVM_DIR/bash_completion"

EOF

source ~/.bashrc

  1. 安装 Node.js 18(国内镜像)

关键:指向国内镜像,否则 nvm install 会卡死

export NVM_NODEJS_ORG_MIRROR=https://npmmirror.com/mirrors/node

echo 'export NVM_NODEJS_ORG_MIRROR=https://npmmirror.com/mirrors/node' >> ~/.bashrc

source ~/.bashrc

安装 Node 18

nvm install 18

nvm alias default 18

验证

node -v # v18.x.x

npm -v # 9.x.x 或 10.x.x

💡 如果 nvm install 18 还是卡,用离线方案:从 https://npmmirror.com/mirrors/node/v18.20.4/node-v18.20.4-linux-x64.tar.xz 手动下载,解压到 ~/.nvm/versions/node/v18.20.4/。

二、安装 OpenCode

方式一:npm 全局安装(推荐)

设置 npm 国内镜像

npm config set registry https://registry.npmmirror.com

全局安装

npm install -g opencode-ai

验证

opencode --version

方式二:一键脚本(需要能访问 opencode.ai)

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

启动 OpenCode

在项目目录启动终端 TUI

opencode

或启动 Web 界面(远程/容器环境有用)

opencode web --hostname 0.0.0.0 --port 4242

三、添加自定义 Skill(核心)

OpenCode 的 Skill 是放在特定目录下的 SKILL.md 文件,OpenCode 会自动发现并加载 。

  1. Skill 的存放位置
    OpenCode 会搜索以下目录 :
    作用域

路径

项目级(仅当前项目)

<项目根>/.opencode/skills/<skill名>/SKILL.md

全局(所有项目)

~/.config/opencode/skills/<skill名>/SKILL.md

Claude 兼容(项目级)

<项目根>/.claude/skills/<skill名>/SKILL.md

Claude 兼容(全局)

~/.claude/skills/<skill名>/SKILL.md

💡 建议:个人常用 skill 放全局 ~/.config/opencode/skills/;项目专属 skill 放项目内的 .opencode/skills/

  1. SKILL.md 的格式规范
    每个 Skill 是一个目录,里面至少有一个 SKILL.md 文件 :
    skill-name/
    ├── SKILL.md # 必需:核心定义文件
    ├── scripts/ # 可选:可执行脚本(Python/Bash)
    ├── references/ # 可选:参考文档
    └── assets/ # 可选:模板、图片等资源

SKILL.md 的开头必须是 YAML frontmatter,目前 OpenCode 仅识别这些字段 :

name: skill-name # 必填,1-64 字符,小写字母数字+连字符,必须和目录名一致

description: 描述文本 # 必填,1-1024 字符,要写清楚"做什么、什么时候用、举几个例子"
license: MIT # 可选
compatibility: opencode # 可选
metadata: # 可选
key: value

name 的命名规则(正则 [1](#1)+(-a-z0-9+)*$):

只能小写字母、数字、连字符

不能以 - 开头或结尾

不能有连续的 --

必须与包含 SKILL.md 的目录名一致


  1. a-z0-9 ↩︎
相关推荐
七夜zippoe16 小时前
流式输出:让 AI 回答像打字机一样实时返回(SSE 全链路实战)
人工智能·spring·ai·流式输出·ssf
装不满的克莱因瓶16 小时前
【AI时代必学】一篇文章教会你从零搭建Serverless架构
java·人工智能·ai·云原生·架构·serverless
七夜zippoe17 小时前
多轮对话管理:Session/记忆在 Java 后端怎么存(存储设计实战)
java·开发语言·ai·session·记忆
吴名氏.20 小时前
Java转AI Agent教程(第十五周)政策时效:过期政策不该被召回,也不能被删掉
java·人工智能·python·ai·ai agent
小七-七牛开发者1 天前
周 1 上线 | DSH 喜提原神进场动画,Anthropic 启动 IPO 路演;黄仁勋辞任;微软全球大宕机超 24 小时
ai·大模型·agent·token·工作流·claudecode·ai coding
GISer_Jing1 天前
GitHub热点I
后端·ai·langchain
QuZhengRong1 天前
【AI】Agent 全栈进阶|AgentScope 沙箱源码解析
python·学习·ai·agent·沙箱
梯度下降者2 天前
让AI的“隐形思维“也能越练越强,这项突破或将重写推理效率的边界
ai·强化学习·潜在推理·代理概率·停止门
我才是银古2 天前
chat-demo 源码解析与 DeepSeek 全家桶 API 能力盘点
ai·demo·deepseek
装不满的克莱因瓶2 天前
【从零搭建】AI大模型之ReactAgent智能体对接MCP实战
java·人工智能·ai·springai·mcp·springaialibaba