OpenCode 的命令主要分为终端命令（在 shell 中执行）和交互命令（在 TUI 中输入），下面整理了最常用和最高效的命令。
一、终端命令（Shell）
这些命令直接在系统终端中执行，用于启动程序、配置、非交互操作等。
基础操作
| 命令 | 说明 |
|---|
opencode | 启动交互式 TUI 界面（最常用） |
opencode run "提示词" | 非交互模式，直接执行一条指令后退出，适合脚本调用 |
opencode --continue 或 -c | 继续上一次的会话 |
opencode --session <ID> 或 -s | 恢复指定的会话 |
配置与认证
| 命令 | 说明 |
|---|
opencode auth login | 配置 AI 模型提供商的 API Key，支持 75+ 种模型 |
opencode auth list | 查看已认证的提供商列表 |
opencode auth logout | 登出指定提供商 |
管理与查询
| 命令 | 说明 |
|---|
opencode models | 列出所有可用模型（格式：provider/model） |
opencode session list | 查看所有历史会话 |
opencode stats | 查看 Token 用量和费用统计 |
opencode agent list | 列出所有可用代理（Plan、Build 等） |
高级功能
| 命令 | 说明 |
|---|
opencode web | 启动 Web 界面（HTTP 服务器 + 浏览器） |
opencode serve | 启动无界面的 API 服务器 |
opencode attach | 将 TUI 连接到远程 OpenCode 后端 |
opencode mcp add | 添加 MCP（Model Context Protocol）服务器扩展功能 |
opencode upgrade | 更新到最新版本 |
二、交互命令（TUI 内 Slash Commands）
启动 opencode 进入 TUI 后，输入 / 即可使用这些快捷命令。
会话管理
| 命令 | 说明 |
|---|
/new 或 /clear | 新建会话 |
/sessions 或 /resume | 查看/切换历史会话 |
/compact 或 /summarize | 压缩当前会话以节省 Token |
/share | 生成会话分享链接 |
/unshare | 取消分享 |
/export | 导出对话为 Markdown |
编辑与撤销
| 命令 | 说明 |
|---|
/editor | 打开外部编辑器编写长消息（需设置 EDITOR 环境变量） |
/undo | 撤销上一次 AI 的修改（依赖 Git） |
/redo | 重做刚才撤销的修改 |
项目与帮助
| 命令 | 说明 |
|---|
/init | 初始化当前项目，生成 AGENTS.md 配置文件，帮助 AI 理解项目结构 |
/help | 显示帮助对话框 |
/models | 列出可用模型 |
/themes | 列出可用主题 |
/details | 切换工具执行详情显示 |
/exit 或 /quit | 退出 OpenCode |
三、高效技巧
1. Agent 模式切换（Tab 键）
- Build 模式（默认）：AI 可以直接修改、创建文件，用于实际编码
- Plan 模式：AI 只读不写，只提供方案建议，适合复杂功能规划
按 Tab 键即可在两个模式间切换
2. 文件引用（@ 符号）
输入 @ 后跟文件名，可快速将文件内容添加到对话上下文中，支持模糊搜索：
@src/api.ts 解释这个文件的作用
3. Shell 命令（! 前缀）
以 ! 开头可直接执行 Shell 命令，输出会作为上下文供 AI 分析：
!git status
!npm run build
!tree -L 2
4. 自定义命令
在 .opencode/commands/ 目录中创建 Markdown 文件，可定义个性化快捷命令。
四、常用快捷键（TUI 内）
| 快捷键 | 说明 |
|---|
Ctrl+N | 新建会话 |
Ctrl+A | 切换会话 |
Ctrl+K | 命令对话框 |
Ctrl+O | 切换模型选择 |
Ctrl+L | 查看日志 |
Ctrl+X | 取消当前生成操作 |
i | 聚焦编辑器（输入消息） |
Esc | 退出编辑模式/关闭对话框 |
Ctrl+S | 发送消息 |
Ctrl+E | 打开外部编辑器 |
? | 切换帮助对话框 |
五、环境变量
| 变量 | 说明 |
|---|
OPENAI_API_KEY | OpenAI 模型密钥 |
ANTHROPIC_API_KEY | Claude 模型密钥 |
GEMINI_API_KEY | Gemini 模型密钥 |
GROQ_API_KEY | Groq 模型密钥 |
OPENCODE_CONFIG | 配置文件路径 |
EDITOR | 外部编辑器（如 code, vim, nano） |
建议先在项目根目录执行一次 /init，AI 生成代码的准确率会大幅提升。如果只是询问思路，记得先按 Tab 切换到 Plan 模式，避免 AI 误改代码。
