Gemini CLI 安裝小記

Gemini CLI 安裝小記

OS: macOS Sonoma 14.3

node.js: 23.10.0

這幾天 Gemini CLI 非常火熱, 所以也來寫一篇小記, 記錄安裝以及收集到的一些資訊

官方中文 Blog 文章

• https://blog.google/intl/zh-tw/products/cloud/gemini-cli-your-open-source-ai-agent/

• 這邊大家會注意到的就是免費授權的使用量 (每分鐘 60 次，每日最多可達 1,000 次的模型執行額度)

授權的部分, 主要會有 3 種方式

• Github 說明 https://github.com/google-gemini/gemini-cli/blob/main/docs/cli/authentication.md

• 使用 Google 登入 ( Gemini Code Assist ) (應該是一般使用者最常開始的方式)

• Gemini API Key

• Vertex AI

接下來嘗試安裝

官方 Github

• https://github.com/google-gemini/gemini-cli/tree/main

首先系統要有 Node.js 18 以上的版本

• 安裝方式請見 https://nodejs.org/en/download

檢查 node.js 版本的方式可以使用 

% node  -v

v23.10.0

我的版本是 23.10.0

安裝的方式大家都是推使用 npm 方式進行安裝

% npm  install  -g  @google/gemini-cli 

• -g 為全域 global

• @google/gemini 為安裝 google的 gemini 套件

使用 gemini 指令啟動

%gemini

一開始會選主題

但是因為我的終端機是用 Basic 所以字會比較不明顯, 這個部分可能要調終端機的描述檔, 或是選自己覺得清楚的 Theme

接下來就是選剛剛提到的授權驗證方式

這邊由於我個人與工作上都有使用 GCP, 所以我碰到要指定 GCP project ID 的狀況

• 可以參考說明 https://github.com/google-gemini/gemini-cli/blob/main/docs/cli/authentication.md#workspace-gca

• 我先用 export  GOOGLE_CLOUD_PROJECT="YOUR_PROJECT_ID" 暫解, 然後儲存到 ~/.zshrc

接下來就可以正常使用

要離開 gemini 就按 Ctrl + C 兩次 或是使用 /quit

離開的時候會顯示相關 token 資訊

目前我的組合技 就是使用 vscode ( 使用 copilot 免費版 + Gemini Code Assist 免費版 ) + 在終端機使用 gemini cli :) 

另外收集與提供有用的資訊

• Jimmy Liao ( https://linktr.ee/jimmyliao )

• 2025/6/28 的簡報 https://drive.google.com/file/d/1m15YfhcBxO9x8EkgzHbNq8SGRDLun5sU/view

• 在 Cloud Shell 這邊的使用方式, 還有遇到問題的解法

• Will 保哥 ( https://github.com/doggy8088  )

• 保哥帶你聽 EP05｜快速上手 Gemini CLI 開發工具 https://youtu.be/0YVUkrqBJPg?si=y8thZF-vREAoClew

• Gemini CLI 使用手冊 https://gemini-cli.gh.miniasp.com/

又前進了一步 :)

~ enjoy it

References

• https://blog.google/intl/zh-tw/products/cloud/gemini-cli-your-open-source-ai-agent/

• https://github.com/google-gemini/gemini-cli/tree/main

• https://github.com/google-gemini/gemini-cli/blob/main/docs/cli/authentication.md#workspace-gca