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

推荐使用 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 用户还可使用 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 将分析该文件内容并作出响应。