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,支持方向键选择确认。

