OpenCode 使用指南：AI Skills 安装与配置教程

注意： 在输入 /init 前，需按 Tab 键将 plan 切换为 build 模式。

再次询问 "我能使用什么 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 命令，列出并切换可用的 AI 模型。

3. 添加自己的模型 API

使用 /connect 命令，支持多种 LLM 提供商配置。

4. 引用 Skills

输入内容包含触发条件时自动调用，或通过 @ 指定所需 Skills，上下方向键选择，回车确认。

5. 常用命令汇总

五、常见问题与技巧

Q: 如何使用 OpenCode 操作？

向 AI 助手提问即可。默认模型通常满足需求。若需创建项目级配置，进入指定项目目录打开 OpenCode，执行 /init 生成基于该项目的配置。系统支持全局偏好与项目定制。

Q: 如何使用 Skills？

向 AI 提问：@你需要了解的 SKILLS，后面加上"这个 skills 如何使用？"

Q: 模型 API 存储位置？

若使用自有模型，通过 /connect 配置。API Key 默认保存在如下路径：

C:\Users\你的用户名\.local\share\opencode\auth.json

Q: 如何创建自定义 Skills？

调用 skill-creater，清晰描述功能需求。AI 将根据描述自动生成对应的 Skill 配置文件。

用户可尝试创建自己的 Skills 以自动化更多工作，或探索 GitHub 上的开源 Skills 扩展工具箱。