开局一张图
首先 如何安装 Gemini CLI?
前提条件 node 版本需要 18 以上,查看 node 版本请控制台使用 node -v 查看
方法一:直接运行(无需安装)
npx https://github.com/google-gemini/gemini-cli
方法二:全局安装(推荐) 在“终端”里输入如下命令行,然后按回车键运行(使用 sudo 时会提示你输入当前用户的密码):
` npm install -g @google/gemini-cli
// 或(适用于 Mac)
sudo npm install -g @google/gemini-cli`
安装完成后,输入 gemini 即可启动交互式 CLI。首次运行会请求一些权限,确认即可。
首次配置引导
启用后,CLI 会引导你完成以下设置:
步骤 1:选择主题风格
根据提示,选择默认主题或其他可选主题,按下回车键继续:
步骤 2:选择登录方式
接着,选择认证方式,这里选择“Login with Google”,因为它默认支持每分钟 60 次、每天 1000 次的免费请求 , 选择后按下回车键确认。
tips:如果你需要更高的请求频率或企业级访问,那么可以使用Gemini API Key,需要购买 Gemini Code Assist 订阅
问题点
通过账号登录提示账号需要设置环境变量,首先需要在Google Cloud 中获取项目 id
其次,项目中的账号需要添加以下角色:
点击后面的编辑图标进入,点击添加其他角色,挨个添加即可
然后就可以进行环境变量配置,推荐进行永久配置。以下提供的为 mac 版本的配置:
1. 确定你使用的 Shell
首先,你需要知道你当前使用的是哪个 Shell。在终端中运行以下命令:
echo $SHELL
- 如果输出是
/bin/zsh,你使用的是 Zsh。 - 如果输出是
/bin/bash,你使用的是 Bash。
2. 根据你的 Shell 修改配置文件
如果你使用 Zsh (推荐且 Mac 默认)
Zsh 的配置文件通常是 ~/.zshrc。
- 打开终端。
- 使用文本编辑器打开
.zshrc文件: 你可以使用open命令在默认的文本编辑器中打开:
open ~/.zshrc
- 添加环境变量: 在文件的末尾添加以下行,将
YOUR_PROJECT_ID替换为你的实际 Google Cloud 项目 ID(例如my-gemini-project-12345):
export GOOGLE_CLOUD_PROJECT="my-gemini-cli-project"
-
保存并关闭文件。
-
使配置生效: 关闭当前终端窗口并重新打开,或者在当前终端中运行以下命令:
source ~/.zshrc
现在你可以再次尝试 Gemini CLI 的登录操作了。