OpenCode 完全指南从安装到 Skill 配置打造你的 AI 编程助手一份详尽的图文教程带你快速上手 OpenCode并掌握 Skill 扩展能力。一、OpenCode 简介与安装OpenCode 是一款开箱即用的 AI 编程辅助工具无需复杂配置即可享受智能代码生成与补全服务。本节将引导你完成从下载到首次运行的全过程。1. 访问官网打开 OpenCode 官方网站 https://opencode.ai/zh2. 全局安装在终端中执行以下命令通过 npm 将 OpenCode 安装到全局环境npmi-gopencode-ai3. 启动交互界面安装完成后直接输入以下命令即可进入 OpenCode 对话环境opencode4. 模型选择策略在 OpenCode 内部使用命令/models可以查看并切换当前使用的 AI 模型。/models当前提供的模型分为两类 免费模型无需 API KeyBig Pickle默认推荐免费且无使用限制代码生成与补全效果最佳适合新手入门。Ling 2.6 Flash FreeMiniMax M2.5 FreeNemotron 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/zh2. Skill 目录结构规范为了让 OpenCode 正确识别和加载 Skill必须遵循以下目录层级。项目级 Skill仅对当前项目生效你的项目根目录/ └── .opencode/ └── skills/ ├── 你的Skill名称/ │ ├── SKILL.md # 核心定义文件必选 │ ├── references/ # 参考资料目录可选 │ ├── scripts/ # 可执行脚本目录可选 │ └── assets/ # 静态资源目录可选 └── 另一个Skill/ └── SKILL.md全局 / 用户级 Skill对所有项目生效安装 Skill 时只需将完整的 Skill 文件夹复制到对应系统的全局目录即可。macOS 路径~/.config/opencode/skillsWindows 路径C:\Users\你的用户名\.config\opencode\skills三、Windows 平台实战全局 Skill 配置演示以下步骤将演示如何在 Windows 系统中配置一个全局可用的 Skill并验证其效果。1. 创建全局 Skill 根目录在文件资源管理器中导航至用户目录手动创建 .config\opencode\skills 文件夹结构若尚不存在。C:\Users\你的用户名\.config\opencode\skills2. 放置 Skill 文件夹将从官方仓库或社区下载的 Skill 文件夹例如 skill-creator完整复制到上述目录中。3. 验证 Skill 加载状态重新启动 OpenCode或在其内部刷新输入命令查看当前已识别的 Skill 列表skill list若列表中出现刚刚添加的 Skill 名称则说明配置成功4. 触发 Skill 智能匹配当你的提问内容与某个 Skill 的功能描述匹配时OpenCode 会自动调用该 Skill 来增强回答质量。5. 最终效果展示启用相应 Skill 后AI 的回答将包含更专业的结构化内容甚至能够直接生成可执行代码或文件。结语通过本文的指引你已经完成了 OpenCode 的基础安装并掌握了 Skill 扩展机制的配置方法。接下来你可以在官方仓库或中文社区中探索更多实用的 Skill让你的 AI 编程助手真正技能满点。
