[MAC][AI] MacOS 從零開始安裝 Google Gemini CLI (保母級教學)
什麼是Gemini CLI？
Gemini CLI 是 Google 最新推出的AI工具，讓你可以輕易的在終端機模式進行「vibe coding」(直覺式開發)，它能即時幫您生成程式碼、重構、除錯或解釋語法。無需離開指令列，就能將模糊的想法和靈感，迅速化為精準的程式碼，而且完全免費。
這篇文章將手把手教你如何在 MacOS 的裝置(如: MacBook Pro、Mac mini...等)，從無到有安裝並啟用 Gemini CLI，適合完全沒經驗的新手！
🔧 步驟 1：安裝 Homebrew（macOS 套件管理工具）
打開你的「終端機」（Terminal），貼上以下指令來安裝 Homebrew：
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
安裝完成後，請執行以下兩行，讓 brew 指令生效：
echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.zprofile
eval "$(/opt/homebrew/bin/brew shellenv)"
🔧 步驟 2：安裝 Node.js 和 npm
Gemini CLI 是 Node.js 套件，因此需要先裝好 Node.js：
brew install node
確認是否安裝成功：
node -v
npm -v
成功安裝後會顯示版本，例如：
v24.3.0
11.4.2
🔧 步驟 3：安裝 Gemini CLI
接下來執行以下指令來全域安裝 Gemini CLI 工具：
sudo npm install -g @google/gemini-cli
驗證安裝成功與否：
gemini --version
🚀 步驟 4：啟動 Gemini CLI 並登入 Google
gemini
第一次執行會要求你：
- 選擇主題顏色
- 使用 Google 帳號登入（會自動打開瀏覽器）
- 授權 Gemini 使用你的帳號（免費使用 gemini-2.5-pro）
登入成功後，就能看到 Gemini CLI 的互動介面，開始問它各種問題！如果想要退出就按兩次 Ctrl + C。
🔍 實戰：請 Gemini 幫我檢查 PHP 程式碼是否有錯
Gemini的管理範圍是當前的資料夾，假設你的專案資料夾是my_pj，那就在這個資料夾啟動Gemini。
1. 切換進資料夾
cd ~/Desktop/my_pj
2. 啟動 Gemini CLI
gemini
3. 輸入任何想跟AI溝通的prompt
幫我檢查 @index.php 是否有語法錯誤或潛在 bug，並詳細說明原因。
Gemini 會立即分析 index.php 並列出錯誤行數與建議修正方式，非常強大！
💡 小技巧
| 用法 | 說明 |
|---|---|
| @路徑 | 上傳檔案給 Gemini 分析（ex. @index.php） |
| /指令 |
使用內建的斜線命令 (查看所有內建指令 /help) 你也可以透過 TOML 格式自訂斜線指令 |
| Ctrl + J | 換行 |
| 驚嘆號(!) | 切換至shell mode Shell的執行結果(eg.ls -al)，會變成上下文的一部分。 |
| Ctrl + C | 離開 Gemini CLI |
🎯 結語
Gemini CLI 是非常好用的 AI 助手，尤其適合工程師開發、debug、code review、文件產生等等用途。只要幾個步驟就能讓你的 macOS 終端機變身 AI 互動平台！
備註1：
sudo npm install -g @google/gemini-cli
這是更新Gemini CLI版本的指令，當你在網路上看到一些教學文章，執行指令卻失敗時，有可能是版本太舊導致不支援新指令，這時就要更新一下版本。
備註2：
gemini --approval-mode "auto_edit"
這個指令會告訴 Gemini 模型，在產生回應時自動審查並編輯其內容，以確保符合安全與使用規範。這個指令對於需要自動化內容生成的開發者或使用者來說非常實用，主要有以下優點：
- 提升內容安全性： 它能顯著降低生成不當或有害內容的風險，特別適用於面向大眾或需要嚴格內容把關的應用程式。
- 減少人工審核： 在不需要人工參與的情況下，自動完成內容的初步篩選和修正，大大提升效率。
- 避免中斷： 如果沒有這個模式，當模型生成不安全內容時，可能會直接回報錯誤並停止，導致流程中斷。而 auto_edit 則會嘗試修正，讓流程得以繼續。
備註3：
非互動模式 (non-interactive mode)的進階用法
echo "你的PROMPT" | gemini
cat meeting_notes.txt | gemini "請幫我總結這份會議記錄，並列出三個主要決策。"