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 模型