OpenCode 使用指南：AI Skills 安装与配置
AI Skills 近期备受关注，相比 Claude Code，OpenCode 在国内环境更便捷。本文将介绍 OpenCode 的安装、Skills 配置及常用指令。
一、下载安装
下载地址： https://opencode.ai/download
推荐使用 Windows 桌面端方式，软件安装简便。
安装完成后，目录下包含以下程序：
- uninstall.exe — 卸载程序
- OpenCode-cli.exe — 命令行模式（TUI）
- OpenCode.exe — 桌面端图形界面程序
二、安装和配置 Skills
双击 OpenCode-cli.exe 打开界面，输入 "我能使用什么 skills" 查看当前状态。
若没有 Skills，可从官网或 GitHub 下载压缩包。
- 在软件安装目录下创建
.opencode目录（注意以点开头）。 - GitHub 地址：https://github.com/anthropics/skills
- 将下载的 Skills 文件复制到
.opencode目录内。 - 回到 OpenCode，输入
/init回车，系统将加载这些 Skills。
提示： 输入
/init前需按 Tab 键切换至 Build 模式。
验证安装后再次询问 "我能使用什么 skills"，系统即可识别可用 Skills。
桌面端 OpenCode.exe 操作逻辑一致。
三、环境变量配置
OpenCode 支持默认配置及多种加载方式，主要涉及全局和项目配置。
1. 全局配置
路径示例：~/.config/opencode/opencode.json
Windows 路径：C:\Users\你的用户名\.config\opencode
2. 项目配置
位于项目根目录的 opencode.json。
四、常用指令和操作技巧
1. 切换模式
OpenCode 有两种模式：plan 和 build，使用 Tab 键切换。
2. 选择模型
使用 /models 列出并切换可用 AI 模型。
3. 添加自己的模型 API
使用 /connect 连接模型供应商（如 Anthropic、OpenAI 等），粘贴 API Key 即可。
4. 引用 Skills
输入内容包含触发条件时通常可自动调用，也可通过 @ 指定需要的 Skills，支持方向键选择确认。
5. 主要斜杠命令汇总
| 命令类别 | 命令 | 功能说明 |
|---|---|---|
| 连接与设置 | /connect | 新增 LLM 提供商 |
| /models | 列出并切换可用的 AI 模型 | |
| /themes | 切换终端界面的主题 | |
| /help | 显示帮助对话框 | |
| 对话管理 | /new | 开始一个新的对话 |
| /sessions | 列出所有历史对话并切换 | |
| /compact | 压缩当前对话内容 | |
| /export | 将会话记录导出到文件 | |
| /share | 生成当前对话的分享链接 | |
| 编辑与撤销 | /undo | 撤销上一条 AI 消息及其带来的所有文件更改 |
| /redo | 重做已撤销的更改 | |
| /editor | 打开外部编辑器 | |
| 项目与代理 | /init | 初始化项目，扫描并生成 AGENTS.md 文件 |
| /agents | 切换或管理 AI 代理（如 Plan/Build 模式） | |
| /review | 审查未提交的代码更改 | |
| /mcp | 管理模型上下文协议 | |
| 其他 | /exit | 退出 OpenCode 应用程序 |
五、常见问题解答
Q: 操作不熟悉怎么办？ A: 直接询问默认模型即可获取指导。
Q: 如何使用 Skills？ A: 可通过 @ 指定或询问具体用法。
Q: 模型 API 存储位置？
A: 默认保存在用户目录下的 auth.json 文件中。
Windows 路径示例：C:\Users\你的用户名\.local\share\opencode\auth.json
Q: 如何创建自定义 Skills？ A: @skill-creater 并描述需求，系统将自动生成配置文件。
项目级配置需进入目录执行 /init 生成，实现全局偏好与项目定制的分层管理。
