最近，“Skills”在AI圈子里简直就是顶流。
大家都在用它给AI加各种“Buff”，让AI自动写代码、处理表格。但说实话，很多人一看到GitHub上那些Skills就兴奋起来，真到了自己电脑上想玩一把的时候，却发现用Claude code并不顺手。
之前就有不少朋友问OpenCode，正好趁这波Skills的热度，来系统聊聊它的安装部署和使用。别担心，不管你是偏爱图形界面还是命令行，这篇教程都能让你快速上手。
咱们先捋一下大纲：
1. ✅ 如何下载安装OpenCode
2. ✅ 如何安装和配置Skills
3. ✅ 环境变量的设置方法
4. ✅ 常用指令和操作技巧
5. ✅ 遇到问题如何解决
6. ✅ 如何创建自己的Skills
一、下载安装，说简单就简单
下载地址：https://opencode.ai/download
为了帮你省掉不必要的部署时间，推荐直接使用Windows桌面端。安装过程没什么好说的，一路下一步就好。
安装完成后，目录下会出现三个exe程序：
- OpenCode.exe —— 桌面端程序，界面干净清爽
- OpenCode-cli.exe —— 命令行模式（TUI），经典风味
- uninstall.exe —— 卸载程序
二、安装Skills，体验拉满
先装几个Skills体验一下，配置和操作后面再说。
双击OpenCode-cli.exe打开界面，直接问它：“我能使用什么skills？”
从图上可以看到，当前没有任何skills。没关系，咱们来添加一些。
小提示：因为我已经配置了自己的模型，所以你看到的模型可能不太一样。不过别急，后面会专门讲如何配置模型API。
接着，从Skills网站下载压缩包，或者直接从GitHub拉取。这里用官方Skills做个演示：
- 在软件安装目录下创建一个名为
.opencode的目录（注意，开头有个点） - GitHub地址：https://github.com/anthropics/skills
- 下载完成后，用解压软件打开会看到一堆文件（其实不用解压，OpenCode能自动帮你处理）
- 把里面的skills复制到刚才创建的
.opencode目录里
回到OpenCode，输入/init并回车，它会开始理解项目内容，加载这些skills。
注意：输入/init前，先按一下Tab键，把模式从plan切换为build。
验证一下：再问一次“我能使用什么skills？”
到这里，OpenCode已经知道你有哪些skills了！桌面端OpenCode.exe的操作方式完全相同。
三、环境变量配置，灵活又方便
OpenCode不需要opencode.json也能运行，因为它有默认配置和多种加载方式。这里只说最常用的两个：
1. 全局配置
默认路径：~/.config/opencode/opencode.json
在Windows上对应：C:\Users\你的用户名\.config\opencode
2. 项目配置
就是项目所在目录下的opencode.json。路径可以随意设定，比如我的项目路径是D:\Software-Install\OpenCode\.opencode。
四、常用指令，记住这几个就够了
1. 切换模式
OpenCode有两种模式：plan和build，用Tab键切换。桌面端全部图形化操作，更简单。
2. 选择模型
输入/models，默认提供3个免费模型（免费模型偶尔会连接失败，这很正常）。
3. 添加自己的模型API
输入/connect，选择你的模型供应商即可。
4. 引用skills
输入内容中只要包含skills的触发条件，一般都能自动调用。也可以直接输入@来指定，用上下方向键选择，回车确认。桌面端操作相同。
5. 主要斜杠命令汇总
| 命令类别 | 命令 | 功能说明 |
|---|---|---|
| 连接与设置 | /connect | 新增LLM提供商（如Anthropic、OpenAI） |
| /models | 列出并切换可用的AI模型 | |
| /themes | 切换终端界面主题 | |
| /help | 显示帮助对话框 | |
| 对话管理 | /new | 开始新对话 |
| /sessions | 列出所有历史对话并切换 | |
| /compact | 压缩当前对话内容，节省上下文窗口 | |
| /export | 将会话记录导出到文件 | |
| /share | 生成当前对话的分享链接 | |
| 编辑与撤销 | /undo | 撤销上一条AI消息及其带来的所有文件更改 |
| /redo | 重做已撤销的更改 | |
| /editor | 打开外部编辑器 | |
| 项目与袋里 | /init | 初始化项目，扫描并生成AGENTS.md文件，帮助AI理解项目结构 |
| /agents | 切换或管理AI袋里（如Plan/Build模式） | |
| /review | 审查未提交的代码更改 | |
| /mcp | 管理模型上下文协议（Model Context Protocol） | |
| 其他 | /exit | 退出OpenCode应用程序 |
五、操作演示，遇到问题怎么办？
问题1：OpenCode操作不会怎么办？
直接问它！用默认模型就足够了。比如你想知道怎么创建项目级配置，只需在指定项目目录中打开OpenCode，输入/init，它就会自动生成一套基于当前项目的配置。这种分层系统很巧妙——你既能保留全局的个人偏好，又可以为每个项目定制专属配置。
问题2：Skills不会用怎么办？
直接问它：@你需要了解的SKILLS 这个skills如何使用？
问题3：添加的模型API保存在哪里？
即使不配置也能用免费模型。但如果想用自己的模型，输入/connect打开配置界面，选择模型供应商，比如我用阿里，把模型API粘贴进去，回车即可。那么API到底存在哪？默认路径是：C:\Users\你的用户名\.local\share\opencode\auth.json
问题4：如何创建自己的Skills？
非常简单：输入@skill-creater，然后清楚描述你想要的功能。举个例子：
OpenCode会根据你的描述自动生成对应的skill配置文件，整个过程非常智能。你只需告诉它想要什么，剩下的交给它就好！
接下来，你可以：
- 尝试创建自己的Skills，让AI帮你自动化更多工作
- 探索更多GitHub上的开源Skills，不断扩展你的工具库
