Google Gemini CLI 教學：如何透過 CometAPI 安裝和使用它

Gemini CLI 是 Google 的開源命令列 AI 代理，它將 Gemini 2.5 Pro 的強大功能直接引入到您的終端。它於 25 年 2025 月 60 日發布，透過自然語言提示，為開發者免費提供高級 AI 功能，包括程式碼生成、內容創建、任務自動化等。 Gemini CLI 在免費的 Gemini Code Assist 授權下提供慷慨的使用限制（每分鐘 1,000 個模型請求，每天 XNUMX 個模型請求），並支援 Windows、macOS 和 Linux，可將終端轉變為 AI 驅動的工作空間。

什麼是 Gemini CLI？

Gemini CLI 是由 Google 發布的開源命令列介面，它將 Gemini 2.5 Pro 模型的強大功能直接引入開發者的終端。 Gemini CLI 於 25 年 2025 月 XNUMX 日以預覽版發布，支援 AI 驅動的工作流程——從程式碼生成和調試到內容創建和多模態請求——無需離開 Shell。透過提供自然語言提示、函數呼叫以及 Google 搜尋和模型上下文協定 (MCP) 等整合工具，Gemini CLI 將終端轉變為 AI 優先的工作區，從而減少上下文切換並簡化開發流程。

Gemini CLI 提供哪些核心功能？

自然語言提示：發出簡單的文字提示（例如， gemini run "Generate a REST API in Go."）來接收程式碼、摘要或研究見解。
函數呼叫和工具使用：利用 Google 搜尋、程式碼執行工具或提示中的自訂功能來取得即時資料或執行複雜任務。
多模式支援：線上呼叫 Veo 和 Imagen 模型，直接從 CLI 請求圖像或影片生成。
大型上下文視窗：最多 10,000 個令牌，用於處理大量程式碼庫或長文件。

這些功能將 Gemini CLI 定位為策略工具，適合尋求 AI 驅動的終端體驗且無需管理雲端控制台登入或 SDK 安裝的開發人員。

CometAPI 如何增強 Gemini CLI 體驗？

CometAPI 是一個統一的 REST 接口，它將數百個 AI 模型（包括 Google Gemini、OpenAI 的 GPT 系列、Anthropic 的 Claude 等）聚合在一個端點下，並內建 API 金鑰管理、使用配額和計費儀錶板 ()。透過將 Gemini CLI 與 CometAPI 集成，開發者可以獲得與供應商無關的 Gemini 模型存取權限，而無需處理多個憑證或端點。

使用 CometAPI 和 Gemini CLI 的主要優點是：

簡化端點管理：您無需將 CLI 指向 Google 的預設 API URL，而是將其配置為透過環境變數使用 CometAPI 的基本 URL，從而透過一個介面集中所有 AI 流量。
統一計費和配額：CometAPI 提供具有競爭力的價格（通常低於 Google 官方價格），並提供整合的儀表板來追蹤 Gemini、Claude、GPT 等的使用情況，消除計費孤島。
無縫模型切換：使用 CometAPI，在不同的模型提供者之間切換就像在請求中更改模型參數一樣簡單，從而實現快速實驗和成本控制。

透過利用 CometAPI，團隊可以保持敏捷、不受供應商限制且具有成本效益，同時在其終端中保留 Gemini CLI 的全部功能。

如何安裝 Gemini CLI？

條件：

安裝前，請確保您的系統符合以下要求：

支援的作業系統 （Windows 10/11、macOS 10.15+、Ubuntu 20.04+ 或 Debian 10+）
Node.js v20 或更高版本 （或 v18+ 以實現基本功能）。
NPM （Node 套件管理器）與 Node.js 一起安裝。
A 終端 Linux、macOS 或 Windows 上的環境（PowerShell、WSL 或本機 Bash）。

驗證您的 Node.js 版本：

node -v

如果傳回的版本低於 18，請透過套件管理器進行升級（例如， sudo apt install nodejs npm 在 Ubuntu 上）。

安裝方法

您有 3 個主要選項來安裝 Gemini CLI：

透過 npm 全域安裝

   npm install -g @google/gemini-cli

