Skip to main content

概述

Gemini CLI 是 Google 官方推出的命令列工具,允許您在終端中直接與 Gemini AI 模型互動。通過 API易 中轉,您可以:
  • 🚀 在終端中快速呼叫 Gemini 模型
  • 💻 進行 AI 輔助程式設計和程式碼生成
  • 🔍 程式碼審查和最佳化建議
  • 📝 技術問答和文件生成
  • 🌐 跨平臺使用(Linux、macOS、Windows)
為什麼選擇 API易?通過 API易 使用 Gemini CLI,您可以享受更穩定的網路連線、更優惠的價格,以及 7×24 小時技術支援。

快速開始

前置要求

  • Node.js >= 18.0.0
  • npm 或 yarn 包管理器
  • API易 賬號和 API Key

第一步:安裝 Gemini CLI

第二步:獲取 API易 金鑰

1

註冊/登入 API易

訪問 api.apiyi.com 註冊或登入您的賬號
2

建立 API Key

進入後臺「令牌管理」頁面(api.apiyi.com/token),點選「建立新令牌」
3

複製金鑰

複製生成的 API Key(格式:sk-***),妥善儲存

第三步:配置環境變數

重要配置GOOGLE_GEMINI_BASE_URL 必須設定為 https://api.apiyi.com,不能有多餘的路徑(如 /v1/gemini),否則會導致連線失敗。

第四步:初始化和測試

1

啟動 Gemini CLI

2

首次認證

在互動介面中輸入:
選擇:Gemini API Key (AI Studio)
3

測試連線

核心功能

程式碼生成

輸出示例

程式碼審查

技術問答

文件生成

互動式命令

在 Gemini CLI 互動模式下,可以使用以下命令:
模型切換:使用 /model 命令可以在不同的 Gemini 模型之間切換,如 gemini-3-pro-previewgemini-2.5-flashgemini-2.5-pro 等。

支援的模型

通過 API易,您可以使用以下最新 Gemini 模型:

Gemini 3 系列(推薦)

Gemini 2.5 系列

推薦配置
  • 複雜程式設計任務、架構設計:gemini-3-pro-preview
  • 日常程式碼生成、問答:gemini-2.5-flash
  • 批次處理、快速迭代:gemini-2.5-flash-lite

檢視完整模型列表

檢視 API易 支援的所有 Gemini 模型、詳細價格和效能對比

高階用法

VS Code 整合

在 VS Code 中使用 Gemini CLI 擴充套件:

GitHub Actions 整合

自動化程式碼審查:

批處理指令碼

建立自動化指令碼:

常見問題

檢查清單
  1. 環境變數是否正確
    確保輸出為:
    • GOOGLE_GEMINI_BASE_URL: https://api.apiyi.com(不要有 /v1 或其他路徑)
    • GEMINI_API_KEY: sk- 開頭的完整金鑰
  2. 重新載入環境變數
  3. 重啟終端:完全關閉並重新開啟終端視窗
  4. 驗證 API Key:登入 API易 後臺確認 Key 是否有效且餘額充足
在互動模式下使用 /model 命令:
或在命令列直接指定:
方法一:使用 /save 命令
方法二:重定向輸出
方法三:使用會話管理
推薦使用 nvm 管理 Node.js 版本
可能原因和解決方案
  1. 網路問題:API易 提供國內最佳化節點,通常響應很快
  2. 模型選擇:使用 gemini-2.5-flashgemini-2.5-flash-lite 獲得最快響應
  3. Token 限制:減少單次請求的複雜度
  4. 併發請求:避免同時傳送大量請求
測試連線速度
推薦使用 PowerShell
  1. 安裝 Node.js(從官網下載安裝包)
  2. 以管理員身份執行 PowerShell
  3. 設定環境變數:
  4. 重啟 PowerShell
  5. 安裝和使用 Gemini CLI
或使用 WSL(Windows Subsystem for Linux)獲得更好的體驗。

最佳實踐

提示詞最佳化

明確具體

❌ “最佳化這段程式碼”✅ “最佳化這段程式碼的效能,重點關注迴圈效率和記憶體使用”

提供上下文

❌ “這個函式有什麼問題?”✅ “這是一個用於處理使用者登入的函式,目前遇到非同步錯誤,幫我找出問題”

分步驟請求

❌ “幫我完成整個專案”✅ “第一步:設計資料庫模型;第二步:建立 API 路由;第三步:…”

要求示例

❌ “解釋閉包”✅ “解釋 JavaScript 閉包,並給出 3 個實際應用場景和程式碼示例”

工作流建議

1

問題定義

清晰描述要解決的問題或實現的功能
2

獲取方案

使用 Gemini CLI 生成初步解決方案或程式碼
3

審查最佳化

要求 AI 審查自己生成的程式碼,找出潛在問題
4

迭代改進

根據反饋逐步最佳化,直到滿足需求
5

文件補充

生成必要的註釋和文件

價格說明

使用 API易 呼叫 Gemini 模型的費用取決於您選擇的模型和使用量。

檢視詳細價格

檢視所有 Gemini 模型的詳細定價和價效比對比
API易 提供充值優惠:充值越多,加贈比例越高(10%-22%)。首次充值還可獲得額外加贈。檢視 充值活動詳情

相關資源

獲取幫助

企業微信客服

企業微信客服二維碼掃碼新增 或 點選聯絡客服技術諮詢、使用指導

郵件諮詢

客服郵箱[email protected]商務合作[email protected]
快速上手:按照本文的「快速開始」章節,5 分鐘即可完成配置並開始使用 Gemini CLI!