入門指南

本指南將帶您從安裝開始，完成第一個終端機與第一個 AI 智慧體會話。讀完即可開始工作；各項功能的詳細說明請見其他章節（參閱手冊概覽）。

1. VelaTerm 是什麼

VelaTerm 是專為搭配 AI 程式設計智慧體工作而設計的終端機管理工具。它以專案 → 群組 → 會話的樹狀結構整理終端機與智慧體會話，並將 Claude Code、Codex 等程式設計智慧體作為專屬會話執行：您可以隨時看出智慧體是否正在工作、是否需要您回應，或是否已經完成；重新開啟會話時，對話會接著進行。智慧體可以在自己的終端機介面中執行，也可以在會話檢視中執行，後者以訊息、工具卡片與權限按鈕呈現對話。透過瀏覽器遠端存取與 SSH 遠端開發，您也能在其他裝置上繼續使用這些會話。

2. 安裝

請從下載頁面下載適用於您平台的安裝檔：

VelaTerm 會自動檢查更新；在應用程式選單中選擇「Check for Updates…」可立即檢查。

3. 首次啟動：新增專案

首次啟動時，側邊欄是空的，並提供三種新增專案的方式：

• 「建立專案」會建立新資料夾並將其加入。
• 「開啟專案」（⌘O；在 Windows 與 Linux 上為 Ctrl+Alt+O）會加入現有的資料夾。
• 「從 Git 複製」會複製儲存庫並將其加入。

側邊欄頂端也有相同功能的按鈕。在專案中，您可以建立群組，並可任意多層巢狀（例如前端、後端、測試），再於群組中建立會話：

4. 開啟第一個終端機

以下任一方式都能開啟臨時終端機：

1. 按下 ⌘T（在 Windows 與 Linux 上為 Ctrl+Alt+T）。
2. 將滑鼠移到側邊欄中的專案、群組或會話上，點選 ＋ 按鈕，然後選擇「新增終端機」。終端機會在該節點的目錄中啟動。專案與群組的右鍵選單中也有相同的項目。
3. 中央區域沒有內容時，點選「新增終端機」。

臨時終端機只以分頁形式存在：它不會成為樹狀結構中的節點，關閉後即捨棄，因此適合用來執行簡短的指令。

5. 開啟第一個 AI 智慧體會話

在專案或群組上按右鍵，選擇「新增 Claude 會話」。選單第一層提供 Claude、Codex 與 OpenCode；「更多 Agent 會話」則列出全部十四種支援的智慧體。您也可以按 ⌘N（在 Windows、Linux 與一般瀏覽器中為 Ctrl+Alt+N），開啟可搜尋的智慧體清單。

VelaTerm 會在專案目錄中啟動智慧體。Claude、Codex、OpenCode、Pi 與 OMP 會話以會話檢視開啟：在底部的輸入框中輸入訊息，然後按 Enter 即可。其他智慧體以終端機檢視開啟，顯示智慧體本身的終端機介面。窗格標頭中的切換按鈕可讓會話在兩種檢視之間切換；請參閱會話檢視。

從此之後，您可以使用以下三項功能：

• 狀態點：側邊欄中會話旁的圓點顯示智慧體的狀態。綠色表示正在工作，黃色表示需要您處理（提問或權限請求），洋紅色表示已回覆且您已看過。
• 系統通知：智慧體停下來等待您時，您會收到通知。如果您正在查看該會話，則不會顯示通知。
• 自動恢復：關閉分頁或結束應用程式後，下次開啟該會話時，對話會從中斷處繼續。如需開始新的對話，請建立新的會話。

如果尚未安裝該智慧體的 CLI，會話中會顯示安裝卡片，提供適用於您系統的建議安裝指令與「一鍵安裝」按鈕。

6. 快速導覽

• 左側側邊欄：專案樹，附有搜尋框與狀態篩選。頂端按鈕包括：建立專案、匯入專案、從 Git 複製、搜尋所有會話，以及已封存會話。
• 中央區域：分頁列與已開啟的會話。預設情況下，在樹狀結構中點選智慧體會話會沿用目前的分頁，先前的分頁則在背景繼續執行。關閉分頁會結束其處理程序。分頁可分割為多個窗格（⌘D 向右分割，⌘⇧D 向下分割）。
• 右側面板：隨目前的會話切換，包含四個分頁：檔案、資訊（會話詳細資料、帳號用量、上下文與資源使用情況）、Git（分支、變更與提交），以及知識庫。
• 狀態列：會話數量、目前的會話類型、Git 分支、權限模式、通知開關，以及「工作中」／「等待處理」／「已查看」計數器。點選計數器後，側邊欄只會顯示處於該狀態的會話。
• 標題列右側：主題切換、遠端存取、連線到遠端服務、分享、設定、帳號、意見回饋，以及顯示或隱藏兩側面板的按鈕。

7. 接下來可以閱讀

• 樹狀結構、分頁、分割窗格、封存與全域搜尋：介面與會話管理。
• 智慧體功能、恢復、分叉與權限：AI 智慧體會話。
• 在會話檢視中工作：會話檢視。
• 讓智慧體在獨立的 worktree 中啟動子會話：會話派生與 Git 協作。
• 終端機功能（搜尋、貼上圖片、指令建議）：終端機使用方式。
• 從手機或其他電腦使用 VelaTerm：遠端開發與管理。