此全域安裝使 gemini 命令在系統範圍內可用。但是，全域安裝可能會引發版本衝突，並且需要提升權限。

透過 npx 一次性執行

   npx https://github.com/google-gemini/gemini-cli

這可以運行 CLI 而無需永久安裝它，非常適合快速試用或短暫環境。

安裝完成後，透過執行以下命令進行驗證：

gemini --version

如何使用 CometAPI 驗證 Gemini CLI？

身份驗證可確保您的 CLI 會話安全地綁定到 CometAPI 帳戶，從而實現跨模型的統一計費和配額管理。 CometAPI 聚合了 Google Gemini 以及數十家其他供應商，這意味著一個 API 金鑰即可解鎖多個 AI 後端。

如何取得 CometAPI 金鑰？

註冊或登入 at cometapi.com 並導航到儀表板中的“API 令牌”部分。
產生新令牌 點選“新增令牌”。複製產生的金鑰（例如， sk-xxxxxxxxxxxx) 並將其存放在安全的保險庫中。

如何將密鑰連結到 Gemini CLI？

安裝後，調用：

gemini login

此命令將引導您進入瀏覽器中的 Google OAuth 流程。

使用 Gemini CLI https://api.cometapi.com，您將需要兩個關鍵訊息：

**API 金鑰 (GEMINI_API_KEY)**這是您在註冊後獲得的個人存取金鑰 api.cometapi.com 平台（通常以 sk-).

**API 端點（GOOGLE_GEMINI_BASE_URL)**這是我們的API服務端點位址，固定為 https://api.cometapi.com.

# Navigate to your project folder 

cd your-project-folder 

# Set environment variables (replace YOUR_API_KEY with your actual key) export GEMINI_API_KEY=YOUR_API_KEY export GOOGLE_GEMINI_BASE_URL="https://www.cometapi.com/console/"

CLI 開啟瀏覽器窗口，提示您貼上 CometAPI 令牌。
身份驗證成功後，本機設定檔（~/.gemini/config.json）儲存您的憑證，以及所有後續 gemini run 命令透過 CometAPI 的統一網關端點路由（https://api.cometapi.com）。

如何透過 CometAPI 運行 Gemini CLI？

初始啟動和主題選擇

配置完成後，只需輸入以下內容即可啟動 CLI：

gemini

首次運行時，Gemini CLI 會提示您為互動式會話選擇一個顏色主題（預設、深色、日光色等）。此步驟每次安裝僅需執行一次。

身份驗證流程

If GEMINI_KEY GEMINI_BASE_URL 已設置，CLI 將透過標頭自動進行身份驗證，繞過互動式登入。

驗證成功後，會顯示「以...身分登入」訊息以及您目前的使用配額。

驗證連接

透過發出一個簡單的提示來測試您的設定：

gemini "Explain the difference between REST and GraphQL"

您應該會收到透過 CometAPI 閘道擷取的 AI 產生的回應，表示端點覆寫和金鑰處理均已正確設定。

如何將 Gemini CLI 整合到我的開發工作流程中？

常見用例有哪些？

程式碼生成和重構：快速搭建專案腳手架、重構功能或生成單元測試。
錯誤說明：貼上錯誤堆疊追蹤並讓 AI 進行診斷。
文件和評論：自動產生文件字串或 markdown README 部分。
殼牌自動化：將自然語言任務轉換為 shell 命令（例如，「將此資料夾壓縮為 tar.gz 並上傳到 S3」）。

我可以在 CI/CD 中編寫 Gemini CLI 腳本嗎？

當然。由於 Gemini CLI 傳回 JSON 或純文字輸出，您可以在 Shell 腳本中編寫提示符號：

gemini --non-interactive "Optimize this Dockerfile for production" > optimized.Dockerfile

這使得 AI 驅動的優化成為建置管道的一部分。

模型上下文協定 (MCP) 如何運作？

MCP 允許 Gemini CLI 取得即時網路資料。例如，要查詢即時體育賽事比分或股票價格，請使用：

gemini --mcp "What’s the current stock price of GOOGL?"

