OpenCode: OpenCode TUI终端界面
最后更新：2026-08-31
TUI 是 OpenCode 的核心使用方式，所有代码分析、修改、执行都通过这个界面完成。
1. 你将学到
- TUI 启动与基本交互
- 文件引用（@）功能
- Shell 命令执行（!）
- 斜杠命令完整列表
- 快捷键操作
2. 启动 TUI
BASH
# 当前目录
opencode
# 指定项目目录
opencode /path/to/project
3. 基本交互
在输入框中直接输入自然语言：
TEXT
📖 仅展示
帮我快速总结这个项目的结构
OpenCode 会结合项目代码给出分析结果。
4. 文件引用（核心功能）
使用 @ 引用项目文件：
TEXT
📖 仅展示
这个项目的认证逻辑是如何实现的？查看 @packages/functions/src/api/index.ts
特点：
- 支持模糊搜索文件路径
- 自动读取文件内容
- 无需复制代码
非常适合阅读陌生代码。
5. 执行 Bash 命令
使用 ! 切换到 Shell 模式：
TEXT
📖 仅展示
!ls -la
执行结果会自动加入对话上下文，AI 可以根据结果继续操作。
6. 斜杠命令（/ 命令）
输入 / 可以执行内置命令：
| 命令 | 作用 | 快捷键 |
|---|---|---|
/connect |
添加 LLM 提供商 | — |
/compact |
压缩当前会话上下文 | Ctrl+X → C |
/details |
切换工具执行详情 | Ctrl+X → D |
/editor |
打开外部编辑器 | Ctrl+X → E |
/exit |
退出 TUI | Ctrl+X → Q |
/export |
导出对话为 Markdown | Ctrl+X → X |
/help |
打开帮助面板 | Ctrl+X → H |
/init |
创建/更新 AGENTS.md | Ctrl+X → I |
/models |
列出可用模型 | Ctrl+X → M |
/new |
新建会话 | Ctrl+X → N |
/redo |
重做撤销的操作 | Ctrl+X → R |
/sessions |
会话列表与切换 | Ctrl+X → L |
/share |
分享当前会话 | Ctrl+X → S |
/themes |
列出/切换主题 | Ctrl+X → T |
/thinking |
显示/隐藏推理过程 | — |
/undo |
撤销上一条消息 | Ctrl+X → U |
7. 快捷键
Ctrl + X 是默认"前导键"，类似 Vim 的 Leader 键：
| 功能 | 快捷键 |
|---|---|
| 命令面板 | Ctrl+X → H |
| 新建会话 | Ctrl+X → N |
| 撤销 | Ctrl+X → U |
| 重做 | Ctrl+X → R |
| 模型列表 | Ctrl+X → M |
| 主题切换 | Ctrl+X → T |
| 导出对话 | Ctrl+X → X |
8. 编辑器集成
BASH
export EDITOR="code --wait"
然后在 TUI 中使用 /editor 打开外部编辑器编写复杂提示。
支持：VS Code、Cursor、Vim/Neovim、Nano。
9. 会话管理
| 操作 | 命令 |
|---|---|
| 新建会话 | /new |
| 查看会话 | /sessions |
| 继续上次 | opencode --continue |
| 指定会话 | opencode --session <id> |
10. TUI 配置
JSON
{
"tui": {
"scroll_speed": 3,
"scroll_acceleration": {
"enabled": true
}
}
}
11. TUI 本质
OpenCode TUI 是一个 LLM + 项目上下文 + Git 状态管理 + 命令面板 的复合交互层：
| 前缀 | 功能 | 类比 |
|---|---|---|
/ |
控制行为 | IDE 命令面板 |
@ |
注入上下文 | 文件级 RAG |
! |
执行环境操作 | Shell 工具调用 |
Ctrl+X |
高效快捷操作 | Vim Leader 键 |
❓ 常见问题
Q TUI 在 Windows 终端中显示异常怎么办？
A 推荐使用 Windows Terminal 或切换到 WSL。默认的 cmd.exe 对 TUI 渲染支持较差。
Q 如何在 TUI 中输入多行消息？
A 使用 /editor 命令打开外部编辑器编写，或使用 Shift+Enter 输入换行。
Q Alice 用 @ 引用了大文件，导致上下文过长怎么办？
A 使用 /compact 压缩上下文。也可以只引用文件的关键部分，而不是整个文件。
📖 小节
- TUI 是 OpenCode 的核心交互界面
@引用文件，!执行命令，/调用内置命令- Ctrl+X 是快捷键前导键
- 多用 @ 引用文件提高准确率
- 重要操作前确保 Git 已提交
📝 作业
-
基础题：在 TUI 中使用 @ 引用一个文件，让 AI 分析其代码逻辑。
-
进阶题：使用 ! 执行一条 Shell 命令，然后让 AI 根据结果给出建议。
-
挑战题：使用 /editor 编写一段复杂的多行提示词，让 AI 完成一个多步骤任务。
