Mastra Code

Mastra Code 是什麼？

Mastra Code 是基於終端機的 AI 程式碼代理，使用 Mastra 的 Harness、Agent 和 Memory 基本元件建置。它在您的終端機中運行，連接 70+ AI 模型，並支援專案內的互動程式碼工作流程，例如讀取、搜尋、編輯與執行程式碼。

代理的核心目的是透過終端機 TUI（終端機使用者介面）、結構化模式與專案範圍的會話處理，協助您完成程式碼任務。它設計用來組織代理的思考與行動方式—無論是快速查詢、規劃實作，或完整的建置與測試循環。

主要功能

• 終端機 UI (TUI) 體驗：在您的終端機中提供精緻 TUI（pi-tui 元件），用於互動代理操作，而非獨立的網頁應用程式。
• 多模型支援 (70+ 模型)：連接 70+ AI 模型，並支援對話中途切換模型，以實現多模型工作流程。
• 基於模式的流程控制：在 Build、Plan 和 Fast 模式之間切換，以符合您期望的代理回應方式（例如，實作 vs. 快速解答）。
• 專案範圍的會話與持續上下文：使用執行緒持續性與訊息歷史，讓對話依專案組織。
• 代理內建程式碼工具：包含 檔案檢視、編輯、搜尋、shell 指令 和 網頁搜尋 等內建工具，支援端到端程式碼任務。
• 可設定代理行為：支援專案範圍的設定，包括 MCP 伺服器、hooks、自訂指令、技能與資料庫設定。
• 程式化自訂：使用自訂模式、工具、子代理與儲存來擴充 Mastra Code。

如何使用 Mastra Code

1. 全域安裝：使用提供的指令（npm、pnpm 或 yarn）之一，例如 npm install -g mastracode。
2. 進入專案目錄：cd your-project 並以 mastracode 啟動 Mastra Code。
3. 設定 API 金鑰：為偏好供應商設定（範例顯示 Anthropic 的 export ANTHROPIC_API_KEY=...），或使用 /login 進行 認證（提及 Anthropic 或 OpenAI 訂閱）。
4. 在終端機發送訊息：代理會以串流文字回應，並能在您的專案中讀取、編輯與執行程式碼。
5. 使用斜線指令與鍵盤快捷鍵：管理會話、切換模型與模式，並控制 TUI（例如 /threads、/models、/mode、/cost、/login、/exit）。

使用情境

• 日常程式碼助理：詢問程式碼庫問題、要求編輯、執行測試，並管理 Git 任務，同時維持相同終端機工作流程。
• 程式碼探索與架構規劃：使用 Plan mode 分析架構並產生實作計劃，再撰寫程式碼。
• 快速查詢與小幅變更：切換至 Fast mode，獲得簡短解答與少量編輯，延遲極低。
• 多供應商比較：在對話中途切換模型，比較不同 AI 模型對相同程式碼問題的回應。
• 開發中的會話與設定管理：使用斜線指令啟動新對話執行緒、依專案列出執行緒、複製執行緒、檢視 token 使用量，並調整設定/主題。

常見問題

Mastra Code 的系統需求為何？
Mastra Code 需要 Node.js 22.13.0 或更新版本。

如何與 AI 供應商認證？
您可以為供應商設定環境變數 API 金鑰（顯示 Anthropic 範例），或執行 /login 與 Anthropic 或 OpenAI 訂閱進行認證。

使用代理時能否切換 AI 模型與模式？
可以。代理提供斜線指令來選擇不同 AI 模型，並在 Build、Plan 和 Fast 模式之間切換。

Mastra Code 如何組織對話？
它使用 專案範圍的執行緒 與持續對話歷史，讓您能在專案內列出、複製與管理執行緒。

Mastra Code 是否支援自訂工具或代理行為？
可以。您可以設定 MCP 伺服器、hooks、自訂指令、技能與資料庫等功能，並使用自訂模式、工具、子代理與儲存來擴充代理。

替代方案

• 本地 IDE 整合式 AI 程式碼工具：在編輯器/IDE 內執行的替代方案可提供程式碼脈絡輔助，但通常著重於內嵌建議，而非終端機優先的代理工作流程與明確模式。
• 通用終端機 LLM 聊天搭配自訂工具：終端機中的聊天代理可透過腳本擴充檔案編輯與指令執行，但需更多設定才能複製 Mastra Code 的內建工具、模式處理與工作階段/對話結構。
• 工作流程式程式碼助理（規劃/建置風格）：強調實作前規劃的工具可對應「Plan mode」概念；差異通常來自工具執行（編輯/搜尋/Shell）與持久專案對話的處理方式。
• 程式碼任務代理框架：通用代理框架可用來建構具記憶體與工具的程式碼代理，但 Mastra Code 將這些基礎元件封裝成隨即可用的終端機 TUI。