OpenCode 操作指导书六CLI 命令参考适用版本OpenCode v1.18.3本篇目标掌握 OpenCode 全部命令行接口便于脚本化、自动化与无界面headless使用。1. 启动 TUIopencode# 启动 TUI默认opencode /path/to/project# 直接打开某项目常用 TUI 启动参数参数简写说明--continue-c继续上一个会话--session-s继续指定会话 ID--fork继续时 fork 会话--prompt启动即使用的提示词--model-m指定模型provider/model--agent指定 Agent--port监听端口--hostname监听主机名2. 全局标志标志简写说明--help-h显示帮助--version-v打印版本号--print-logs将日志打印到 stderr--log-level日志级别DEBUG/INFO/WARN/ERROR3. 子命令一览runservewebagentauthmcpmodelssessionstatsexportimportupgradeuninstallgithubacp4. run —— 非交互执行直接传入提示词运行适合脚本/自动化opencode runExplain how closures work in JavaScript连接已运行的服务以避免 MCP 冷启动opencode serve# 终端 A启动无头服务opencode run--attachhttp://localhost:4096Explain async/await in JavaScript# 终端 B常用参数--continue/-c、--session/-s、--fork、--share、--model/-m、--agent、--file/-f、--format default|json、--title、--attach url、--port。5. serve / web / attach —— 服务与界面opencode serve# 无头 HTTP 服务API 访问无 TUIopencode web# 带 Web 界面的无头服务自动开浏览器opencode attach http://10.20.30.40:4096# 将 TUI 连接到远程后端设置OPENCODE_SERVER_PASSWORD启用 HTTP 基本认证用户名默认opencode。参数--port、--hostname、--mdnsmDNS 发现、--cors。6. agent —— Agent 管理opencode agent create# 交互式创建自定义 Agentopencode agent list# 列出所有 Agent7. auth —— 凭证管理opencode auth login# 交互式登录/配置提供方opencode auth list# 列出已认证提供方lsopencode authlogoutprovider# 注销某提供方凭证存储~/.local/share/opencode/auth.json。8. mcp —— MCP 服务管理opencode mcpadd# 添加 MCP 服务引导opencode mcp list# 列出及连接状态lsopencode mcp authname# OAuth 认证opencode mcp auth list# 列出支持 OAuth 的服务器lsopencode mcplogoutnameopencode mcp debugname# 调试 OAuth 连接9. models —— 模型查看opencode models# 列出所有已配置提供方的模型opencode models anthropic# 按提供方筛选opencode models--refresh# 从 models.dev 刷新缓存opencode models--verbose# 含成本等元数据10. session / stats —— 会话与统计opencode session list# 列出会话-n 限制数量--format table|jsonopencode stats# token 用量与费用opencode stats--days7# 最近 7 天opencode stats--models5# 显示前 5 个模型明细opencode stats--project# 仅当前项目11. export / import —— 会话导入导出opencodeexportsessionID# 导出会话为 JSON省略则交互选择opencodeimportsession.json# 从文件导入opencodeimporthttps://opncd.ai/s/abc123# 从分享链接导入12. github —— GitHub 自动化opencode githubinstall# 在仓库中安装 GitHub Agent引导opencode github run# 在 Actions 中运行--event / --token在 PR/Issue 评论中opencode或/oc即可触发详见第 07 篇。13. upgrade / uninstall —— 升级与卸载opencode upgrade# 升级到最新opencode upgrade v1.18.3# 升级到指定版本opencode uninstall# 卸载并删除相关文件# 参数--keep-config 保留配置 / --keep-data 保留数据 / --dry-run 仅预览 / --force 跳过确认14. acp —— Agent Client Protocolopencode acp# 启动 ACP 服务stdin/stdoutnd-JSON# 参数--cwd / --port / --hostname15. 环境变量速查变量作用OPENCODE_AUTO_SHARE自动分享会话OPENCODE_CONFIG配置文件路径OPENCODE_CONFIG_DIR配置目录OPENCODE_CONFIG_CONTENT内联 JSON 配置OPENCODE_DISABLE_AUTOUPDATE禁用自动更新检查OPENCODE_DISABLE_LSP_DOWNLOAD禁用自动 LSP 下载OPENCODE_ENABLE_EXA启用 Exa 网络搜索工具OPENCODE_SERVER_PASSWORDserve/web 基本认证OPENCODE_DISABLE_CLAUDE_CODE禁用读取.claude提示词技能完整命令在手进入07-实战案例.md把能力用起来。本篇为 OpenCode 操作指导书系列之一版本 v1.18.3。
