opencode 速查清单
1. 安装与维护
| 命令 | 作用 |
|---|---|
npm install -g opencode-ai | npm 全局安装（推荐，版本最新） |
brew install opencode | Homebrew 安装（更新较慢） |
curl -fsSL https://opencode.ai/install | bash | 官方脚本安装 |
opencode --version | 查看版本 |
opencode upgrade | 升级到最新版 |
npm update -g opencode-ai | 用 npm 升级 |
opencode uninstall | 卸载并清理相关文件 |
2. 高频命令
| 命令 | 作用 | 使用场景 |
|---|---|---|
opencode | 在当前目录启动 TUI | 日常主入口 |
opencode auth login | 登录/配置供应商凭证 | 第一次必做 |
opencode auth list | 查看已配置供应商 | 确认凭证 |
opencode models | 列出可用模型 | 选模型、排查供应商 |
opencode run "消息" | 单次执行，不进 TUI | 脚本化、快速问答 |
opencode run -c "..." | 续接上一次会话 | 接着上次继续 |
opencode run -m provider/model "..." | 指定模型执行 | 按任务选模型 |
opencode run -f 文件 "..." | 附带文件执行 | 针对具体文件提问 |
opencode --help | 顶层帮助 | 忘记命令时 |
3. opencode run 常用选项
| 选项 | 作用 |
|---|---|
-c, --continue | 续接最近一次会话 |
-s, --session <id> | 指定会话 id 续接 |
-m, --model <provider/model> | 指定模型 |
--agent <name> | 指定使用的 agent |
-f, --file <path> | 附带一个或多个文件 |
--format json | 输出结构化 JSON 事件（便于程序解析） |
--variant high|max|minimal | 调节推理强度（供应商相关） |
--thinking | 显示思考过程块 |
-i, --interactive | 交互式分栏模式 |
4. TUI 快捷键（默认键位）
opencode 用 leader 键触发多数操作，默认 leader 为
ctrl+x，写作<leader>。 下表为官方文档确认的核心键位；完整清单以 TUI 内按?打开的帮助面板为准（版本不同可能有差异，也可在opencode.json自定义）。
| 快捷键 | 作用 |
|---|---|
? | 打开帮助 / 查看全部键位 |
ctrl+x（leader） | 触发前缀，后接功能键 |
ctrl+c / ctrl+d / <leader>q | 退出 opencode |
<leader>e | 打开外部编辑器编辑输入 |
| 回车 | 发送当前输入 |
记不住就按
?。想改键位，编辑opencode.json（或tui.json）的keybinds段。
5. 场景口令
读懂陌生代码
解释 {模块/文件} 的主流程，指出关键分支和外部依赖定位并修复 Bug
{现象 + 日志}，先定位原因再给修复方案，别直接改加小功能
在 {位置} 加 {功能}，先说改动点和影响面，我确认后再写单次脚本化调用
opencode run "一句话任务"
opencode run --format json "任务" # 要结构化输出6. 最小记忆卡
只背这 6 条：
npm install -g opencode-ai安装。opencode auth login配供应商（第一次必做）。cd 仓库后敲opencode启动。- 输入需求回车；它要改文件/跑命令时先审后批。
?查快捷键，opencode models查模型。opencode run "..."做单次/脚本化调用。
掌握这 6 条，日常 80% 的终端 AI 编码场景就够用了。