最近,“Skills”在AI圈子里太火了!
大家都在用它给 AI 加各种“buff”,让它自动写代码、做表格等等
但很多小伙伴看着 GitHub 上那些 Skills 兴奋不已,真到了本地想玩一把时,使用Claude code有很多不便的地方
之前就有很多小伙伴问我OpenCode,整好借着Skills,来聊聊OpenCode的安装部署和使用
很简单,不管你是想用图形界面还是命令行,这篇保姆级教程都能让你轻松上手!
咱们这就开始,带你入门OpenCode玩转 Skills!
目录:
1. ✅ 如何下载安装OpenCode
2. ✅ 如何安装和配置Skills
3. ✅ 环境变量的设置方法
4. ✅ 常用指令和操作技巧
5. ✅ 遇到问题如何解决
6. ✅ 如何创建自己的Skills
一、下载安装,超级简单
下载地址:
https://opencode.ai/download

为了让大家减少安装部署方面带来的不必要的时间消耗,咱们可以选择使用windows桌面端方式,软件安装很简单,这里不再赘述。
安装完成后,在目录下会有3个exe程序:

• OpenCode.exe — 这个是OpenCode桌面端程序,就是带界面的,整个界面很清爽

• OpenCode-cli.exe — 这就是经典的命令行模式(TUI)

• uninstall.exe — 卸载程序
二、安装Skills,体验更多功能
咱们先来安装几个skills来体验下,配置、操作等等后面再介绍。
双击OpenCode-cli.exe打开界面,直接问它”我能使用什么skills”?

从上图可以看到,我没有任何skills,没关系,咱们现在就来添加一些!
- 小提示:我是因为配置了自己的模型,所以你看到的模型和我这里可能不一样,不过没关系,后面会介绍如何配置模型API。
接下来,咱们从skills网站上下载压缩包,或者从github把skills下载下来
下面用官方的Skills做个演示
- 1. 在软件安装目录下创建一个目录,名字叫.opencode,要看好,目录是开头的哦
- 2. GitHub地址:https://github.com/anthropics/skills
- 3. 下载完成后,用解压缩文件打开会看到下面的内容(其实不用解压缩,opencode可以帮你自动解压,这里为了方便演示)

- 4. 把这里的skills复制到刚才创建的目录.opencode里面
回到opencode,在里面输入/init回车,这时候就会看到opencode开始理解项目内容,加载这些skills。

- 注意: 在输入/init前,需要按一下键盘的Tab键,目的是把plan切换为build模式。
验证安装再来问一次”我能使用什么skills?”

到这里,Opencode就知道你有什么skills了!
OpenCode.exe的使用方式相同哦。

三、环境变量配置,灵活又方便
OpenCode不需要opencode.json文件就能运行,因为它有默认配置和多种配置加载方式。这里主要说两个最常用的:
1. 全局配置
~/.config/opencode/opencode.json
全局环境变量路径:C:\Users\你的用户名\.config\opencode
2. 项目配置
项目所在目录的opencode.json
项目环境变量:可以随意配置路径,例如我的项目路径就是在D:\Software-Install\OpenCode\.opencode
四、常用指令,记住这几个就够了
1. 切换模式
OpenCode有两种模式:plan和build,使用Tab键来切换。

如果使用桌面端也就是OpenCode.exe,那么都是图形化操作了,很简单。

2. 选择模型
使用/models,默认提供3个免费使用的模型(免费的,所以会出现链接失败的情况)


3. 添加自己的模型API
使用/connect,这里提供了很多选择。

4. 引用skills
只要输入的内容中包括了skills的触发条件,一般情况下都可以调用对应的skills,也可以通过@来指定需要的skills,上、下方向键选择,回车键确认。桌面端操作相同
5. 主要斜杠命令汇总
|
|
|
|
|---|---|---|
| 连接与设置 |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 对话管理 |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 编辑与撤销 |
|
|
|
|
|
|
|
|
|
|
| 项目与代理 |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 其他 |
|
|
五、操作演示,遇到问题怎么办?
问题1:Opencode操作不会怎么办?
直接问他! 用默认的模型就足够了。

从这里就能了解到,如果我想创建项目级配置,那么首先我要进入到指定项目,在该目录里打开opencode,再执行/init,这时候就会生成一套基于这个项目的配置。
这种分层系统让你既能有全局的个人偏好,又能为每个项目定制专门的配置
问题2:skills不会用怎么办?
直接问它:
@你需要了解的SKILLS,后面加上”这个skills如何使用?”

问题3:添加的模型API保存在哪里?
没有配置也可以使用免费的大模型,但是如果你要使用自己的模型,使用/connect打开模型配置界面选择自己用的模型供应商,
例如我用的是阿里,把模型API粘贴进去,回车就行了。
问题来了,我填入的API在哪里呢?

默认保存在如下路径:
C:\Users\你的用户名\.local\share\opencode\auth.json
问题4:创建自己的skills
只需要@出skill-creater,再表达清楚你的skill描述就可以了。 举个例子:

OpenCode会根据你的描述,自动生成对应的skill配置文件,整个过程非常智能化,你只需要告诉它你想要什么功能,剩下的交给它就行!
接下来你可以:
• 🚀 尝试创建自己的Skills,让AI帮你自动化更多工作
• 🔍 探索更多GitHub上的开源Skills,扩展你的工具箱