要说最近AI圈子里什么最火，Skills绝对算一个。大家都在用它给AI加各种“buff”——自动写代码、一键做表格、批量处理数据，功能确实强大。
可不少人对着GitHub上五光十色的Skills项目干劲十足，真一到本地实操环节，不是卡在环境配置就是被各种依赖搞得焦头烂额。之前就有不少朋友在问OpenCode怎么玩，正好趁着Skills这波热度，来系统讲讲OpenCode从安装到使用的完整流程。
说穿了其实很简单，不管你喜欢图形界面还是命令行，这篇教程都能让你轻松上手。咱们这就开始，带你入门OpenCode玩转Skills。
目录
- ✅ 如何下载安装OpenCode
- ✅ 如何安装和配置Skills
- ✅ 环境变量的设置方法
- ✅ 常用指令和操作技巧
- ✅ 遇到问题如何解决
- ✅ 如何创建自己的Skills
一、下载安装，超级简单
下载地址：
https://opencode.ai/download
为了让大家在安装部署上少走弯路，直接推荐Windows桌面端方式，软件安装过程本身没任何门槛，一键下一步即可，这里不再赘述。安装完成后，安装目录下会有三个exe程序：
OpenCode.exe — 桌面端程序，带完整图形界面，整体风格很清爽
OpenCode-cli.exe — 经典命令行模式（TUI）
uninstall.exe — 卸载程序
二、安装Skills，体验更多功能
先来安装几个Skills感受一下，具体的配置和操作后面再细说。双击OpenCode-cli.exe打开界面，直接问它“我能使用什么skills？”
从截图可以看到，初始状态下是没有安装任何Skills的。没关系，现在就来添加一些。接下来，从Skills网站或GitHub上下载压缩包。
下面用官方的Skills做演示：
在软件安装目录下创建一个目录，命名为
.opencode——注意目录名是.开头的GitHub地址：https://github.com/anthropics/skills
下载完成后，用解压软件打开会看到以下内容（实际上不需要手动解压，OpenCode可以自动处理，这里只是为了便于演示）
把下载的skills复制到刚才创建的
.opencode目录里
回到OpenCode，输入/init并回车，这时就能看到OpenCode开始理解项目内容，加载这些Skills。
验证安装：再次问“我能使用什么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. 添加自己的模型API
输入/connect，这里提供了丰富的选择项。
4. 引用Skills
只要输入的内容中包含了Skills的触发条件，通常就能自动调用对应的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保存在哪里？
没有配置也能免费使用内置的大模型，但如果你要用自己的API key，输入/connect打开模型配置界面，选择对应的模型供应商。
举例来说，我用的是阿里的模型，直接把API key粘贴进去，回车确认就可以了。问题来了，这些填入的API key到底存在哪里？
默认保存在如下路径：
C:\Users\你的用户名\.local\share\opencode\auth.json
问题4：创建自己的Skills
只需输入@并选择skill-creater，然后清晰描述你想要的Skill功能就可以了。举个例子：
OpenCode会根据你的描述，自动生成对应的Skill配置文件。整个过程非常智能化——你只需要告诉它你想要什么，剩下的交给它就行。
接下来值得尝试的方向包括：
