用途:把编码或问答任务交给 OpenCode 命令行二进制处理。从主机智能体调用时优先用 opencode run(无 TUI),只有在拥有真正的交互式 PTY 时才用 TUI。资料称已针对 opencode 1.18.x 验证,标志过时可用 opencode --help 复核。
安装与认证:Windows 推荐 winget install --id SST.opencode --accept-source-agreements --accept-package-agreements;安装后需在当前 shell 刷新 PATH,再用 where.exe opencode 与 opencode --version 确认。二进制通常位于 %LOCALAPPDATA%\Microsoft\WinGet\Packages\SST.opencode_*\opencode.exe。认证用 opencode providers login(别名 opencode auth login)或提供方环境变量。
主要能力:one-shot 调用示例为 opencode run --model opencode/big-pickle --dir <repo> "…";常用标志包括 -m/--model、--agent、--dir、-c/--continue、-s/--session、--auto、--format json、--thinking。opencode models 可列模型与成本、上下文、能力,免费托管 id 含 opencode/big-pickle。会话按项目目录区分,可用 opencode session list、opencode export、opencode stats 查看,也可用 opencode serve 起无头 HTTP 服务并以 opencode attach / opencode run --attach 连接。还支持 opencode mcp、opencode plugin、opencode debug skill/paths/config,并会自动加载 ~/.claude/skills/*/SKILL.md,可通过 skills.paths 指向克隆目录。
限制与注意:TUI 需要真实 PTY,无 TTY 的无头命令不适用;并行 opencode run 写入不要共用同一 --dir;--auto 会跳过权限确认,仅限可信任务;opencode serve 未设 OPENCODE_SERVER_PASSWORD 会提示不安全;修改配置后需重启(不热加载);PATH 在 winget 安装后可能失效;不要发明 terminal()/process() API。其余细节资料暂未提供。