欢迎使用 UniVibe 原版代理服务！本指南将帮助您在 macOS 系统上配置 Gemini CLI。

• macOS 10.15 (Catalina) 或更高版本
• Node.js 环境（版本 18 或更高）
• 有效的 UniVibe API 密钥

1. 安装 Node.js 环境

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

方法一：使用 Homebrew（推荐）

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

# 更新 Homebrew brew update

# 安装 Node.js brew install node

如果尚未安装 Homebrew：

访问 https://brew.sh/ 或在终端运行以下命令安装：

/bin/bash -c “\((curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

方法二：官网下载

1. 访问 https://nodejs.org/
2. 点击 "LTS" 版本进行下载（推荐长期支持版本）
3. 下载完成后打开 .pkg 文件
4. 按照安装向导完成安装，保持默认设置即可

验证 Node.js 安装

安装完成后，打开终端（Terminal 或 iTerm2），输入以下命令：

node --version npm --version

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

macOS 注意事项：

• 如果遇到权限问题，可能需要使用 sudo 命令
• 首次运行某些命令时，系统可能会提示安全设置
• 推荐使用 Terminal 或 iTerm2 作为终端工具

2. 安装 Gemini CLI

打开终端，运行以下命令：

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

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

sudo npm install -g @google/gemini-cli

这个命令会从 npm 官方仓库下载并安装最新版本的 Gemini CLI。

验证 Gemini CLI 安装

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

gemini --version

如果显示版本号，恭喜你！Gemini CLI 已经成功安装了。

提示：

• 如果提示找不到命令，尝试重新打开终端窗口
• 某些情况下可能需要重新加载 shell 配置文件

3. 获取 API 密钥

国内用户可以使用的UniVibe ，可在 Claude Code、Codex、Cursor 等等多款官方工具客户端间通用。

可以免费使用Claude Code、CodeX一系列AI编程工具：

https://www.univibe.cc/console/auth?type=register&invite=BVWMUO

登录 UniVibe 控制台，在 API密钥 页面创建一个新的密钥。

💡 请妥善保管您的 API 密钥，不要泄露给他人。

4. 设置环境变量

为了让 Gemini CLI 连接到 UniVibe 服务，需要设置两个环境变量。

确定你使用的 Shell

macOS Catalina (10.15) 及更高版本默认使用 zsh，而较早版本使用 bash。

检查当前 shell：

echo \)SHELL

• 如果显示 /bin/zsh，使用 zsh 配置方法
• 如果显示 /bin/bash，使用 bash 配置方法

方法一：临时设置（当前会话）

在终端中运行以下命令：

export GOOGLE_GEMINI_BASE_URL=”https://api.univibe.cc/gemini” export GEMINI_API_KEY=“你的API密钥”

💡 记得将 你的API密钥 替换为在上方 API Keys 标签页中创建的实际密钥。

注意： 这种方式只在当前终端会话有效，关闭终端后需要重新设置。

方法二：永久设置（推荐）

对于 zsh（macOS Catalina 及更高版本）：

# 编辑 .zshrc 文件 echo ‘export GOOGLE_GEMINI_BASE_URL=”> ~/.zshrc" target="_blank">https://api.univibe.cc/gemini”’ >> ~/.zshrc echo ‘export GEMINI_API_KEY=“你的API密钥”’ >> ~/.zshrc

# 重新加载配置 source /.zshrc

对于 bash（较早版本 macOS）：

# 编辑 .bash_profile 文件 echo ‘export GOOGLE_GEMINI_BASE_URL=”> " target="_blank">https://api.univibe.cc/gemini”’ >> 

# 重新加载配置 source /.bash_profile

方法三：手动编辑配置文件

# 使用 nano 编辑器 nano 

# 或使用 vim 编辑器 vim /.zshrc

对于 bash：

# 使用 nano 编辑器 nano 

# 或使用 vim 编辑器 vim /.bash_profile

在文件末尾添加以下内容：

export GOOGLE_GEMINI_BASE_URL=”https://api.univibe.cc/gemini” export GEMINI_API_KEY=“你的API密钥”

# zsh source 

# bash source ~/.bash_profile

验证环境变量设置

设置完环境变量后，可以通过以下命令验证是否设置成功：

echo \(GOOGLE_GEMINI_BASE_URL echo \)GEMINI_API_KEY

预期输出示例：

https://api.univibe.cc/gemini cr_xxxxxxxxxxxxxxxxxx

💡 如果输出为空，说明环境变量设置失败，请检查配置文件并重新加载。

5. 开始使用 Gemini CLI

现在你可以开始使用 Gemini CLI 了！

启动 Gemini CLI

gemini

首次启动配置

首次启动 Gemini CLI 时，会出现配置界面：

1. 使用方向键↓（下键）选中 “Use Gemini API Key” 选项
2. 按下回车键确认选择
3. 提示输入 API Key 时，直接按回车（因为已经通过环境变量设置了）
4. 进入对话界面，即可开始使用

在特定项目中使用

# 进入你的项目目录 cd /path/to/your/project

# 启动 Gemini CLI gemini

6. 使用 Gemini 3 Pro 模型 🚀

Gemini CLI 支持强大的 Gemini 3 Pro 模型，提供更优秀的编程辅助能力。

启用 Gemini 3 Pro 模型

在 Gemini CLI 对话界面中按照以下步骤操作：

第一步：启用预览功能

1. 输入命令：/settings
2. 找到 Preview Features 选项
3. 将其切换为 true
4. 按 ESC 键退出设置

第二步：切换模型

1. 输入命令：/model
2. 选择 Pro (gemini-3-pro-preview, gemini-2.5-pro) 模型
3. 确认后即可使用 Gemini 3 Pro 模型

可用的 Gemini 模型

💡 提示： Gemini 3 Pro 模型提供最强大的推理能力，适合处理复杂的编程任务和架构设计。