PM x Gemini CLI (一):環境設定與專案準備

發布日期:2025年10月25日

本集 Podcast
EP1:AI 老司機的 Gemini CLI 工作流

本篇文章將引導您完成 Gemini CLI 的基礎環境建置,並準備好您的專案工作環境,為後續的深度協作打下堅實基礎。

我們將涵蓋以下要點:

  • 安裝 Node.js,這是 Gemini CLI 的運行基礎。
  • 安裝 Gemini CLI 工具本身。
  • 安裝 Visual Studio Code,並設定必要的擴充功能。
  • 建立專案資料夾,為您的 AI 協作專案做好準備。

步驟一:安裝 Node.js (工具的「地基」)

您可以把 Node.js 想像成蓋房子前的「地基」或「作業系統」。就像您的電腦需要 Windows 或 macOS 才能執行 Word 或 Photoshop 一樣,許多好用的開發工具 (包含我們的主角 Gemini CLI) 都需要先安裝 Node.js 這個穩固的基礎,才能在上面順利運作。

簡單來說,這是第一步,也是最重要的一步。請參考 n8n 教學 (一) 的步驟一,完成 Node.js 的安裝。

步驟二:安裝 Gemini CLI (真正的「AI助理」)

地基打好後,我們來安裝主角 Gemini CLI。安裝 Node.js 時,會附帶一個名為 npm 的小工具,您可以把它想像成「開發工具的 App Store」。我們就是透過這個 App Store 來安裝 Gemini CLI。

接下來,我們要打開一個叫做「終端機」的程式。它可能看起來有點陌生,不像我們平常點擊圖示的操作介面。您可以把它想像成一個**直接跟電腦下指令的對話框**,我們用打字的方式命令電腦做事,非常直接且高效。

小提示:在接下來的文章中,所有指稱「終端機」、「CMD」或「PowerShell」的地方,您都可以把它們想像成是您與 AI 助理進行文字對話的「小黑窗」或「對話視窗」。

Windows

打開「命令提示字元 (CMD)」或「PowerShell」,輸入以下指令後按下 Enter:

npm install -g @google/gemini-cli

💡 這裡的 -g 是個小技巧,代表「安裝在共用區」。這樣不論您在哪個資料夾工作,隨時都能呼叫 Gemini CLI 這個助理。

macOS

打開「終端機 (Terminal)」,輸入以下指令後按下 Enter:

npm install -g @google/gemini-cli

💡 這裡的 -g 是個小技巧,代表「安裝在共用區」。這樣不論您在哪個資料夾工作,隨時都能呼叫 Gemini CLI 這個助理。

如果看到 "permission denied" (權限不足) 的錯誤,別擔心!這只是系統需要您給它管理員權限。請在指令最前面加上 sudo (就像是跟警衛說「我是管理員」),然後再輸入一次密碼即可:

sudo npm install -g @google/gemini-cli

安裝完成後,可以輸入以下指令來「點名」,確認您的 AI 助理是否已成功報到:

gemini -v

如果它回應一串版本號碼 (例如 1.0.0),就代表安裝成功了!

步驟三:安裝 VS Code (我們的「工作室」)

Visual Studio Code (簡稱 VS Code) 是一個功能強大又好用的免費編輯器。您可以把它想像成我們的「數位工作室」,之後所有與 AI 協作的檔案、筆記和程式碼,都會在這裡進行編輯和管理。

Windows

前往 VS Code 官方網站,下載 Windows 安裝檔並完成安裝。

macOS

前往 VS Code 官方網站,下載 macOS 安裝檔並完成安裝。

步驟四:建立專案資料夾 (專屬的「專案檔案櫃」)

在您的電腦上建立一個新的資料夾,作為存放所有 AI 協作專案的「檔案櫃」。建議取一個有意義的名稱,例如專案名稱 gemini-projects,方便日後查找。

💡 您可以使用滑鼠右鍵新增資料夾,也可以在「終端機」中輸入以下指令來建立,體驗一下用指令操作的感覺!

Windows

在您常用的工作區 (例如「文件」),用滑鼠右鍵新增資料夾。

mkdir C:\Users\您的使用者名稱\Documents\gemini-projects

macOS

在您常用的工作區 (例如「文件」),用右鍵新增檔案夾。

mkdir ~/Documents/gemini-projects

步驟五:在 VS Code 開啟專案 (進入「工作室」開始工作)

打開 VS Code,並將您剛剛建立的專案資料夾打開,這代表我們要正式進入工作室,準備開始專案了。

Windows

點擊 VS Code 左上角的「檔案」->「開啟資料夾...」,然後選擇您剛才建立的資料夾。

或者,在終端機裡先切換到專案資料夾,然後輸入 code . (這個點代表「這裡」),讓 VS Code 直接打開目前的資料夾:

cd C:\Users\您的使用者名稱\Documents\gemini-projects
code .

macOS

點擊 VS Code 左上角的「檔案」->「開啟...」,然後選擇您剛才建立的檔案夾。

或者,在終端機裡先切換到專案檔案夾,然後輸入 code .

cd ~/Documents/gemini-projects
code .

步驟六:安裝 Markdown 美化外掛

Gemini CLI 很常以 Markdown 格式回覆我們,這是一種輕量的筆記語法。除此之外,我們也會用這種格式來撰寫 Prompt 跟 AI 溝通,為了讓這種格式的內容在我們的「工作室」(VS Code) 中看起來更漂亮、更像一份正式文件,我們需要安裝一個美化用的外掛。

  1. 打開 VS Code。
  2. 點擊左邊像俄羅斯方塊一樣的「擴充功能」圖示 (快捷鍵 Ctrl+Shift+X)。
  3. 在搜尋框中輸入 Markdown Preview Enhanced
  4. 找到它之後,點擊「安裝」。
VS Code extension marketplace showing Markdown Preview Enhanced
圖:在 VS Code 中安裝 Markdown 美化外掛。

安裝後,當您打開一個 `.md` 結尾的 Markdown 檔案時,就可以點擊 VS Code 右上角的「預覽」按鈕(在縮小按鈕左側),看到它被美化排版後的樣子了。

VS Code and Gemini CLI side-by-side workflow
圖:建議的工作流佈局:一邊是 VS Code 工作室,另一邊是獨立的 Gemini CLI 助理視窗。

本章總結

在本篇文章中,您已經成功:

  • 安裝了 Node.js 和 Gemini CLI。
  • 安裝了 Visual Studio Code,並設定了專案資料夾。
  • 安裝了 Markdown 渲染外掛,提升了文件編輯體驗。

如果您有想交流討論的地方,歡迎到我的 LinkedIn 找我!

前往 LinkedIn