Gemini CLI 設定教學課程

📋 前置準備

在開始之前，請確保你已經：

• 註冊了 Koze 帳號並登入
• 在 API 管理 頁面創建了一把 API Key
• 已安裝 Gemini CLI（npm install -g @anthropic-ai/gemini-cli 或參考 官方倉庫）

🚀 方式一：透過 Gemini API 方式存取（建議）

在終端機中設定以下環境變數：

# 設定 Koze Gemini 代理地址
export GOOGLE_GEMINI_BASE_URL="https://api.kozeai.com/gemini"
# 設定你的 Koze API Key
export GEMINI_API_KEY="你的API金鑰"
# 指定使用的模型
export GEMINI_MODEL="gemini-2.5-pro"

認證方式：啟動時選擇 Use Gemini API Key。如果提示輸入 API Key，直接按回車留空即可。

💡 如果啟動時自動跳到 Google 登入頁面，請刪除 ~/.gemini/settings.json 後重新啟動。

🔧 方式二：透過 Code Assist API 方式接取

另一種存取方式，適用於部分特殊場景：

# 設定 Code Assist 端點
export CODE_ASSIST_ENDPOINT="https://api.kozeai.com/gemini"
# 設定 Access Token（使用你的 Koze API Key）
export GOOGLE_CLOUD_ACCESS_TOKEN="你的API金鑰"
# 啟用 GCA 模式
export GOOGLE_GENAI_USE_GCA="true"
# 指定模型
export GEMINI_MODEL="gemini-2.5-pro"

認證方式：啟動時選擇 Login with Google。

⚠️ 注意：Gemini CLI 控制台可能提示 Failed to fetch user info: 401 Unauthorized，這是正常現象，不影響使用。

🎯 步驟三：啟動 Gemini CLI

配置完成後，在終端啟動：

gemini

📌 持久化環境變數

建議將環境變數寫入 shell 設定檔（方式一為例）：

# Zsh 用戶
cat >> ~/.zshrc << 'EOF'
export GOOGLE_GEMINI_BASE_URL="https://api.kozeai.com/gemini"
export GEMINI_API_KEY="你的API金鑰"
export GEMINI_MODEL="gemini-2.5-pro"
EOF
source ~/.zshrc

📌 可用模型

模型名稱	說明
gemini-2.5-pro	Gemini 2.5 Pro，最新一代高性能模型
gemini-2.5-flash	Gemini 2.5 Flash，速度更快性價比更高
gemini-2.0-flash	Gemini 2.0 Flash

⚠️ 常見問題

問題	解決方案
啟動後自動跳轉 Google 登入	刪除 ~/.gemini/settings.json 後再試
提示 401 Unauthorized	這是正常提示，不影響使用，忽略即可
模型不可用	在 Koze 模型大廳確認當前套餐是否包含 Gemini 模型