跳到主要内容
极客日志极客日志面向AI+效率的开发者社区
首页博客GitHub 精选镜像工具UI配色美学隐私政策关于联系
搜索内容 / 工具 / 仓库 / 镜像...⌘K搜索
注册
博客列表
编程语言AI算法

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

综述由AI生成OpenCode 工具的使用方法,包括下载安装、Skills 安装配置、环境变量设置及常用指令。文章详细说明了如何通过命令行或图形界面启动 OpenCode,如何从 GitHub 获取并配置 Skills,以及如何使用/init、/connect 等斜杠命令进行项目初始化和模型连接。此外,还涵盖了常见问题解答,如操作指引、API 保存路径及自定义 Skills 的创建方法。

kaikai发布于 2026/4/5更新于 2026/5/2227 浏览
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 仓库。

  1. 在安装目录下创建 .opencode 目录(以点开头)。
  2. GitHub 地址:https://github.com/anthropics/skills
  3. 下载后解压查看内容(OpenCode 支持自动解压)。
  4. 将 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 将根据描述自动生成配置文件。

目录

  1. 一、下载安装
  2. 二、安装 Skills
  3. 验证安装
  4. 三、环境变量配置
  5. 1. 全局配置
  6. 2. 项目配置
  7. 四、常用指令
  8. 1. 切换模式
  9. 2. 选择模型
  10. 3. 添加自己的模型 API
  11. 4. 引用 Skills
  12. 5. 主要斜杠命令汇总
  13. 五、常见问题处理
  14. 问题 1:操作不熟悉如何处理?
  15. 问题 2:如何使用 Skills?
  16. 问题 3:模型 API 保存位置?
  17. 问题 4:创建自定义 Skills
  • 💰 8折买阿里云服务器限时8折了解详情
  • Magick API 一键接入全球大模型注册送1000万token查看
  • 🤖 一键搭建Deepseek满血版了解详情
  • 一键打造专属AI 智能体了解详情
极客日志微信公众号二维码

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

微信公众号「极客日志V2」,在微信中扫描左侧二维码关注。展示文案:极客日志V2 zeeklog

更多推荐文章

查看全部
  • 机器学习核心概念与术语详解
  • ChatGPT-4o 在数学建模、论文优化与代码生成中的应用实战
  • 前端代码分割与懒加载实战指南
  • 基于 LLaMA-Factory 与 LoRA 微调 GPT-OSS-20B 模型实战
  • 宇树 G1 机器人强化学习训练实战:环境配置与奖励函数
  • 自然语言处理在教育领域的应用与实战
  • 深入理解 SELinux:Linux 系统安全的核心门禁机制
  • Git 国内镜像源配置指南与跨平台工具开发
  • C++ Stack 与 Queue 核心用法:基础操作、场景与实战
  • 大模型产品经理转型指南
  • C++ 语言核心语法与实战入门指南
  • VS Code 中 GitHub Copilot 安装后无法使用?关键解决步骤
  • LangChain PyPDFLoader 实战:PDF 加载、分块与图片 OCR 提取
  • MySQL mysqldump 导入导出结构与数据及存储过程函数事件触发器
  • Python 日志记录最佳实践与高级配置指南
  • Docker 部署 MySQL 8.0 实战:从镜像拉取到远程访问配置
  • Linux 进程地址空间与虚拟内存机制解析
  • Whisper 语音识别 GPU 加速实战指南
  • 数据结构入门:算法复杂度详解
  • VS Code 配置 C/C++ 编程运行环境

相关免费在线工具

  • 加密/解密文本

    使用加密算法(如AES、TripleDES、Rabbit或RC4)加密和解密文本明文。 在线工具,加密/解密文本在线工具,online

  • RSA密钥对生成器

    生成新的随机RSA私钥和公钥pem证书。 在线工具,RSA密钥对生成器在线工具,online

  • Mermaid 预览与可视化编辑

    基于 Mermaid.js 实时预览流程图、时序图等图表,支持源码编辑与即时渲染。 在线工具,Mermaid 预览与可视化编辑在线工具,online

  • 随机西班牙地址生成器

    随机生成西班牙地址(支持马德里、加泰罗尼亚、安达卢西亚、瓦伦西亚筛选),支持数量快捷选择、显示全部与下载。 在线工具,随机西班牙地址生成器在线工具,online

  • Gemini 图片去水印

    基于开源反向 Alpha 混合算法去除 Gemini/Nano Banana 图片水印,支持批量处理与下载。 在线工具,Gemini 图片去水印在线工具,online

  • Base64 字符串编码/解码

    将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具,Base64 字符串编码/解码在线工具,online