第2章：基本使用方式

2.1 TUI 介面操作

TUI（Terminal User Interface）是 OpenCode 最核心的使用方式。啟動後，你會看到一個分割畫面：上方是對話與輸出區域，底部是指令輸入列。

常用指令一覽

檔案參照（@file）

在 TUI 中，你可以使用 @ 符號來參照專案中的檔案，讓 AI 直接讀取這些檔案的內容：

@src/components/Button.tsx 幫我把這個元件的樣式改為 primary 色系

也可以一次參照多個檔案：

@src/utils/helpers.ts @src/types/index.ts 這兩個檔案之間有哪些型別不一致？

執行 Shell 命令

在 OpenCode 中，你可以用 ! 前綴直接執行終端機命令：

!npm run test          # 執行測試
!git status            # 查看 Git 狀態
!npm install lodash    # 安裝套件

你也可以使用 #! 前綴（或直接輸入 bash 後跟命令）：

#!node scripts/build.js
bash: docker compose up -d

編輯器整合

在 TUI 中，你也可以直接啟動外部編輯器來編輯特定檔案。OpenCode 會自動偵測系統中可用的編輯器（VS Code、Vim、Neovim、Helix 等），並在需要時開啟編輯。

設定面板

在 TUI 中按下快捷鍵（預設為 Ctrl+P）可以開啟設定面板，讓你即時調整：

• 主題 — 切換淺色／深色模式
• 模型 — 快速切換當前使用的 LLM
• 權限 — 調整工具執行權限策略
• 快捷鍵 — 檢視與自訂按鍵綁定

2.2 CLI 指令列模式

除了 TUI 互動模式，OpenCode 也提供完整的 CLI（Command Line Interface），適合自動化腳本、CI/CD 流程或快速一次性任務。

opencode run

以非互動方式執行單一任務，執行完畢後自動結束：

CLI 指令總表

Session 管理

OpenCode 的工作階段管理讓你可以在不同任務之間切換，而不會遺失對話上下文：

opencode session list      # 列出所有工作階段
opencode session show <id> # 檢視特定工作階段
opencode session delete <id> # 刪除工作階段

2.3 Web 介面使用

如果你偏好圖形化介面，OpenCode 提供了 Web 版本，只需要一個指令即可啟動：

Web 介面提供與 TUI 相同的功能，但以瀏覽器為操作介面：

• 左側顯示對話歷史
• 中央為目前對話區域
• 底部輸入列支援與 TUI 相同的所有指令與 @ 檔案參照
• 右上角提供設定面板與主題切換

2.4 IDE 整合

VS Code 擴充套件

OpenCode 提供官方 VS Code 擴充套件，安裝後可以直接在編輯器中與 AI 代理互動：

• 在 VS Code 的擴充市集中搜尋「OpenCode」即可安裝
• 支援選取程式碼後直接傳送給 OpenCode 進行修改或解釋
• 內建差異檢視（Diff View），讓你可以逐行審查 AI 的變更
• 快捷鍵整合，無需離開編輯器即可使用

JetBrains 外掛

IntelliJ IDEA、WebStorm、PyCharm 等 JetBrains 系列 IDE 也提供官方外掛：

• 在 Settings > Plugins 中搜尋「OpenCode」
• 支援與 VS Code 版本相同的核心功能
• 深度整合 JetBrains 的程式碼分析引擎

2.5 實際工作流程範例

以下展示一個完整的 OpenCode 工作流程，從啟動到完成任務：

這個範例展示了幾個關鍵點：

• 使用 @ 參照特定檔案
• 以自然語言描述需求
• OpenCode 會先分析再提出變更計畫
• 套用前會請求使用者確認

章節測驗

測試你對本章內容的理解程度：

常見問題