OpenCode CLI · 常用命令
v1.17.8GitHub
适用场景
快速查启动参数、slash 命令、切换供应商与模型、自动化脚本写法
面向读者
已装好 OpenCode CLI，想熟悉日常用法的开发者
TL;DR
opencode 启动 TUI → /help 查命令 → -p 非交互脚本 → OPENCODE_MODEL 临时换模型
启动方式
命令
效果
opencode进入 TUI 交互界面（最常用）
opencode -p "帮我写一个 README"非交互模式，结果输出到 stdout，适合脚本
opencode --version查看版本号
opencode --help查看所有参数
常用启动参数
命令
说明
-p / --print <prompt>非交互模式，把结果输出到 stdout
-m / --model <id>指定本次会话模型，格式 provider/model-id
--help查看所有参数
--version查看版本号
会话内 Slash 命令
进入 TUI 后，以 / 开头输入以下命令：
Slash 命令
说明
/help查看所有可用命令
/init在当前目录生成 AGENTS.md 上下文文件
/model切换供应商与模型（无需重启）
/theme切换 TUI 主题
/clear清空当前对话，重新开始
/compact压缩历史上下文，节省 Token
/share生成可分享的对话链接
临时切换模型
# 启动时指定（优先级高于 opencode.json）
opencode -m fc-claude/claude-opus-4-7
# 或用环境变量（会话级别生效）
OPENCODE_MODEL="fc-claude/claude-opus-4-7" opencodemodel 格式必须是 <provider名>/<model-id>，provider 名对应 opencode.json 里 provider 的 key。
常见模型示例：
模型 ID（示例）
特点
fc-claude/claude-sonnet-4-6均衡推荐，速度与质量均衡
fc-claude/claude-opus-4-7最强，适合复杂推理
fc-gpt/gpt-5.5OpenAI 最新通用模型
local/qwen2.5-coder:32bOllama 本地推理，完全离线
非交互模式（脚本场景）
# 一次性执行，输出到终端
opencode -p "用中文总结一下这个 PR 的改动"
# 配合管道
opencode -p "生成 .gitignore for Node.js 项目" > .gitignore
# 临时换模型 + 非交互
OPENCODE_MODEL="fc-claude/claude-haiku-4-5" opencode -p "列出 src/ 下所有函数名"环境变量速查
环境变量
作用
OPENCODE_MODEL覆盖 opencode.json 里的 model 字段，临时指定模型
OPENCODE_CONFIG指定单个配置文件路径（绝对路径）
OPENCODE_CONFIG_DIR指定整个配置目录，隔离不同项目或用户
OPENCODE_CONFIG_CONTENT直接把 JSONC 内容塞进环境变量，适合 CI 注入配置
AGENTS.md（上下文文件）
OpenCode 读取项目根目录的 AGENTS.md 作为持久上下文，类似 Claude Code 的 CLAUDE.md：
# 在 TUI 里输入，自动生成 AGENTS.md
/init生成后建议 git commit，团队共用一份上下文。子目录的 AGENTS.md 支持嵌套覆盖。