OpenCode CLI · 常用命令

v1.18.52026-07-24MITGitHub

适用场景

查询 OpenCode 的 TUI 与非交互命令

面向读者

已安装 OpenCode CLI 的开发者

TL;DR

opencode 启动 TUI → opencode run 非交互 → --model 选择 provider/model

启动方式

命令

效果

opencode

进入 TUI 交互界面

opencode run "帮我检查当前改动"

非交互运行并输出结果

opencode run --model provider/model "总结仓库"

指定已配置的 provider/model

opencode --version

查看版本号

opencode --help

查看当前版本所有命令

当前官方 CLI 将非交互执行定义为 opencode run，脚本和 CI 应使用该子命令；旧的 -p / --print 旗标不在当前官方文档中，遇到旧教程时以 opencode --help 实际输出为准。

# 一次性执行
opencode run "用中文总结这个 PR 的改动"
 
# 指定已经配置的 provider 和模型
opencode run --model foropencode/gateway-model-id \
  "检查 src/ 下的潜在注入风险，只输出报告"

模型格式为 <provider>/<model-id>。foropencode 与 gateway-model-id 只是示例；第三方网关实际支持范围以其模型列表为准。

OpenCode 的 TUI 命令和快捷键会随版本变化。进入 TUI 后使用 /help 或官方 TUI 文档查看当前列表；/init 可用于创建项目说明，模型选择器用于切换已配置 provider。

默认模型写在 opencode.json / opencode.jsonc 的 model 字段中。临时选择可用 --model，但模型是否存在由当前 provider 决定；不要把 OpenAI/Anthropic 官方模型清单直接当成第三方网关清单。