OpenCode

OpenCode 使用与本机配置手册。通用部分以官方文档和实际 JSON Schema 为准；本机审计基于当前电脑配置和命令输出。

建议阅读顺序

1. 进阶使用手册 — 配置、Agent、Skill、Command、Plugin、MCP 和权限的整体框架。
2. 本机配置审计 — 当前版本、Provider、Agent、Skill、Command、MCP 和安全问题。
3. gh-sdd 工作流整理 — 本机 48 个 gh-sdd-* Command 和 3 个专用 Subagent 的使用建议。
4. 启动与鉴权排障 — 命令找不到、401、--dir 三类故障的排查与修复。

当前环境快照

OpenCode：1.18.29
全局配置：C:\Users\GhostCloud\.config\opencode\opencode.json
默认模型：ghostcloud-glm/xopdeepseekv4flash
默认 Agent：build
Plugin：opencode-usage-tracker、ai-asset-skill-sync
MCP：exa-websearch、devopsmcp（均已连接）
用户级 Agent：3 个
用户级 Command：48 个
用户级 Skill：1 个

快速选择

需求	使用方式
普通编码任务	build
只做方案、禁止修改业务代码	plan
代码库探索	explore Subagent
固定入口和参数模板	Command
可复用领域 SOP	Skill
外部业务能力	MCP
修改事件、工具、权限或路由	Plugin

官方资料

• OpenCode 官方文档
• Configuration
• Agents
• Skills
• MCP Servers
• Permissions
• 配置 JSON Schema