Skip to main content

​
安装与更新

macOS Homebrew 安装
brew install gemini-cli
NPM 安装确保 npm 全局路径已添加到 PATH
npm config get prefix
# 添加到 PATH
echo 'export PATH="$HOME/.npm-global/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc
Homebrew
brew upgrade gemini-cli
NPM
npm install -g @google/gemini-cli
排查步骤
  1. 检查网络连接
  2. 确保 Node.js 18+ 已安装（NPM 方式）
  3. 确保有管理员权限（Windows）或使用 sudo（macOS/Linux）
  4. 使用镜像源（npm 可使用 --registry 参数）

​
配置问题

  • macOS/Linux: ~/.gemini/
  • Windows: C:\Users\你的用户名\.gemini\
只需要一个文件：.env
Gemini 端点不包含 /v1 路径
GOOGLE_GEMINI_BASE_URL=https://code.rayinai.com
正确的 .env 文件格式
GOOGLE_GEMINI_BASE_URL=https://code.rayinai.com
GEMINI_API_KEY=your-api-key-here
GEMINI_MODEL=gemini-3-pro-preview
不要使用引号包裹值
检查配置文件
cat ~/.gemini/.env
# 测试网络连接
curl -I https://code.rayinai.com
确认 .env 文件中的配置正确

​
使用问题

启动 Gemini CLI 后，发送测试消息
gemini
在对话界面输入：
你好，请帮我创建一个 Python 的 hello world 程序
如果正常响应，说明配置成功
现状说明Gemini CLI 目前存在一些使用问题，例如可能无法正常调用模型、无法粘贴图片推荐方式
  • 优先使用第三方 VS Code 插件（如 Cline）
  • 使用 OpenAI 兼容格式接入
如遇到问题，可以考虑使用其他编辑器插件替代 Gemini CLI

​
错误排查

  • 确认密钥已正确复制（无多余空格）
  • 检查密钥是否在有效期内
  • 验证账户权限是否正常
  • Gemini 使用 https://code.rayinai.com（无 /v1）

​
其他问题

联系技术支持

如果以上方法无法解决问题，请联系技术支持