Gemini CLI 配置
Gemini CLI 是 Google 官方推出的命令行工具,深度集成 Gemini 系列模型。接入 521code 后可使用 Gemini 兼容端点调用 Gemini 系列模型。
工具简介
Gemini CLI 主要功能:
- 直接在终端中与 Gemini 对话
- 支持代码生成、解释和调试
- 多模态支持(文本、图像等)
- 支持长上下文处理
安装指南
通过 npm 安装(跨平台)
npm install -g @google/gemini-cli
验证安装
安装完成后,在终端中运行:
gemini --version
启动 Gemini CLI
gemini
521code 接入配置
Gemini CLI 默认使用官方 Google AI API。接入 521code 需要配置环境变量。
环境变量配置
export GOOGLE_API_KEY=""
export GOOGLE_BASE_URL="https://us.efxhp.cn/v1beta"
Gemini 兼容配置示例
521code 提供 Gemini 兼容端点,配置文件示例:
{
"model_provider": "gemini",
"base_url": "https://us.efxhp.cn/v1beta",
"api_key": ""
}
推荐模型示例
gemini-3.1-pro-low(默认推荐)
适合复杂推理、长上下文分析、方案设计。
gemini-3.1-pro-high
适合高质量复杂任务、深度推理和长上下文生产场景。
gemini-3-flash
轻量快速,适合日常对话、轻量任务和快速响应场景。
验证方式
配置完成后,验证连通性:
gemini
# 在对话中输入:你好,请确认连接正常
如果 Gemini 正常回复,说明 521code 接入成功。
常见问题
- 提示 API Key 无效:确认 Key 格式正确,为
sk-开头,且在 521code 控制台已创建。 - 提示模型不存在:确认模型名称属于 521code 当前可用模型列表。
- 连接超时:检查网络状况,确认
https://us.efxhp.cn/v1beta可访问。 - Base URL 注意:Gemini 兼容接口使用
/v1beta路径,不要漏掉。
提示:521code 使用 Gemini 兼容端点(/v1beta)接入 Gemini 系列模型。配置时请确保 Base URL 包含 /v1beta 路径。