OpenCode 终端安装
安装 OpenCode CLI、接入模型，并用 Skills 扩展终端里的 AI 开发工作流。
概述
OpenCode 是开源的终端 AI 编程工具，可对接多种 LLM，并通过 Agent Skills（SKILL.md）按需加载领域能力。适合习惯 CLI、希望可定制 Agent 的开发者。
前置条件
- 可用的终端环境（macOS / Linux / Windows）
- 至少一个 LLM 后端（云端 API Key 或本地模型端点）
- 建议安装 Node.js（若使用
npx skills等社区 CLI）
安装与获取
- 打开 opencode.ai 按官方一键脚本或发行说明安装
- 确认命令可用，例如：
opencode --version
具体包名与脚本以官网当前文档为准。
首次配置
- 配置 API Key 或本地模型地址（按官方配置文件 / 交互向导）
- 在项目根执行初始化（若文档提供
opencode init或等价命令） - 用一次简单对话验证连通：
opencode chat
- 需要可复用流程时，准备 Skills 目录（见下节）
核心用法
- 对话改代码：在仓库根启动会话，描述任务并让 Agent 编辑文件
- Skills：每个 skill 是一个目录 +
SKILL.md（YAML frontmatter 含name/description） - 常见放置位置（以官方为准，兼容 Claude 约定）：
- 项目：
.opencode/skills/<name>/SKILL.md或.claude/skills/<name>/SKILL.md - 全局：
~/.config/opencode/skills/等
社区常用安装方式示例：
npx skills add https://github.com/anthropics/skills --skill frontend-design
更多见 OpenCode Skills 与 OpenCode School · Skills。
开发实践
- 仓库内写清构建/测试命令，让 Agent 改完自跑验证
- Skill 的
description写具体，方便 Agent 判断何时加载 - 跨工具复用：同一
SKILL.md可被 Claude Code / Cursor 等按目录约定加载 - 小步提交；密钥只放环境变量，不写进 skill 正文
- 复杂发布/迁移流程做成 skill，而不是塞进每次会话的冗长系统说明
常见问题
- 连不上模型：检查 Key、代理与 endpoint URL
- Skill 未加载：确认目录名与 frontmatter
name一致，并重启会话 - 权限过宽：在
opencode.json（或官方等价配置）中限制 skill / 工具权限