文档
中文文档
TUI 终端界面

TUI 终端界面

OpenCode 提供交互式终端用户界面,用于与 LLM 协作。在项目目录中运行 opencode 启动。

核心功能

文件引用

使用 @ 在消息中引用文件:

@packages/functions/src/api/index.ts 中的认证是如何处理的?

Bash 命令执行

在消息前加 ! 执行 shell 命令:

!ls -la

斜杠命令

命令描述快捷键
/connect添加 Provider 和 API 密钥
/compact压缩会话ctrl+x c
/details切换工具详情ctrl+x d
/editor打开外部编辑器ctrl+x e
/exit退出 OpenCodectrl+x q
/export导出为 Markdownctrl+x x
/help显示帮助ctrl+x h
/init创建 AGENTS.mdctrl+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
/undo撤销上一条消息ctrl+x u

编辑器配置

设置 EDITOR 环境变量:

# Linux/macOS
export EDITOR=nano
export EDITOR="code --wait"
 
# Windows PowerShell
$env:EDITOR = "code --wait"

配置

opencode.json 中自定义 TUI 行为:

{
  "tui": {
    "scroll_speed": 3,
    "scroll_acceleration": {
      "enabled": true
    }
  }
}

选项:

  • scroll_acceleration.enabled - macOS 风格滚动加速
  • scroll_speed - 滚动速度(最小值:1)