一、Skills 下载源
常用的 GitHub 仓库:
- https://github.com/anthropics/skills
- https://github.com/nextlevelbuilder/ui-ux-pro-max-skill
- https://github.com/hesreallyhim/awesome-claude-code
- https://github.com/ComposioHQ/awesome-claude-skills
Agent Skills 市场:
Agent Skills 市场 - Claude、Codex 和 ChatGPT Skills | SkillsMP
Open Agent Skills 生态:
ClawHub:
二、Skills 配置
2.1 手动下载存放
OpenCode 会在特定路径下搜索 SKILL.md 文件。这些路径分为项目本地和全局两种。
- 项目本地路径:
.opencode/skill/<skill-name>/SKILL.md或.claude/skills/<skill-name>/SKILL.md - 全局路径:
~/.config/opencode/skill/<skill-name>/SKILL.md、~/.claude/skills/<skill-name>/SKILL.md、~/.agents/skills/<skill-name>/SKILL.md
Windows 下全局路径示例:C:\Users\用户名\.config\opencode\skills
2.2 下载安装
Agent Skills 市场支持直接下载 skill zip 包,拖拽至命令行窗口即可自动安装,默认安装到全局路径。
2.3 命令行安装
复制 $ install --global 模块的命令,在命令行中执行即可。
2.4 直接通过 OpenCode 安装
安装完成后需重启 OpenCode,使 Skill 生效。
三、OpenCode 安装
OpenCode 是一个开源的 AI 编程代理,支持多种 AI 模型如 Claude、GPT、Gemini 等,并具有开放性和灵活性。
3.1 准备工作
3.1.1 终端模拟器
推荐使用 WezTerm、Alacritty、Kitty、Ghostty 等终端。Windows 11 中 PowerShell 升级后也可正常使用。
3.1.2 AI 模型 API 密钥
首次使用可选择 OpenCode Zen 提供的预设模型,或自行配置 Anthropic、OpenAI 等服务商的 API 密钥。
3.2 OpenCode 安装方式
3.2.1 快速安装
适用于 macOS 和 Linux 用户:
curl -fsSL https://opencode.ai/install | bash
安装路径优先级依次为:$OPENCODE_INSTALL_DIR → $XDG_BIN_DIR → $HOME/bin → $HOME/.opencode/bin
3.2.2 使用包管理器安装
macOS/Linux:
使用 Homebrew(推荐):
brew install anomalyco/tap/opencode
或使用官方仓库(可能存在延迟):
brew install opencode
Arch Linux 用户可通过 Paru 安装:
paru -S opencode-bin
Windows:
使用 Chocolatey:
choco install opencode
使用 Scoop:
scoop bucket add extras
scoop install extras/opencode
跨平台 Node.js 包管理器
使用 npm(注意 PowerShell 版本):
npm install -g opencode-ai
使用 pnpm:
pnpm install -g opencode-ai
使用 Bun:
bun install -g opencode-ai
3.2.3 检查是否安装成功
在终端中输入以下命令验证安装:
opencode --version
3.3 桌面应用安装与使用
OpenCode 提供 Beta 版桌面应用,可从官网或 GitHub Releases 页面下载对应系统的安装包。
| 平台 | 下载文件 |
|---|---|
| macOS (Apple Silicon) | opencode-desktop-darwin-aarch64.dmg |
| macOS (Intel) | opencode-desktop-darwin-x64.dmg |
| Windows | opencode-desktop-windows-x64.exe |
| Linux | .deb, .rpm, 或 AppImage |
macOS 用户还可使用 Homebrew Cask 安装:
brew install --cask opencode-desktop
Windows 系统下建议直接使用命令行操作更便捷。
四、OpenCode 配置
4.1 大模型配置
进入项目目录后,启动 OpenCode:
opencode
输入 /connect 命令选择 LLM 供应商。新用户可选择 opencode(Zen)快速开始。
连接成功后,使用 /init 初始化项目,生成 AGENTS.md 文件记录项目上下文信息。
输入 /models 可切换使用的基座模型。
4.2 基本用法
OpenCode 内置两个核心代理:
- build:默认代理,具备完整开发权限,可读写文件及执行命令。
- plan:只读代理,适合分析代码和规划任务,不会修改文件。
可通过 Tab 键在两者间切换。
例如,使用 @ 符号引用文件进行提问:
How is authentication handled in @packages/functions/src/api/index.ts
OpenCode 将分析该文件内容并作出响应。


