OpenCode 完全指南：从安装到 Skill 配置，打造你的 AI 编程助手

一份详尽的图文教程，带你快速上手 OpenCode，并掌握 Skill 扩展能力。

一、OpenCode 简介与安装

OpenCode 是一款开箱即用的 AI 编程辅助工具，无需复杂配置即可享受智能代码生成与补全服务。本节将引导你完成从下载到首次运行的全过程。

1. 访问官网

打开 OpenCode 官方网站：
🔗 https://opencode.ai/zh

2. 全局安装

在终端中执行以下命令，通过 npm 将 OpenCode 安装到全局环境：

npm i -g opencode-ai

3. 启动交互界面

安装完成后，直接输入以下命令即可进入 OpenCode 对话环境：

opencode

4. 模型选择策略

在 OpenCode 内部，使用命令 /models 可以查看并切换当前使用的 AI 模型。

/models

当前提供的模型分为两类：

🆓 免费模型（无需 API Key）

• Big Pickle：默认推荐，免费且无使用限制，代码生成与补全效果最佳，适合新手入门。
• Ling 2.6 Flash Free
• MiniMax M2.5 Free
• Nemotron 3 Super Free

💎 付费 / 自定义模型（需配置密钥）

• OpenCode Zen：官方订阅模型，具备更强的长上下文处理与工程级代码能力。
• OpenAI / GitHub Copilot / Anthropic / Google 系列：需自行前往对应平台申请 API 密钥。

5. 开启第一次对话

选定模型后，直接在输入框中键入你的需求，即可与 AI 开始协作。

二、深入 OpenCode Skill：能力扩展核心指南

Skill 是 OpenCode 的高级功能模块，允许用户为 AI 加载特定领域的知识、脚本或资源，从而定制化其行为。以下将介绍 Skill 的资源来源与标准目录结构。

1. 官方与社区资源推荐

• 官方基础仓库（Anthropic 官方维护）
  包含最稳定的通用工具调用模板与任务处理 Skill。
  🔗 https://github.com/anthropics/skills

  

• 中文社区聚合平台
  收录了大量适配中文场景的本土化 Skill 与实用技巧。
  🔗 https://skillsmp.com/zh

  

2. Skill 目录结构规范

为了让 OpenCode 正确识别和加载 Skill，必须遵循以下目录层级。

项目级 Skill（仅对当前项目生效）

你的项目根目录/
└── .opencode/
    └── skills/
        ├── 你的Skill名称/
        │   ├── SKILL.md        # 核心定义文件（必选）
        │   ├── references/     # 参考资料目录（可选）
        │   ├── scripts/        # 可执行脚本目录（可选）
        │   └── assets/         # 静态资源目录（可选）
        └── 另一个Skill/
            └── SKILL.md

全局 / 用户级 Skill（对所有项目生效）
安装 Skill 时，只需将完整的 Skill 文件夹复制到对应系统的全局目录即可。

• macOS 路径

  ~/.config/opencode/skills
  

• Windows 路径

  C:\Users\你的用户名\.config\opencode\skills
  

---

三、Windows 平台实战：全局 Skill 配置演示

以下步骤将演示如何在 Windows 系统中配置一个全局可用的 Skill，并验证其效果。

1. 创建全局 Skill 根目录

在文件资源管理器中导航至用户目录，手动创建 .config\opencode\skills 文件夹结构（若尚不存在）。

C:\Users\你的用户名\.config\opencode\skills

2. 放置 Skill 文件夹

将从官方仓库或社区下载的 Skill 文件夹（例如 skill-creator）完整复制到上述目录中。

3. 验证 Skill 加载状态

重新启动 OpenCode（或在其内部刷新），输入命令查看当前已识别的 Skill 列表：

skill list

若列表中出现刚刚添加的 Skill 名称，则说明配置成功

4. 触发 Skill 智能匹配

当你的提问内容与某个 Skill 的功能描述匹配时，OpenCode 会自动调用该 Skill 来增强回答质量。

5. 最终效果展示

启用相应 Skill 后，AI 的回答将包含更专业的结构化内容，甚至能够直接生成可执行代码或文件。

结语

通过本文的指引，你已经完成了 OpenCode 的基础安装，并掌握了 Skill 扩展机制的配置方法。接下来，你可以在官方仓库或中文社区中探索更多实用的 Skill，让你的 AI 编程助手真正技能满点。