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

二、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 会读取指定文件内容并提供解释，极大提升了代码理解和修改的效率。

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