⚡ OpenCode 命令手册OpenCode V2 全量 CLI 命令 TUI 快捷操作速查一份可以收藏、转发、贴进团队 Wiki 的 OpenCode 命令大全 基于opencode v2.0.27实机整理 · 最后更新2026-10-14本文适合谁刚接触 OpenCode 想快速上手的新用户以及想随时查阅命令字典的老用户。文中所有命令均在v2.0.27实机验证。 目录 快速开始 常用命令 Top 15 全局用法与通用参数 命令总览 完整命令参考run · mini · session · auth · models · mcp · plugin · stats · serve · pair · service · reload · api · acp · debug · upgrade · uninstall⌨️ TUI 内快捷操作 实用技巧 故障排查 相关链接 快速开始# 1️⃣ 在项目目录中启动完整终端界面TUIcd~/code/my-project opencode# 2️⃣ 直接提问不进入交互界面适合脚本 / CIopencode run解释这个仓库的目录结构# 3️⃣ 查看后台服务状态opencodeservicestatus OpenCode 采用客户端-服务端架构TUI 会自动发现或启动一个共享后台服务开发机上的所有 OpenCode 客户端都连接它。 常用命令 Top 15命令说明opencode在当前目录启动全屏 TUIopencode 目录在指定目录启动 TUIopencode run …单次提问并直接输出结果opencode run -c …继续上一次会话提问opencode run -m anthropic/claude-sonnet-4-5 …指定模型提问opencode mini启动极简交互界面opencode session list列出当前项目的会话opencode auth login登录 AI 服务商opencode models列出所有可用模型opencode mcp add …添加 MCP 服务器opencode stats查看用量 / 成本统计opencode serve启动 API 与 Web 服务器opencode pair生成一次性配对链接手机 / 浏览器接入opencode reload不重启服务热重载配置opencode upgrade升级到最新版本 全局用法与通用参数opencode subcommand [flags] [directory]启动 TUI 时的参数opencode# 在当前目录启动opencode ~/code/my-project# 指定目录启动opencode--continue# 继续上一次会话opencode--sessionses_xxxxx# 继续指定会话不存在则创建opencode--prompt总结本项目# 启动时自动带上提示词opencode--standalone# 使用私有服务而非共享后台服务opencode--serverhttp://localhost:4096# 连接指定服务地址opencode--auto# 自动批准未被显式拒绝的权限 ⚠️ 谨慎使用全局参数所有命令均可用参数简写说明--help-h显示帮助信息--version-v显示版本信息--wizard以向导模式启动命令--completions shell输出补全脚本bash/zsh/fish/sh--log-level level日志级别all/trace/debug/info/warn/warning/error/fatal/none--print-logs将日志输出到 stderr服务端日志需搭配--standalone服务相关通用参数许多与服务器交互的命令都支持参数说明--standalone本次运行使用私有服务不依赖共享后台服务--server url连接指定 URL 的服务 命令总览命令说明子命令opencode启动全屏终端界面TUI—run发送一条消息并打印回复非交互—mini启动极简交互界面—session管理会话listdeleteexportimportauth管理服务商与凭据listloginlogoutexportimportswitchmodels列出所有可用模型—mcp管理 MCP 服务器listaddauthlogoutplugin管理插件listaddcheckupdateremovestats查看可分享的用量统计—serve启动 v2 API 与 Web 服务器—pair打印一次性配对链接含二维码—service管理后台服务startrestartstatusstopgetsetunsetreload热重载配置—api向运行中的服务发起请求—acp启动 Agent Client Protocol 服务编辑器集成—debug调试与排障工具agentsconfigpathsupgrade/update升级 OpenCode—uninstall卸载 OpenCode保留会话与配置— 完整命令参考opencode run— 单次运行发送一条消息并打印回复不打开全屏界面。专为脚本、CI 等自动化场景设计。opencode run解释这个仓库opencode run--modelanthropic/claude-sonnet-4-5重构 parseTokenopencode run--continue接着处理过期的情况opencode run--formatjson列出所有 TODO 注释opencode run--filesrc/server.ts--filesrc/client.ts检查这些文件是否有 bugopencode run--agentbuild修复失败的测试参数简写说明[message...]要发送的消息可选--model provider/model#variant-m指定模型格式provider/model#variant--agent name指定 Agent--continue-c继续上一次会话--session id-s继续指定会话不存在则创建--fork继续前先派生fork会话--format default|json输出格式json为逐行 JSON便于脚本消费--file path-f附加文件到消息可重复传入--title text设置会话标题--thinking显示思考过程--auto自动批准未被显式拒绝的权限 ⚠️--standalone使用私有服务--server url连接指定服务地址 CI 示例GitHub Actionsname:OpenCode reviewon:[pull_request]jobs:review:runs-on:ubuntu-lateststeps:-uses:actions/checkoutv4-run:npm install--global opencode/cli-run:opencode run--standalone--model anthropic/claude-sonnet-4-5 Review this repository for correctness and summarize any issues.env:ANTHROPIC_API_KEY:${{secrets.ANTHROPIC_API_KEY}}opencode mini— 极简交互界面比全屏 TUI 更轻量的最小交互模式。opencode mini opencode mini--continueopencode mini--modelanthropic/claude-sonnet-4-5--prompt总结这个仓库参数简写说明--continue-c继续上一次会话--session id-s继续指定会话不存在则创建--fork继续时派生会话--replay恢复时重放历史可用--no-replay禁用--replay-limit n仅重放最新 N 条消息默认 200--model provider/model-m指定模型--agent name指定 Agent--prompt text启动时的初始提示词--standalone/--server url服务连接方式opencode session— 会话管理子命令说明session list列出当前项目的顶层会话最新在前session delete id删除会话及其子会话session export [id]将会话导出为 JSONsession import file从 JSON 文件或 URL 导入会话# 列出会话限制 20 条并输出 JSONopencode session list --max-count20--formatjson# 删除会话含其子会话opencode session delete ses_9c1b08# 导出会话为 JSONopencode sessionexportses_4f2a1c# 导出时脱敏隐去敏感对话与文件内容opencode sessionexportses_4f2a1c--sanitize# 导入会话 JSONopencode sessionimportsession.json# 导入到指定目录opencode sessionimportsession.json--directory~/code/projectsession list参数--max-count, -n N默认 100、--format table\|json。opencode auth— 服务商与凭据管理子命令说明auth list列出集成与凭据支持--format jsonauth login [target]连接 / 登录一个集成auth logout [target] [credential]退出已保存的账号auth export [target]以 JSON 输出已存凭据含密钥auth import [file]导入auth export导出的凭据省略文件则读 stdinauth switch [target] [credential]切换集成的当前账号# 查看已登录的账号opencode auth list# 以 JSON 查看opencode auth list--formatjson# 登录服务商交互式选择登录方式opencode auth login anthropic# 指定登录方式opencode auth login anthropic--methodkey# 退出某个账号opencode authlogoutanthropic work# 切换当前账号opencode auth switch anthropic work⚠️安全提醒auth export的输出包含明文密钥切勿提交到 Git 仓库或分享给他人。auth login还支持--answer keyvalue传入表单答案可重复适合非交互环境。opencode models— 模型列表opencode models列出所有可用模型。支持--standalone/--server url。opencode mcp— MCP 服务器管理子命令说明mcp list列出已配置的 MCP 服务器及状态mcp add name [command...]添加 MCP 服务器到配置mcp auth name与支持 OAuth 的远程 MCP 服务器认证mcp logout name移除某个服务器已存 OAuth 凭据# 查看列表opencode mcp list# 添加远程服务器opencode mcpaddcontext7--urlhttps://mcp.context7.com/mcp# 添加本地服务器到全局配置opencode mcpaddeverything--global-- npx-ymodelcontextprotocol/server-everything# 添加本地服务器并注入环境变量opencode mcpaddeverything--envLOG_LEVELdebug -- npx-ymodelcontextprotocol/server-everything# 添加远程服务器并附带请求头opencode mcpaddcontext7--urlhttps://mcp.context7.com/mcp--headerCONTEXT7_API_KEYsecret# OAuth 认证 / 登出opencode mcp auth sentry opencode mcplogoutsentrymcp add参数--url url、--header keyvalue、--env keyvalue、--global写入全局配置而非项目配置。 远程服务器默认使用 OAuth也可以在 TUI 中运行/mcps选择服务器并登录。opencode plugin— 插件管理子命令说明plugin list列出插件加--builtin包含内置服务端插件plugin add package安装插件并写入全局配置plugin check检查包插件是否有更新plugin update更新包插件plugin remove package从全局配置移除插件opencode plugin list opencode plugin list--builtinopencode pluginaddexample/opencode-tui opencode plugin check opencode plugin update opencode plugin remove example/opencode-tuiopencode stats— 用量统计opencode stats# 默认报告opencode stats--days7# 最近 7 天opencode stats--models# 模型使用情况opencode stats--cost# 成本与 Token 明细opencode stats--json# 输出 JSON参数说明--days N最近 N 天0表示今天--year YYYY按自然年统计--all全生命周期统计--project id按项目过滤.表示当前项目--models显示模型用量--tools显示工具可靠性--cost显示成本与 Token 详情--full显示全部详细区块--limit N详细区块的行数--json以 JSON 输出opencode serve— API 与 Web 服务器启动 v2 API 与 Web 服务器。# 默认启动opencode serve# 绑定所有网卡与固定端口opencode serve--hostname0.0.0.0--port4096# 允许指定来源的浏览器跨域访问可重复传入opencode serve--corshttps://app.example.com参数--hostname、--port、--cors、--service、--stdio。opencode pair— 配对链接打印一次性链接第一条附二维码用于让浏览器或 App 登录到当前服务器。链接 5 分钟后过期且仅可使用一次。opencode pair# 本机配对opencode pair--urlhttps://dev.example.com# 使用外部地址生成链接opencode pair--remote# 通过 OpenTunnel 远程配对首次会提示将服务暴露到公网opencode pair--remote--yes# 非交互自动接受脚本场景opencode service— 后台服务管理子命令说明service start启动后台服务service restart重启后台服务service status查看后台服务状态service stop停止后台服务service get [key] [name]读取服务配置service set key value设置服务配置service unset key [name]恢复服务配置默认值# 生命周期opencodeservicestart opencodeservicerestart opencodeservicestatus opencodeservicestop# 配置读写opencodeservicegethostnameopencodeservicesethostname0.0.0.0 opencodeservicesetcors https://app.example.com opencodeservicesetenvOPENCODE_LOG_LEVEL DEBUG opencodeserviceunsethostname隔离模式想让 CLI 命令默认使用私有服务、不启动共享后台服务opencodeservicesetdisabledtrue# 停止并禁用共享后台服务opencode# 此后 CLI 使用私有服务opencodeservicestart# 需要时仍可显式启动共享服务opencodeserviceunsetdisabled# 恢复自动使用共享服务opencode reload— 热重载配置opencode reload无需重启服务器即可重新加载配置。正在运行的会话会在下一个步骤边界使用新服务。opencode api— 调用服务端 API向运行中的服务器发起请求。支持HTTP 方法 路径或 OpenAPI operation ID 两种写法。完整 API 见 API 参考运行时亦可访问/openapi.json。opencode api GET /api/session# 使用 operation ID 查询参数opencode api session.list--paramlimit10# 发送 JSON 请求体opencode api session.create--data{title: New session}# 附加请求头opencode api GET /api/session-Haccept: application/json参数--data, -d、--header, -Hname:value形式、--param keyvalue。opencode acp— Agent Client Protocol 服务opencode acp# 以 stdin/stdout 提供 ACP 服务运行至客户端断开opencode acp--login# 执行 auth login 而非启动服务用于编辑器集成场景。opencode debug— 调试与排障子命令说明debug agents列出所有 Agentdebug config列出配置来源debug paths [name]显示全局路径opencode debug agents opencode debug config opencode debug paths# 显示全部路径带标签opencode debug paths db# 只输出数据库路径sqlite3$(opencode debug paths db)# 直接查询数据库debug paths可选择项db、home、data、config、cache、state、tmp、bin、log、repos。该命令不会启动服务器也不会打开数据库opencode upgrade— 升级别名updateopencode upgrade# 升级到最新版opencode upgrade2.0.21# 升级到指定版本可带或不带 v 前缀opencode upgrade2.0.21--methodbun# 指定安装方式--method, -m可选curl、npm、pnpm、bun、yarn、vp、brew。opencode uninstall— 卸载opencode uninstall --dry-run# 预览将删除的文件与安装opencode uninstall# 确认后卸载opencode uninstall--force# 跳过确认非交互ℹ️ 卸载会先停止已注册的后台服务与持久终端再移除全局缓存目录。会话数据、配置与状态不会被删除。⌨️ TUI 内快捷操作斜杠命令输入/过滤选择命令说明/new新建会话/sessions打开会话列表/models选择模型/agents选择 Agent/undo撤销最近一条消息及其后续改动提示词回到输入框/redo恢复被撤销的改动/editor用$EDITOR编辑当前提示词/btw 问题顺带提问基于会话上下文作答但不写入会话/mcps管理 / 登录 MCP 服务器/highlights重新查看版本更新亮点键盘快捷键快捷键作用ShiftEnter/CtrlEnter/AltEnter/CtrlJ输入换行Enter运行中引导steer当前会话CtrlX然后Enter排队提示词稍后执行CtrlP打开命令面板所有可用操作CtrlX然后M选择模型或/modelsF2在最近使用的模型间循环CtrlX然后A选择 Agent或/agentsShiftTab循环切换 AgentCtrlX然后N新建会话CtrlX然后L返回已有会话或/sessionsCtrlO最近会话与项目一起打开CtrlX然后U/R撤销 / 重做CtrlX然后E用编辑器编辑提示词CtrlTab/CtrlShiftTab切换标签页CtrlX然后W关闭当前标签页CtrlShiftT重开上一个关闭的标签页默认 leader 键为CtrlX可在cli.json中自定义。输入技巧src/auth.ts # 输入 搜索并附加文件 src/auth.ts#20-45 # 附加文件并指向 20–45 行 !git status # 以 ! 开头进入 shell 模式输出保留在会话中Esc 退出 /btw 为什么第 2 步的测试失败了 # 快问快答不影响会话上下文 实用技巧1. 配置 Shell 补全opencode--completionszsh# 可选 bash / zsh / fish / sh将输出加入你的 shell 配置即可2. 调试日志OPENCODE_LOG_LEVELDEBUG opencode# 单次 DEBUG 运行opencode --log-level debug run…# 等价的 CLI 参数写法日志位置可通过opencode debug paths log查看。3. 配置变更后热重载opencode reload4. 直接查看本地数据库sqlite3$(opencode debug paths db)5. 给后台服务注入环境变量opencodeservicesetenvOPENCODE_LOG_LEVEL DEBUG 故障排查按顺序执行opencodeservicestatus# 1. 查看后台服务状态opencode api get /api/info# 2. 验证 API 是否正常opencodeservicerestart# 3. 服务卡死 / 异常时重启opencode--standalone# 4. 用私有服务隔离判断是共享服务还是个例问题日志过滤技巧客户端启动问题看rolecli会话 / 服务 / 权限 / 工具问题看roleserver。⚠️ 排障期间请勿删除或直接编辑数据库、服务注册信息如需用外部工具检查持久化数据请先备份。分享日志前请抹除 API 密钥、提示词等敏感信息。 相关链接资源地址 官方文档V2https://opencode.ai/v2/docs⌨️ CLI 文档https://opencode.ai/v2/docs/cli 配置说明https://opencode.ai/v2/docs/config API 参考https://opencode.ai/v2/docs/api 官方仓库https://github.com/sst/opencode如果这份手册对你有帮助别忘了给 我 点个 ⭐ Staropencode --version→v2.0.27· 基于实机整理 · Made with ❤️