Skip to Content
工具接入指南Gemini CLI 接入指南

安装 Gemini CLI

如果你还没有安装 Gemini CLI,先执行:

npm install -g @google/gemini-cli

执行gemini --version后,如果能输出版本号,就说明安装成功了。

环境变量配置文件位置

  • Mac: ~/.zshrc(zsh)~/.bash_profile(MacOS独有)、~/.bashrc(bash)
  • Linux: ~/.zshrc(zsh)~/.bashrc(bash)
  • Windows: 在Windows菜单搜索”编辑系统环境变量” -> “高级”中选择”环境变量” -> 在”系统变量”中新建或更新配置。

如果在Mac/Linux下没有发现上面提到的任何配置文件,也可以新建一个~/.bashrc配置文件来使用。

配置 API Key

登录后在 API密钥 页面中创建并复制一个API Key. 在环境变量配置文件或系统变量(Windows)中添加如下配置:

export GOOGLE_GEMINI_BASE_URL="https://api.zlux.ai/gemini" export GEMINI_API_KEY="替换为你的 API Key"

启动Gemini

重启终端 后,运行如下命令:

gemini

按键盘上的方向键选择 Use Gemini API Key, 然后输入申请的API Key,回车后即可使用。

常见问题

  • 代理未生效?
    • 配置完成后一定要重启终端,这样环境变量的更改才能生效。
    • 先确认GOOGLE_GEMINI_BASE_URL是不是https://api.zlux.ai/gemini
    • 再确认GEMINI_API_KEY是不是 Zlux 的 API Key。
    • 如果用了 sandbox,先改成--sandbox=false复测。
最后更新于