🖥️ 安裝部署

macOS、Windows、Linux、WSL2、Docker、Serverless 的安裝與部署指南

給講師與團隊負責人的準備清單。統一走雲端模型、不要求顯示卡、開課前七項檢查，以及四個會在教室現場炸掉的坑：Intel Mac、Claude Pro 不能用、公司網路擋 OAuth、Python 3.14。

建議配備與最低配備分開列，一分鐘看完。雲端模式建議 16 GB 記憶體、顯示卡非必須；本機模型模式含顯示卡怎麼挑的對照表。另有 Intel Mac 不支援、模型 context 需 64K 兩個會擋人的硬性條件。

讓 agent 不綁在你的筆電上。官方支援六種執行環境：這篇說明各自的取捨，以及目前中文文件的缺口在哪。

桌面版、命令列、WSL2、Docker、無伺服器：五種裝法各有適用場景。花兩分鐘選對，省下之後重裝的時間。

一行指令就能裝完，但前置套件缺了會失敗得莫名其妙。含桌機與 VPS 長駐兩種情境，以及 service user 部署。

兩種裝法:桌面版點兩下就好,或用一行指令裝命令列版。每一步都告訴你「怎麼知道成功了」,卡住時也知道要查哪裡。

Windows 上有三種安裝方法。這篇幫你挑一個最適合的,每一步都告訴你「怎麼看出成功了」。挑錯了要重來很麻煩,所以先看這篇。

Windows 使用者的完整 Linux 路線。安裝跟 Linux 一樣簡單，真正的坑在 gateway 常駐與瀏覽器控制：這兩件事在 WSL2 裡跟一般 Linux 不同。