跳到主要内容
极客日志极客日志面向AI+效率的开发者社区
首页博客我的书AI学习GitHub 精选镜像AI工具UI配色美学关于
搜索内容 / 工具 / 仓库 / 镜像...⌘K搜索
注册
博客列表
JavaScriptNode.jsAI

OpenCode 与大模型 Agent Skills 安装配置指南

OpenCode 是一款支持多模型的开源 AI 编程代理,可作为终端、IDE 扩展或桌面应用运行。详细记录了从获取 Agent Skills 资源到完成 OpenCode 环境搭建的全过程,涵盖多种系统下的安装方式、模型连接配置以及核心功能的使用技巧,帮助开发者快速集成 AI 能力辅助编码工作。

FrontendX发布于 2026/3/23更新于 2026/10/26105 浏览
OpenCode 与大模型 Agent Skills 安装配置指南

OpenCode 与 Agent Skills 安装配置指南

一、Skills 资源与配置

在使用 OpenCode 之前,我们需要了解如何获取和配置 Agent Skills。这些技能文件定义了 AI 代理可以执行的任务或工具。

1.1 常用资源源

社区提供了多个高质量的 Skills 仓库和市场,常见的包括:

  • Anthropic Skills: https://github.com/anthropics/skills
  • UI/UX Pro Max Skill: https://github.com/nextlevelbuilder/ui-ux-pro-max-skill
  • Awesome Claude Code: https://github.com/hesreallyhim/awesome-claude-code
  • Composio Skills: https://github.com/ComposioHQ/awesome-claude-skills
  • Agent Skills Market: skillsmp.com
  • Open Agent Skills Directory: skills.sh
  • ClawHub: clawhub.ai

1.2 配置方式

OpenCode 会在特定路径下搜索 SKILL.md 文件。为了灵活应用,支持项目本地和全局两种模式。

项目本地路径 将 Skill 绑定在代码仓库中,克隆后其他开发者即可直接使用。OpenCode 会从当前工作目录向上搜索至 Git 根目录,加载符合以下模式的文件:

  • .opencode/skill/<skill-name>/SKILL.md
  • .claude/skills/<skill-name>/SKILL.md

全局路径 存放通用且与具体项目无关的 Skill,对所有项目可见。通常位于用户主目录下:

  • ~/.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

1.3 安装方法

  • 手动下载:从市场下载 zip 包,拖入命令行执行安装命令,默认会安装到上述全局路径。
  • 命令行安装:复制 命令并在终端执行。
