Skip to content

建立 2026-09-15 更新 2026-09-15

終端機 TUI

TUI（Terminal User Interface，終端機使用者介面）是 OpenCode 的主要工作畫面。在專案目錄執行 opencode 就會進入；也可以指定路徑：

opencode /path/to/project

進到 TUI 後直接打提示詞即可。預設 leader key 是 Ctrl+X，多數 slash 指令都有對應快捷鍵。

輸入時常用的寫法

寫法 作用
@檔名 模糊搜尋並把檔案內容加入對話
!指令 先跑 shell，把輸出當工具結果
/指令 執行內建或自訂 slash command
Tab 切換 Plan／Build 等 primary agent

/editor 會用環境變數 EDITOR 開外部編輯器寫長提示。GUI 編輯器要加 --wait，例如：

export EDITOR="code --wait"

常用 slash 指令

指令 快捷鍵（預設） 說明
/connect 新增 LLM provider
/models Ctrl+X M 列出並選擇模型
/init 建立或更新 AGENTS.md
/undo Ctrl+X U 還原上一則訊息與檔案變更
/redo Ctrl+X R 重做剛還原的內容
/new Ctrl+X N 開新 session（別名 /clear）
/sessions Ctrl+X L 列出並切換 session
/compact Ctrl+X C 濃縮目前對話
/editor Ctrl+X E 用外部編輯器寫訊息
/export Ctrl+X X 匯出對話為 Markdown
/themes Ctrl+X T 換主題
/thinking 顯示或隱藏模型的思考區塊
/details 切換工具執行細節
/help 說明對話框
/exit Ctrl+X Q 離開（別名 /quit、/q）

/undo 與 /redo 需要專案是 Git repo。指令面板預設為 Ctrl+P。

完整列表與更新以 官方 TUI 文件 為準。

tui.json

TUI 外觀與快捷鍵跟 runtime 設定分開。編輯 ~/.config/opencode/tui.json（或專案旁的 tui.json），不要把主題塞進 opencode.json。

{
  "$schema": "https://opencode.ai/tui.json",
  "theme": "opencode",
  "keybinds": {
    "leader": "ctrl+x",
    "command_list": "ctrl+p"
  }
}

keybinds 會跟內建預設合併，只寫要改的即可。可用 OPENCODE_TUI_CONFIG 指定另一份檔案。

attention 可在提問、權限、錯誤或 session 完成時發出通知與音效，預設關閉。

相關資料