跳到文章內容

Mac 一鍵環境安裝包:把電腦調成 AI 友善基地

這是「超級 AI 個體」課程開源的 步驟 0:給所有想開始用 AI Agent 的人,不綁付費內容。

雙擊 App 大約 10~15 分鐘,把地基裝好;開場用 checkbox 勾選要裝的 Claude/Codex(可複選)。下面每一步都有截圖,照著做即可。


它會裝什麼

必裝地基(自動)

  1. git(版本控制/時光機)
  2. Homebrew(Mac 軟體管家;舊系統可能走備用路線)
  3. GitHub CLI(gh)
  4. GitHub 登入

挑你要裝的 AI 工具(↑↓ 移動、空白鍵勾選、可複選;都不勾=只裝基礎)

選項 說明
☐ Claude 桌面版 Claude 官方桌面 App
☐ Claude 終端機版 Claude Code
☐ ChatGPT 桌面版 ChatGPT 官方桌面 App
☐ Codex 終端機版 Codex CLI

已經裝過的會自動跳過,可重跑。完成畫面依實際結果打勾,不會假裝成功。

桌面版自己會提示更新;安裝包不會幫你排程 brew upgrade。


下載

已簽名+公證的 Mac 安裝包:

→ 下載「雷蒙的 AI 基礎環境安裝包(MAC).zip」

文字版與 Windows 做法:env-installer/README.md


圖解操作步驟

跟著截圖走。中途只會請你「輸入 Mac 密碼」和「開瀏覽器登入 GitHub」,都是正常關卡。

一、下載到打開

1. 解壓縮:下載到的 zip,瀏覽器通常會自動解壓成 App(沒有的話雙擊它)。

解壓縮下載的 zip

2. 雙擊 App:解壓後會出現星光背包圖示的 App,雙擊它。

雙擊 App

3. 打開:已簽名+公證,系統顯示「已檢查,未偵測到惡意軟體」時按「打開」。

確認打開

二、開場:挑你要裝的 AI 工具

基礎環境一定會裝。AI 工具用 ↑↓ 移動、空白鍵勾選(可複選)、Enter 確認;都不勾=只裝基礎環境。

勾選要裝的 AI 工具

三、基礎環境

5. 輸入 Mac 密碼:安裝 Homebrew 時會請你輸入電腦密碼。打字時看不到字是正常的,打完按 Enter。

輸入 Mac 密碼

6. 按 Enter 繼續:Homebrew 會列出要安裝的位置,按 Enter 讓它繼續。這一站最久,約 3~5 分鐘,畫面卡著是在下載、不是當機。

Homebrew 按 Enter 繼續

四、登入 GitHub

7. 開始 GitHub 登入:進到「GitHub 登入」這一站,跟著往下選。

GitHub 登入引導

8. 選 GitHub.com:用方向鍵選 GitHub.com。

選 GitHub.com

9. 選 HTTPS:協定選 HTTPS。

選 HTTPS 協定

10. 複製一次性驗證碼:終端機會顯示一組 one-time code,先複製起來,按 Enter 會自動開瀏覽器。

複製一次性驗證碼

11. 瀏覽器:Device Activation:瀏覽器打開後按「Continue」。

Device Activation

12. 貼上驗證碼:把剛剛複製的驗證碼貼進去,按 Continue。

貼上驗證碼

13. 授權:確認權限後按綠色的「Authorize github」。

授權 GitHub CLI

14. 連結完成:看到「Congratulations, you're all set!」就代表登入好了,可關掉瀏覽器回到終端機。

連結完成

五、其他工具與完成

15. 繼續安裝你勾選的工具:接著會自動裝你勾的 AI 工具,跟著跑就好。

安裝其他工具

16. 完成:最後畫面會依實際結果逐項打勾。看到這張就全部裝好了,按 Enter 關閉視窗即可。

完成安裝


常見「以為壞了」

  • 打密碼沒有字:正常,打完按 Enter。
  • 畫面卡住:多半在下載(Homebrew 最久約 3~5 分鐘)。
  • 系統擋 App:已公證的正式版通常不會;若遇到,對 App 按右鍵 → 打開。

舊 Mac?

macOS 行為
14+ 完整 Homebrew 路線
13 自動改官方安裝器備用路線
12 以下 友善停止,導向 Claude 桌面版

Windows

一鍵 App 還沒有。PowerShell 可先:

winget install --id Git.Git -e
winget install --id GitHub.cli -e
irm https://claude.ai/install.ps1 | iex
gh auth login

細節見 README 的 Windows 段落。

熟手:直接跑腳本

cd env-installer
chmod +x install-mac.sh
./install-mac.sh

只要工具、不登入 GitHub:./install-mac.sh --skip-auth
指定工具、不進選單:./install-mac.sh --tools=claude|codex|both|base


裝完之後