用途:本技能用于配置和使用 OpenCode CLI 的无头(headless,非交互)模式,通过子进程调用实现 LLM 自动化。
主要能力:OpenCode 是基于 Go 的 CLI,通过统一接口接入 75+ 个 LLM 提供商。核心命令格式为 opencode run --model <provider/model> "<prompt>",其中 run 子命令用于无头模式,模型格式固定为 provider/model,prompt 作为末尾的位置参数传入。支持 Anthropic、Google、OpenAI、Google Vertex、opencode 免费层等提供商,例如 opencode run --model anthropic/claude-sonnet-4-20250514 "Explain this code"。
使用方式:先安装并配置环境变量(如 ANTHROPIC_API_KEY 或 GOOGLE_CLOUD_PROJECT),再用 opencode --version 验证安装,用简单 prompt 测试连通。配置文件可通过 OPENCODE_CONFIG 指定,也可使用项目根目录的 opencode.json 或全局 ~/.config/opencode/opencode.json,项目配置覆盖全局配置。凭据在 TUI 模式运行 /connect 后存于 ~/.local/share/opencode/auth.json,或通过环境变量配置。
适用场景:脚本化、自动化的 LLM 调用,子进程集成(如 Python subprocess 调用)。
限制:不支持 stdin 输入;无 Claude CLI 的 hooks/settings、--add-dir 目录访问、--allowedTools 预授权工具等特性;并行调用需间隔 5-10 秒以避免缓存竞争;需自行实现重试、超时与健康检查。