跳到主要内容

Gemini CLI Mac 使用指南

(一) 安装 Node.js 环境​

Gemini CLI 需要 Node.js 环境才能运行。

macOS 安装方法​

方法一：使用 Homebrew（推荐）

如果你已经安装了 Homebrew，使用它安装 Node.js 会更方便：

# 更新 Homebrew
brew update

# 安装 Node.js
brew install node

方法二：官网下载

  1. 访问 https://nodejs.org/
  2. 下载适合 macOS 的 LTS 版本
  3. 打开下载的 .pkg 文件
  4. 按照安装程序指引完成安装
macOS 注意事项
  • 如果遇到权限问题，可能需要使用 sudo
  • 首次运行可能需要在系统偏好设置中允许
  • 建议使用 Terminal 或 iTerm2

验证安装是否成功​

安装完成后，打开 Terminal，输入以下命令：

node --version
npm --version

如果显示版本号，说明安装成功了！

(二) 安装 Gemini CLI​

安装 Gemini CLI​

打开 Terminal，运行以下命令：

# 全局安装 Gemini CLI
npm install -g @google/gemini-cli

如果遇到权限问题，可以使用 sudo：

sudo npm install -g @google/gemini-cli

验证安装​

安装完成后，输入以下命令检查是否安装成功：

gemini --version

(三) 配置 Gemini CLI​

方法一（推荐）：通过配置文件设置​

在 ~/.gemini 目录下创建配置文件（如果目录不存在则创建）。

创建配置文件，添加以下内容：

{
  "CODE_ASSIST_ENDPOINT": "https://bytecatcode.org/",
  "GOOGLE_CLOUD_ACCESS_TOKEN": "你的API密钥",
  "GOOGLE_GENAI_USE_GCA": "true"
}

方法二：通过环境变量设置​

临时设置（当前会话）

export CODE_ASSIST_ENDPOINT="https://bytecatcode.org/"
export GOOGLE_CLOUD_ACCESS_TOKEN="你的API密钥"
export GOOGLE_GENAI_USE_GCA="true"
备注

使用与 Claude Code 相同的 API 密钥即可。

永久设置

对于 zsh（默认）：

echo 'export CODE_ASSIST_ENDPOINT="https://bytecatcode.org/"' >> ~/.zshrc
echo 'export GOOGLE_CLOUD_ACCESS_TOKEN="你的API密钥"' >> ~/.zshrc
echo 'export GOOGLE_GENAI_USE_GCA="true"' >> ~/.zshrc
source ~/.zshrc

对于 bash：

echo 'export CODE_ASSIST_ENDPOINT="https://bytecatcode.org/"' >> ~/.bash_profile
echo 'export GOOGLE_CLOUD_ACCESS_TOKEN="你的API密钥"' >> ~/.bash_profile
echo 'export GOOGLE_GENAI_USE_GCA="true"' >> ~/.bash_profile
source ~/.bash_profile

验证环境变量​

echo $CODE_ASSIST_ENDPOINT
echo $GOOGLE_CLOUD_ACCESS_TOKEN
echo $GOOGLE_GENAI_USE_GCA

(四) 开始使用 Gemini CLI​

启动 Gemini CLI​

配置完成后，在 Terminal 中输入以下命令启动：

gemini

基本使用​

  • 交互模式：直接输入 gemini 进入交互式对话
  • 指定项目：在项目目录下运行 gemini，会自动识别项目上下文
  • 退出程序：输入 exit 或按 Ctrl+C 退出