
命令主要分为三类：
1. **终端 CLI 命令**（shell 中直接运行 `opencode` + 子命令）
2. **常用全局 Flags**（适用于大多数模式）
3. **交互 TUI 内 Slash 命令**（运行 `opencode` 进入界面后输入 `/` 触发）

### 1. 终端 CLI 命令（opencode [subcommand] [flags]）

| 子命令 / 用法                  | 主要作用                                      | 典型示例                                           | 备注 / 成熟度      |
|--------------------------------|-----------------------------------------------|----------------------------------------------------|--------------------|
| `opencode`                     | 启动交互式 TUI（最常用）                      | `opencode` 或 `opencode "修复这个 bug"`            | 默认入口           |
| `opencode run "prompt"`        | 非交互式单次执行（pipe 友好，执行后退出）      | `opencode run "写一个 REST API 示例"`              | 脚本/CI 常用       |
| `opencode tui`                 | 显式启动 TUI（等同无参数）                    | `opencode tui`                                     | —                  |
| `opencode upgrade`             | 更新到最新版本                                | `opencode upgrade`                                 | 保持最新           |
| `opencode upgrade vX.Y.Z`      | 更新到指定版本                                | `opencode upgrade v1.2.3`                          | —                  |
| `opencode auth list`           | 列出已配置的凭证/提供商                       | `opencode auth list`                               | 管理 API key       |
| `opencode auth logout`         | 退出特定提供商登录                            | `opencode auth logout`                             | —                  |
| `opencode models`              | 列出所有可用模型（跨提供商）                  | `opencode models`                                  | 刷新缓存后查看     |
| `opencode agent create`        | 创建自定义 agent                              | `opencode agent create`                            | 交互式向导         |
| `opencode agent list`          | 列出所有 agent                                | `opencode agent list`                              | —                  |
| `opencode github install`      | 在当前 GitHub 仓库安装 OpenCode Actions 集成  | `opencode github install`                          | PR 自动 review     |
| `opencode serve`               | 启动 headless 服务器（API 访问）              | `opencode serve`                                   | 远程/网络使用      |
| `opencode web`                 | 启动带 Web 界面的服务器                       | `opencode web`                                     | 可视化访问         |
| `opencode attach`              | 连接到运行中的后台服务器                      | `opencode attach`                                  | 远程 TUI           |

**常用全局 Flags**（可加在 opencode 后）

| Flag                  | 缩写 | 作用                                          | 示例                                      |
|-----------------------|------|-----------------------------------------------|-------------------------------------------|
| `--prompt <text>`     | -p   | 非交互模式，直接给出提示                      | `-p "总结变更"`                           |
| `--model <provider/model>` | -m | 指定模型                                      | `-m claude/sonnet-4` 或 `-m ollama/llama3` |
| `--agent <name>`      | —    | 指定启动的 agent                              | `--agent explorer`                        |
| `--cwd <dir>`         | -c   | 设置工作目录                                  | `--cwd ./backend`                         |
| `--debug`             | -d   | 开启调试日志                                  | `--debug`                                 |
| `--force` / `--yolo`  | -f   | 跳过确认提示（危险，全自动）                  | `--yolo`                                  |
| `--help`              | -h   | 显示帮助                                      | `opencode --help`                         |

### 2. 交互 TUI 内 Slash 命令（输入 / 后模糊搜索）

| Slash 命令            | 主要作用                                      | 常用场景 / 备注                              |
|-----------------------|-----------------------------------------------|----------------------------------------------|
| `/help`               | 显示所有 slash 命令 + 快捷键                  | 随时查看，必备                               |
| `/connect`            | 添加/登录 LLM 提供商（Claude、OpenAI 等）     | 首次使用或切换账号                           |
| `/models`             | 切换当前模型                                  | 性能/速度/成本权衡                           |
| `/init`               | 扫描项目，生成/更新 AGENTS.md 项目记忆文件    | 新项目强烈推荐先跑                           |
| `/undo` / `/redo`     | 撤销/重做上一步（包括文件变更）               | 安全迭代核心                                 |
| `/clear`              | 清空当前对话 + 上下文，从零开始               | 切换新任务                                   |
| `/share`              | 生成会话分享链接                              | 分享给团队或调试                             |
| `/agent`              | 切换/管理 agent（@提及方式调用）              | 多角色并行工作                               |
| `/commands`           | 管理/重载自定义命令                           | 自定义后 reload                              |
| `/tools`              | 查看/配置工具权限（shell/edit/read 等）       | 调试 agent 能力                              |
| `/cost` / `/stats`    | 显示 token 消耗、费用估算                     | 监控大上下文                                 |
| `/compact`            | 压缩对话历史，节省 token                      | 长会话优化                                   |
| `/memory`             | 编辑项目记忆（AGENTS.md 等）                  | 持久化项目知识                               |

**补充说明**（2026 年 3 月最新情况）：
- 官方最权威文档：https://opencode.ai/docs/cli + https://opencode.ai/docs/commands + https://opencode.ai/docs/tui
- 自定义 slash 命令：放在项目 `.opencode/commands/` 或全局 `~/.config/opencode/commands/` 目录下，用 Markdown 文件定义（支持占位符，非常强大）
- 工具权限：默认全开（可编辑 shell、文件等），生产环境建议配置审批或用 `--yolo` 自动化
- 支持本地模型：Ollama / LM Studio 等，通过 `/connect` 添加
- GitHub 集成：`opencode github install` 后可在 PR 评论中用 `/opencode` 或 `/oc` 触发 agent

快速查看本地帮助：
```bash
opencode --help          # CLI flags 和子命令
opencode models          # 可用模型
# 进入 TUI 后
/help                    # slash 命令列表
```

