Gemini CLI 速查表

您最常用的 Gemini CLI 指令和旗標的快速參考指南。

基本用法

gemini "你的提示詞在此"

最基本的指令。向 Gemini 模型傳送一個提示，並印出回應。

例如：gemini "世界上最大的5個城市是哪些？"

npx @google/generative-ai '...'

無需永久安裝即可執行 Gemini CLI。非常適合快速測試或不常使用的情況。

例如：npx @google/generative-ai "為一個科技部落格建議一個好名字。"

檔案與輸入處理

gemini -f [檔案路徑] '...'

將檔案內容作為提示上下文的一部分。檔案內容會前置於你的提示詞。

例如：gemini -f readme.md "總結這個README檔案。"

cat [檔案路徑] | gemini '...'

將檔案內容（或任何標準輸出）透過管道直接傳遞給 Gemini CLI 作為其上下文。

例如：cat package.json | gemini '解釋這些依賴項的用途。'

ls -l | gemini '...'

將任何指令的輸出透過管道傳遞給 Gemini。用於解釋系統資訊非常有用。

例如：ls -l | gemini '這個目錄中最大的檔案是哪個？'

輸出與模型控制

gemini ... --json

將輸出格式化為 JSON 物件。對於編寫腳本和自動化非常有用。

例如：gemini "列出3種顏色" --json

gemini ... --model [模型名稱]

指定用於查詢的 Gemini 模型（例如, gemini-1.5-pro-latest, gemini-1.0-pro）。

例如：gemini "把這個翻譯成法文" --model gemini-1.5-flash-latest

gemini ... --temperature [0.0-1.0]

控制回應的創造力。較低的值（如0.2）更具確定性，較高的值（如0.9）更具創造性。

例如：gemini "為一家咖啡店寫一句標語" --temperature 0.9

專業技巧與進階用法

export GOOGLE_API_KEY="YOUR_KEY"

將您的 API 金鑰設定為環境變數，這樣您就不必在每個指令中都提供它。

例如：將此行新增至您的 .bashrc 或 .zshrc 檔案中以實現持久性。

gemini -f code.js "重構此程式碼。僅輸出原始的、更新後的程式碼。"

使用提示來控制輸出格式。當您想將輸出直接管道傳輸到新檔案時，請求「原始程式碼」很有幫助。

例如：gemini -f old.py "..." > new.py

系統與網路工具

gemini '將目前目錄中的檔案以表格形式列出'

執行 `ls` 指令並理解其輸出。您可以要求特定的格式或分析。

例如：gemini '遞迴顯示 src 資料夾的內容，並找出所有的 .css 檔案'

gemini '在 `components` 目錄中尋找 `useState` 的所有實例'

在檔案內容中執行 `grep` 搜尋。對於程式碼分析和發現很有用。

例如：gemini '在所有 `.ts` 檔案中搜尋文字 `TODO:`。'

gemini '尋找 `src/blog` 資料夾中的所有 markdown 檔案'

使用 glob 模式按路徑尋找檔案。代理程式通常會讀取或分析這些檔案。

例如：gemini '讀取部落格中所有的 `.md` 檔案，並為我提供每個檔案的摘要。'

gemini '在網路上搜尋關於 AI 的最新消息'

使用 Google 搜尋執行網路搜尋，以回答有關時事或最新資訊的問題。

例如：gemini '上一次 Google I/O 大會的主要發布內容是什麼？'

gemini '記住我偏好使用 pnpm 進行套件管理。'

允許代理程式記住特定的事實或偏好，以用於將來的互動。

例如：gemini '從現在開始，當你建議安裝一個套件時，請使用 pnpm。' '好的，我會記得使用 pnpm。'

gemini '執行指令 `npm run test` 並告訴我是否成功。'

執行任意 shell 指令並分析其輸出。這是一個非常強大但有潛在危險的工具。

例如：gemini '使用 npm 安裝 `is-odd` 套件，然後編寫一個 node 指令碼來使用它。'