這種混合方法將語言推理與外部資料來源結合在一起。

我可以即時切換模型嗎？

是的——使用 --model 標誌來選擇 gemini-2.5-pro, gemini-2.0-base或任何未來的變體。這種靈活性使您可以針對速度、成本或上下文大小進行最佳化：

gemini --model gemini-2.0-base "Summarize this file."

透過 CometAPI 使用 Gemini CLI 的最佳實踐和技巧

1. 運行以下命令。

它們會自動將配置附加到 ~/.bash_profile, ~/.bashrc （對於 Bash），以及 ~/.zshrc （適用於 Zsh）。

# Write your API Key to the config files (replace YOUR_API_KEY with your actual key)

echo -e '\nexport GEMINI_API_KEY="YOUR_API_KEY"' >> ~/.bash_profile
echo -e '\nexport GOOGLE_GEMINI_BASE_URL="https://www.cometapi.com/console/"' >> ~/.bash_profile

echo -e '\nexport GEMINI_API_KEY="YOUR_API_KEY"' >> ~/.bashrc
echo -e '\nexport GOOGLE_GEMINI_BASE_URL="https://www.cometapi.com/console/"' >> ~/.bashrc

echo -e '\nexport GEMINI_API_KEY="YOUR_API_KEY"' >> ~/.zshrc
echo -e '\nexport GOOGLE_GEMINI_BASE_URL="https://www.cometapi.com/console/"' >> ~/.zshrc

2. 重啟終端後使用

您必須完全關閉並重新開啟終端 以使更改生效。之後，您只需導航到專案目錄並運行 gemini.

cd your-project-folder
gemini

3.認證失敗怎麼辦？

OAuth 令牌可能會過期或損壞。重新運行：

gemini logout && gemini login

4.延遲和性能如何？

選擇合適的型號：對於輕量級聊天或摘要任務，最好 gemini-2.5-flash-lite-preview-06-17 以較低的成本實現低於 200 毫秒的響應。
大量請求：處理大型資料集時，將提示聚合為更少、更大的調用，以減少 HTTP 開銷和每個請求的延遲。

5.Gemini CLI 有一些方便的內建工具。

您可以使用以下命令：

雙子座 CLI

入門

CometAPI 是一個統一的 API 平台，它將來自領先供應商（例如 OpenAI 的 GPT 系列、Google 的 Gemini、Anthropic 的 Claude、Midjourney、Suno 等）的 500 多個 AI 模型聚合到一個開發者友好的介面中。透過提供一致的身份驗證、請求格式和回應處理，CometAPI 顯著簡化了將 AI 功能整合到您的應用程式中的過程。無論您是建立聊天機器人、影像產生器、音樂作曲家，還是資料驅動的分析流程，CometAPI 都能讓您更快地迭代、控製成本，並保持與供應商的兼容性——同時也能充分利用整個 AI 生態系統的最新突破。

CometAPI 已支援 gemini cli，詳情請參考 DOC使用 CometAPI 上的 Google Gemini CLI 增強您的終端!您可以分析具有 1M+ 令牌上下文的海量程式碼庫，並將想法、圖表甚至 PDF 轉換為程式碼。只需幾分鐘即可整合並開始更聰明地建置。

開發人員可以訪問 Gemini-2.5 Pro 預覽 API Gemini-2.5 Flash Pre API 通過彗星API，列出的最新模型截至本文發布之日。首先，探索模型在游乐场以獲得詳細說明。造訪前請確保您已經登入CometAPI並取得API金鑰。彗星API 提供遠低於官方價格的價格，幫助您整合。

結論

透過將 Google 先進的 Gemini CLI 與 CometAPI 統一且經濟高效的 API 閘道相結合，開發者可以解鎖一個無縫、跨供應商且安全的 AI 終端環境。您將受益於 Gemini 的先進模型、豐富的免費套餐和開源靈活性，而 CometAPI 則簡化了端點管理、計費和模型切換。無論您是編寫程式碼、分析資料還是自動化 DevOps 任務，此整合都將重新定義終端的無限可能，使您能夠更快地迭代、控製成本並始終站在 AI 創新的前沿。