文档摘要
02 命令与接口速查 本节摘要:这是高频命令与接口的速查表,覆盖安装、多形态启动、会话、模型、配置、调试等场景。每条给命令形态与关键参数说明。具体命令名以你本地版本为准(本表给概念性形态)。 一、安装与启动 操作 | 命令形态(概念性) | 关键说明 确认安装 | | 返回版本号即装好 交互式 TUI | | 无参数即进全屏对话 非交互式 | | 一次性拿响应退出 无头服务 | | 起 HTTP 服务(可配端口/主机/密码) 查看帮助 | | 列子命令与选项 二、serve 模式常用参数 参数 | 默认 | 说明 | (随机) | 监听端口,0 先试 4096 | | 监听地址,0.0.0.0 全网络 | | 允许的跨域来源 | | 局域网发现(开了自动 0.0.0.
02 命令与接口速查
本节摘要:这是高频命令与接口的速查表,覆盖安装、多形态启动、会话、模型、配置、调试等场景。每条给命令形态与关键参数说明。具体命令名以你本地版本为准(本表给概念性形态)。
一、安装与启动
| 操作 |
命令形态(概念性) |
关键说明 |
| 确认安装 |
opencode --version |
返回版本号即装好 |
| 交互式 TUI |
opencode |
无参数即进全屏对话 |
| 非交互式 |
opencode run "<提示>" |
一次性拿响应退出 |
| 无头服务 |
opencode serve |
起 HTTP 服务(可配端口/主机/密码) |
| 查看帮助 |
opencode --help |
列子命令与选项 |
二、serve 模式常用参数
| 参数 |
默认 |
说明 |
--port |
0(随机) |
监听端口,0 先试 4096 |
--hostname |
127.0.0.1 |
监听地址,0.0.0.0 全网络 |
--cors |
[] |
允许的跨域来源 |
--mdns |
false |
局域网发现(开了自动 0.0.0.0) |
| 密码环境变量 |
可选 |
设了才安全,不设打印警告 |
三、非交互式 run 常用参数
| 参数 |
说明 |
<提示> |
要问的内容 |
--format json |
JSON 格式输出(看事件流用) |
--continue |
继续上次会话 |
--session <id> |
指定会话 |
--fork |
从某会话分叉 |
--command <名> |
执行某斜杠命令 |
--mini |
用轻量模型 |
四、会话管理
| 操作 |
说明 |
| 列出会话 |
查历史会话 |
| 恢复会话 |
接回某历史会话 |
| 导出/导入 |
会话数据迁移 |
(具体命令以本地版本为准)
五、模型与 Provider
| 操作 |
说明 |
opencode models |
列出可用模型 |
opencode providers |
列出/管理 Provider |
| 环境变量配 Key |
<厂商>_API_KEY 形式 |
六、配置
| 操作 |
说明 |
| 项目配置文件 |
项目根配置目录的核心文件(如 opencode.jsonc) |
| 用户配置 |
用户主目录 |
| 环境变量 |
运行时注入 |
opencode config |
查看/改配置(若支持) |
七、调试与观测
| 操作 |
说明 |
--format json(run) |
看结构化事件流 |
| OpenTelemetry 导出 |
接可观测后端看追踪 |
| 日志 |
查运行日志定位问题 |
八、斜杠命令(会话内)
| 命令 |
说明 |
/init |
初始化项目(生成项目说明文件) |
/review |
审查当前改动 |
| 项目自定义命令 |
项目配置目录里的命令模板 |
九、MCP 相关
| 操作 |
说明 |
| 配置 MCP |
在配置里加 MCP server(command 或 url) |
| 查 MCP 状态 |
connected/disabled/failed/needs_auth |
| OAuth |
needs_auth 时会引导浏览器登录 |
十、本节要点回顾
- 十大类速查:安装启动 / serve 参数 / run 参数 / 会话 / 模型 / 配置 / 调试 / 命令 / MCP。
- 命令形态为概念性,具体以本地版本为准。
- serve 记三件事:端口/主机/密码(安全底线)。
- run 常用:
--format json 看事件流、--continue 续会话。
- 调试:
--format json + OpenTelemetry 是两大利器。