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

近期，AI Skills 在开发者社区中备受关注。

大家都在用它给 AI 加各种功能，让它自动写代码、做表格等。但在本地环境部署时，Claude Code 存在诸多不便。本文将介绍 OpenCode 的安装部署及使用方法，涵盖图形界面与命令行两种模式。

一、下载安装

下载地址：

https://opencode.ai/download

推荐使用 Windows 桌面端，安装流程简洁。安装完成后，目录下会有 3 个 exe 程序：

uninstall.exe — 卸载程序
OpenCode-cli.exe — 命令行模式（TUI）
OpenCode.exe — 桌面端程序，提供图形化界面

二、安装 Skills

运行 OpenCode-cli.exe，输入'我能使用什么 skills？'查看当前可用技能。

提示：若未配置自定义模型，显示的默认模型可能与实际环境不同，后续将介绍模型 API 配置。

从官方渠道下载 Skills 压缩包或克隆 GitHub 仓库。

在安装目录下创建 .opencode 目录（以点开头）。
GitHub 地址：https://github.com/anthropics/skills
下载后解压查看内容（OpenCode 支持自动解压）。
将 skills 文件复制到 .opencode 目录。

在 OpenCode 中输入 /init 并回车，系统将扫描并加载 Skills。

注意： 在输入 /init 前，需要按一下键盘的 Tab 键，目的是把 plan 切换为 build 模式。

验证安装

再次询问'我能使用什么 skills？'确认加载结果。

OpenCode.exe 操作方式类似。

三、环境变量配置

OpenCode 支持默认配置及多种加载方式，主要包括以下两种：

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，通过方向键选择并回车确认。

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 并执行 /init，可生成基于该项目的配置。该系统支持全局个人偏好与项目级配置的分离。

问题 2：如何使用 Skills？

询问：@技能名称如何使用？

问题 3：模型 API 保存位置？

可使用免费模型，或自行配置模型供应商。例如配置阿里云模型，粘贴 API Key 后回车。

默认保存路径：

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

问题 4：创建自定义 Skills

使用 @skill-creater 并提供功能描述。

OpenCode 将根据描述自动生成配置文件。

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

一、下载安装

二、安装 Skills

验证安装

三、环境变量配置

1. 全局配置

2. 项目配置

四、常用指令

1. 切换模式

2. 选择模型

3. 添加自己的模型 API

4. 引用 Skills

5. 主要斜杠命令汇总

五、常见问题处理

问题 1：操作不熟悉如何处理？

问题 2：如何使用 Skills？

问题 3：模型 API 保存位置？

问题 4：创建自定义 Skills

更多推荐文章

相关免费在线工具

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

一、下载安装

二、安装 Skills

验证安装

三、环境变量配置

1. 全局配置

2. 项目配置

四、常用指令

1. 切换模式

2. 选择模型

3. 添加自己的模型 API

4. 引用 Skills

5. 主要斜杠命令汇总

五、常见问题处理

问题 1：操作不熟悉如何处理？

问题 2：如何使用 Skills？

问题 3：模型 API 保存位置？

问题 4：创建自定义 Skills

微信扫一扫，关注极客日志

更多推荐文章

相关免费在线工具