$ install --global <模块名>
  • OpenCode 内置安装:通过界面操作安装,完成后需重启 OpenCode 才能生效。
  • 二、OpenCode 安装

    OpenCode 是一个开源的 AI 编程代理,支持终端、桌面应用或 IDE 扩展。它具有模型无关性,可连接 Claude、GPT、Gemini 及本地模型。

    2.1 环境准备

    终端模拟器 推荐使用对图形渲染和文本样式支持较好的终端,如 WezTerm、Alacritty、Kitty 或 Ghostty。Windows 11 用户使用 PowerShell 时,建议先升级至最新版本以确保兼容性。

    API 密钥 OpenCode 需要通过 API 连接大语言模型(LLM)。初次使用可选择 OpenCode Zen 选项,这是经过筛选优化的模型组;也可自行配置 Anthropic、OpenAI 等服务商的 API Key。

    2.2 安装方式

    macOS 与 Linux

    一键脚本安装

    curl -fsSL https://opencode.ai/install | bash
    

    脚本会自动选择安装路径,优先级为环境变量 $OPENCODE_INSTALL_DIR > $XDG_BIN_DIR > $HOME/bin > $HOME/.opencode/bin。

    包管理器安装 若习惯使用 Homebrew,推荐官方维护的 tap 以获取最新版本:

    brew install anomalyco/tap/opencode
    

    或使用官方仓库配方(可能有延迟):

    brew install opencode
    

    Arch Linux 用户可通过 AUR 安装:

    paru -S opencode-bin
    
    Windows

    Chocolatey

    choco install opencode
    

    Scoop 需先添加 extras 存储桶:

    scoop bucket add extras
    scoop install extras/opencode
    

    Node.js 包管理器 如果已安装 Node.js,可使用 npm、pnpm 或 Bun 进行全局安装:

    npm install -g opencode-ai
    # 或
    pnpm install -g opencode-ai
    bun install -g opencode-ai
    
    验证安装

    在终端输入以下命令检查版本:

    opencode --version
    

    2.3 桌面应用

    除了终端版,OpenCode 还提供 Beta 阶段的桌面应用程序,适合偏好图形界面的用户。可从官网或 GitHub Releases 下载对应系统的安装包(macOS DMG, Windows EXE, Linux DEB/RPM/AppImage)。

    macOS 用户也可通过 Cask 安装:

    brew install --cask opencode-desktop
    

    三、配置与使用

    3.1 模型连接

    进入项目目录后启动 OpenCode:

    opencode
    

    在文本界面输入 /connect 选择 LLM 供应商。新用户建议选择 opencode (Zen) 并跟随提示完成授权登录。

    连接成功后,建议初始化项目:

    /init
    

    该命令会分析项目结构并生成 AGENTS.md 文件,存储上下文信息以便 AI 更好地理解需求。建议将此文件提交至 Git 仓库供团队同步。

    如需切换基座模型,可使用 /models 命令。

    3.2 核心功能

    OpenCode 内置两个核心代理,按 Tab 键可在它们之间切换:

    • build: 默认代理,拥有完整开发权限,可读写文件及执行命令。
    • plan: 只读代理,用于分析和规划任务,拒绝修改文件,适合探索未知代码库。

    交互时可使用 @ 符号引用项目文件,例如:

    How is authentication handled in @packages/functions/src/api/index.ts
    

    OpenCode 会读取指定文件内容并提供解释,极大提升了代码理解和修改的效率。

    至此,基础环境已搭建完毕,可根据实际需求进一步探索更多高级功能。

    目录

    1. OpenCode 与 Agent Skills 安装配置指南
    2. 一、Skills 资源与配置
    3. 1.1 常用资源源
    4. 1.2 配置方式
    5. 1.3 安装方法
    6. 二、OpenCode 安装
    7. 2.1 环境准备
    8. 2.2 安装方式
    9. macOS 与 Linux
    10. Windows
    11. 或
    12. 验证安装
    13. 2.3 桌面应用
    14. 三、配置与使用
    15. 3.1 模型连接
    16. 3.2 核心功能

    更多推荐文章

    查看全部
    • Web 自动化测试入门:Selenium 原理与实战
    • RAG 在大模型中的角色:高效文档切分与长上下文探讨
    • 滑动窗口算法实战:水果成篮与字母异位词查找
    • AI 扩展定律背后的神话与真相
    • 生成式 AI 核心问题解析:落地场景与实现路径
    • 2026 年 AI 写作辅助工具精选:5 款主流软件深度评测
    • 华为 OD 机试 C++ 题解:木材切割收益最大化
    • FAIR plus 机器人全产业链接会:聚焦具身智能与产业链协同
    • 基于 OpenClaw 与飞书集成构建 AI 新闻推送机器人
    • SpringBoot 4.0 新特性整合项目实战应用详解
    • Arduino BLDC 自主巡逻机器人(避障 + 路径规划)
    • 在 WSL2 Ubuntu 上部署 llama.cpp
    • AI Agent 开发入门:零基础学习指南
    • GitHub 教育优惠申请及 Copilot Pro 开通指南
    • Llama-2-7b 在昇腾 NPU 上的性能测评与部署方案
    • 降低 AIGC 检测率的实用技巧
    • Milvus 实战:Attu 可视化安装与 Python 整合指南
    • XXL-job注册模型与高可用架构解析
    • 基于 Python 搭建本地 AI 智能体 OpenClaw 入门教程
    • C++ PostgreSQL 连接库 libpqxx 完整安装与配置指南

    相关免费在线工具

    • RSA密钥对生成器

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

    • Mermaid 预览与可视化编辑

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

    • 随机西班牙地址生成器

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

    • Keycode 信息

      查找任何按下的键的javascript键代码、代码、位置和修饰符。 在线工具,Keycode 信息在线工具,online

    • Escape 与 Native 编解码

      JavaScript 字符串转义/反转义;Java 风格 \uXXXX(Native2Ascii)编码与解码。 在线工具,Escape 与 Native 编解码在线工具,online

    • JavaScript / HTML 格式化

      使用 Prettier 在浏览器内格式化 JavaScript 或 HTML 片段。 在线工具,JavaScript / HTML 格式化在线工具,online