在日常軟體工程開發中，頻繁切換網頁端 AI 對話視窗與本地開發環境往往帶來極大的上下文割裂感：工程師需要在瀏覽器與終端機之間反覆複製貼上錯誤堆疊資訊、手動搬運程式碼片段，再費時費力地將分散的修補程式整合回本地專案。Mistral AI 推出的開源終端機原生代理工具 Mistral Vibe（mistral-vibe）正是為了解決這項痛點而設計。
Mistral Vibe 直接運行於命令列環境中，具備讀取專案目錄結構、感知 Git 分支與提交歷史、自動生成跨目錄樣板程式碼，並在託管 Shell 工作階段中自主執行測試套件與修復回歸問題的能力，讓工程師完全無需離開終端機即可完成複雜的多檔案重構與日常開發任務。
1. 環境準備與安裝設定
Mistral Vibe 專為現代終端機環境量身打造，官方原生支援 Linux 與 macOS，同時也支援透過 uv 或 PowerShell 在 Windows 環境下執行。
系統需求
- Python 3.10 以上版本（若透過 Python 工具鏈安裝）。
- 支援 UTF-8 與 ANSI 渲染的現代終端機模擬器（例如 Ghostty、WezTerm、Kitty 或 Alacritty）。
- 有效的 Mistral AI API 金鑰（可從 Mistral AI Console 取得）或有效的 Mistral 訂閱方案。
安裝方式
開發者可依據所屬開發環境選擇下列安裝方式之一：
方式一：一鍵 Shell 指令稿（建議 macOS 與 Linux 使用者）
curl -LsSf https://mistral.ai/vibe/install.sh | bash
方式二：透過 uv 安裝（速度最快，環境完全隔離）
uv tool install mistral-vibe
方式三：透過標準 pip 安裝
pip install mistral-vibe
首次設定與金鑰管理
安裝完成後，可在終端機執行互動式設定精靈：
vibe --setup
精靈會引導輸入 MISTRAL_API_KEY，並自動將其安全儲存至 ~/.vibe/.env。你也可以直接在 Shell 設定檔（如 ~/.bashrc 或 ~/.zshrc）中匯出環境變數：
export MISTRAL_API_KEY="your-mistral-api-key-here"
初次在包含本地設定的新專案代碼庫中啟動 Vibe 時，受信任目錄系統（Trust Folder System）會要求確認目前工作區是否可信。確認後，該路徑將自動登記至 ~/.vibe/trusted_folders.toml，避免在未知路徑下執行潛在的高風險指令。
2. 核心架構：代理執行模式與安全邊界
自主程式碼代理的關鍵在於清晰的權限邊界。Mistral Vibe 內建多種代理模式，嚴格控管代理在未經人工確認時的檔案修改與指令執行權限。
| 代理設定設定檔 | 工具審批與安全邊界 | 適用典型場景 |
|---|---|---|
accept-edits（預設模式） | 自動核准檔案修改（write_file、edit）；執行終端機 Shell 指令前必須經由人工確認。 | 日常功能開發、樣板程式碼生成與多檔案重構。 |
plan | 純唯讀模式。自動核准安全檢查工具（read、grep、ripgrep）；禁止修改檔案與執行系統指令。 | 專案架構審查、技術方案評估與安全探索。 |
ask | 每次呼叫任何工具或變更檔案前均需使用者逐一確認。 | 核心生產環境維護或不熟悉的第三方開源專案。 |
auto-approve（--yolo） | 全自動核准所有工具呼叫、檔案讀寫與終端機指令，全程無任何互動阻斷。 | CI/CD 自動化管線、無前端指令稿與拋棄式容器環境。 |
啟動工作階段時可指定代理模式：
vibe --agent plan
在互動式工作階段進行中，你也可以隨時按下快捷鍵 Shift+Tab 輪流切換模式。
3. 互動式終端機介面的操作基礎
進入專案根目錄並執行指令即可開啟互動式對話：
cd /path/to/my-project
vibe
Mistral Vibe 會載入文字終端機介面（TUI），並自動將當前專案工作路徑、Git 分支狀態與最近提交歷史載入代理的基礎上下文中。
常用互動語法
在對話提示列中，可透過以下語法標記精確注入上下文：
@path/to/file：引用特定檔案或資料夾，支援 Git 追蹤檔案自動補齊。同時支援引用圖片檔案（.png、.jpg、.webp），多模態模型可直接解析介面截圖或架構圖。!command：Shell 脫逸指令。直接在本機系統執行指令而不透過模型（例如!git status或!pytest）。/：開啟斜線指令選單，快速執行管理操作。
核心斜線指令
/model：切換底層推論模型（如mistral-medium-3.5或codestral-latest）。/config：開啟互動式設定編輯器，調整主題或全域預設值。/mcp或/connectors：檢視與管理已連線的 Model Context Protocol（MCP）伺服器及外部連接器。/loop [排程規則]：設定週期性自動化任務（例如/loop every five minutes check git status and test）。/retry [調整指引]：當中途輸出中斷或偏離預期時，指示模型自部分回應繼續產出並修正方向。/clear：清除目前對話的歷史上下文。/exit（或:q）：安全結束工作階段。
實用快捷鍵
Shift+Tab：在accept-edits、plan與ask模式間快速切換。Ctrl+O：展開或收合底層工具調用的詳細輸出面板。Ctrl+T：檢視或隱藏代理內部的任務進度（todo清單）。Ctrl+G：呼叫系統預設外部編輯器（$EDITOR）編寫長篇複雜提示詞。Escape：立即中斷正在執行的模型生成輪次。
4. 終端機代理程式設計完整實戰
Mistral Vibe 能夠流暢處理三大工程實踐：程式碼庫架構探勘、跨模組樣板生成，以及多檔案協同重構。
場景一：架構探勘與子代理任務委派
面對龐大且不熟悉的代碼庫，使用規劃模式進行唯讀探勘最為安全：
vibe --agent plan
提示詞範例：
請梳理驗證中介軟體如何驗證 JWT 權杖，並分析使用者宣告（Claims）是如何注入至後續請求上下文的。
代理會使用 grep 搜尋關鍵字符號並搭配 read 閱讀對應實作。針對大規模搜尋工作，Vibe 會透過 task() 工具將耗時任務指派給內建的 explore 子代理。子代理在獨立上下文中並行工作，防止主對話視窗的 Token 上下文過快消耗。
場景二：跨目錄工程樣板與腳手架自動生成
Mistral Vibe 可以在單次指令中同步建立並串接多個專案檔案：
請在 src/monitoring/ 目錄下構建一套系統監控子系統：
1. 建立 src/monitoring/health.py，提供 CPU、記憶體與磁碟健全度檢查。
2. 建立 src/monitoring/metrics.py，提供 Prometheus 指標匯出器。
3. 將新的健全度檢查路由註冊至 src/main.py。
4. 在 tests/test_monitoring.py 中撰寫覆蓋主要介面的單元測試。
在預設的 accept-edits 模式下：
- Vibe 先使用
read理解src/main.py的路由架構。 - 使用
write_file建立新模組與測試檔案。 - 使用
edit套用精確的差異補丁，僅修改src/main.py中必要的路由引入邏輯。 - 產生完成後，提示使用者確認是否在終端機中執行測試指令。
場景三：多檔案協同重構與閉環自動除錯
重構通常涉及跨檔案介面同步更新，並高度依賴自動化測試驗證回歸。
提示詞範例：
請將 @src/services/user_service.py 與 @src/services/order_service.py 中的資料庫工作階段操作由同步遷移為 SQLAlchemy 非同步工作階段。同步調整 @src/api/routes.py 中的介面處理常式，並在終端機執行測試套件直到全部通過。
代理將執行自動化閉環：
- 依賴分析：檢視資料模型、服務介面與路由定義。
- 套用補丁：依序更新相關檔案並產出清晰的 Unified Diff。
- 執行驗證：請求在終端機中執行
pytest tests/。 - 自主修復：若測試回報缺少
await或資料庫工作階段未認可（commit），Vibe 從終端機捕獲標準錯誤輸出，診斷問題根源並重新套用修正補丁，直到所有測試通過。
5. 專案工程化定制：AGENTS.md、技能系統與 MCP
為了讓 Mistral Vibe 符合團隊的開發規範，你可以進行多層次的設定客製化。
透過 AGENTS.md 規範代理行為
Mistral Vibe 會自動讀取並合併 AGENTS.md 的指示至系統提示詞中：
~/.vibe/AGENTS.md：全域規範，適用於本機所有工程專案。./AGENTS.md：目前專案專用規範，權重高於全域規範。
實用的專案 AGENTS.md 範例：
# 專案工程實踐規範
- 所有 Python 函式必須嚴格遵照 Python 3.12 型別註解規範。
- 非同步測試必須使用 pytest 並設定 asyncio_mode = "auto"。
- 未經明確指示，禁止修改 alembic/versions/ 下的資料庫遷移指令稿。
- 任務結束前，必須在終端機執行 ruff format 統一程式碼格式。
透過技能系統擴充自訂斜線指令
Vibe 支援 Agent Skills 開放規格。在專案根目錄的 .vibe/skills/<skill-name>/ 或 .agents/skills/<skill-name>/ 目錄下建立 SKILL.md：
---
name: security-audit
description: 掃描專案代碼庫中的硬編碼憑證與不安全依賴套件
user-invocable: true
allowed-tools:
- read
- grep
- bash
---
# 安全審查技能
使用 pip-audit 檢查依賴安全性漏洞，並掃描程式碼中遺漏的敏感金鑰。
儲存後，在終端提示列中輸入 /security-audit 即可立即觸發該客製化工作流。
6. 無周邊模式與 CI/CD 自動化管線
除了互動式終端機體驗，Mistral Vibe 亦支援非互動式的程式化模式（Programmatic Mode），便於整合至 CI/CD 自動化環境或定期檢查指令稿中。
使用 -p 或 --prompt 參數即可啟動無周邊工作：
vibe --prompt "檢查 git diff HEAD~1 變更的所有檔案，修正程式碼風格錯誤，若 API 介面變動則同步更新 README.md" \
--auto-approve \
--max-turns 10 \
--max-price 1.50 \
--output json \
--output-dir ./ci-artifacts/
自動化模式下的資源配額管控
--max-turns N：限制最大執行輪次，防範模型陷入無限迴圈。--max-price DOLLARS：設定本次任務的最大花費上限（美元），超額立即中止。--max-tokens N：限制本次任務消耗的總 Token 數。--time-limit SECONDS：設定硬性超時限制（秒）。--output FORMAT：支援純文字（text）、標準json或行級流式streaming。--output-dir DIR：將記錄版本號、生效設定、執行耗時與 Token 成本的export.json寫入指定目錄，方便日後審計。
7. 終端機代理程式設計的最佳實踐
- 大幅修改前保持 Git 工作區乾淨：在指示代理執行大規模多檔案變更前，先使用
git stash或切換至獨立分支。乾淨的 Git 狀態能讓你隨時透過git diff審查變更或一鍵復原。 - 活用
@標記鎖定核心上下文：在大型專案中，透過@src/core/config.py明確指出關鍵檔案，可避免模型進行全域無目標搜尋，大幅節省 Token 與時間。 - 複雜任務先以
plan模式構思：面對重大架構調整，先以vibe --agent plan請代理產出具體變更計畫，審視可行後再切換回accept-edits模式落地實施。 - 以自動化測試取代逐行人工審核：在提示詞中明確指示代理執行測試並觀察終端機輸出，讓模型利用即時回饋自主修正錯誤，發揮終端機程式碼代理的真正威力。