開源好用的 Gemini CLI 開發工具與 MCP 簡單設置分享 – Part1

簡單介紹

就上個月底 (6/25)，Google 重磅推出了免費開源的 Gemini CLI 開發工具，目標對象為開發人員，直接將 AI 整合到終端機環境中。

這次谷哥可謂是佛心來著，光是 Gemini CLI 的免費方案就直接調用了 Gemini Pro 2.5 目前最為強悍的核心，而且存取限制與配額可說是誠意滿滿：

• 具備處理100萬個 Token 上下文 (Context) 的能力，這樣就能讓開發人員可以輸入大型程式碼庫、文件和複雜的專案結構。
• 每分鐘 60 次的請求數，這樣慷慨的限制確保了良好的使用體驗。
• 每日最大請求數 1000 次，已是足以充分探索 AI 功能以及開發輕量級的 AI 應用開發。

這裡列出幾個關於 Gemini CLI 的主要特點：

• 免費使用 Gemini 2.5 Pro
  前述已提及的，使用 Google 帳戶即可存取 1百萬 token 上下文 (Context) 的高階模型 (Gemini 2.5 Pro)、每日 1,000 次請求。
• 直觀的命令模式 (command prompt) 操作界面
  雖然是使用命令列模式，但也提供了 ANSI 文字的配色界面，其指令設計相當直觀，不需要記憶複雜的語法。(當然可以透過 /help 指令查詢指令用法)
• 引用 Context 的彈性
  Context 可以使用多種檔案格式 ( md, txt, json, csv, pdf ...) 保存記憶起來，並隨時可以開啟調用；另外也可以將整個專案的資料夾加入 Context，如此就可以分析專案的整個結構與脈絡。
• 支持 MCP (Model Context Protocol) 協議
  這是 Gemini CLI 的最大亮點之一，讓開發人員可以輕易地調用各種特定功能的 MCP Server，以此來擴展增強 Gemini CLI 功能。

簡易安裝與設置

安裝 Gemini CLI

安裝方式相當簡單，可以參考官方 Github 上 README 文件其中 Quickstart 一節說明。

我是在 Windows 11 的環境下安裝與設置的，Gemini CLI 前置需要 Node.js v20 以上的版本，鑒於 Node.js 版本迭代更新太快，建議是¹安裝 LTS 版本 (我是安裝 v22.17.0 (LTS) )。

再來以系統管理員身分開啟 PowerShell 或 命列提示字元，執行以下安裝命令並執行 CLI：

> npm install -g @google/gemini-cli
> gemini

第一次啟動時會要求作驗證。如果是免費方案那麼就使用 Google 帳號網頁登入方式來驗證，如此可享有 1000/天 次的請求；否則如選 API Key 的認證方式，則每天只能調用 100 次請求，差很多。

啟動後的命令模式操作界面如下圖：

畫面下方列出四點的提示，可以直接問問題、編輯與執行命令、創建 GEMINI.md 檔案可以自訂與 CLI 互動方式。提示也說明了與 CLI 互動時需要提供具體明確的指令或問題，而不是模糊或籠統的要求，也可以使用 /help 來取得更多的資訊。

1. 安裝 Node.js 過程中有個選項是否要自動安裝必要的工具。建議是不要勾選，它會自動下載 Python、VS 建構工具與套件管理等工具，會讓整個安裝變得很繁雜。 ↩︎

操作實例 - 解析 C# 專案目錄並生成結構樹與說明

一開始使用其實不用想得太過複雜，既然是用於開發環境，所以我將目錄移至授課所用到的 C# 範例所在目錄 - PetStoreSolution，然後執行 gemini，在對話框輸入給予的提示詞 (Prompt)：

> 請生成該 C# 專案目錄的程式碼結構樹,使用 Ascii 方式呈現，並為主要的程式碼檔案作簡單描述

我也並沒有修飾該提示詞的用語，很直覺的就將我的需求口語化打字出來。效果確實令人滿意，沒多久就把專案的整個目錄結構以 Ascii 方式呈現出來，而且在每一個主要的檔案上加上註解說明。

VSCode 整合

其實現階段 Gemini CLI 並沒有提供如 Copilot 插件方式與 VSCode 整合 (預期應該不久的將來會提供的)，但在實務上只需在 VSCode 的終端機直接執行 CLI 就可以整合進開發環境中。

例如我在 VSCode 內開啟了我所編寫的設計模式一書內 (預期今年10月份出版實體書籍) 的 C# 設計模式實例，同樣我先把目錄切到其中 Adapter 資料夾內，然後在內建的終端機執行 CLI，對話框寫入提示詞：

> 請描述 Adapter 目錄內的結構與主要的元件

Gemini CLI 就把 Adapter 模式最重要的核心結構 (./Adapter 子目錄) 內的主要檔案作了詳細的說明。不過其實我是希望 AI 能幫我把該範例模式所有子目錄內的檔案全都描述出來，這很顯然就需要再優化提示詞。

而且如果我需要一再重複使用整理過後的提示詞，應用在其它範例目錄甚或其它專案上，那麼就可以將提示詞保存到 " .gemini/GEMINI.md" 檔案。其中 ".gemini" 如果是 Windows 環境則預設位於 "C:\Users\your-name\.gemini" 資料夾。

這個 ".GEMINI.md" 檔案是客製化的要點，例如設置 MCP Server、設置完善的提示詞等都是整理在這個檔案內的。不過目前官方還沒有提供完整的文件說明，需要參考網路上一些大神們的範本，例如這份「使用AI Agent 輔助開發的寫作指南」，就以 Markdown 格式詳細列舉出了撰寫 C++ 的開發風格要求。