Gemini Mac使用指南

强烈推荐：优先使用 install_script_macos.sh 一键完成全部环境部署。只要遇到安装或配置问题，第一选择就是重新运行该脚本。

(一) 一键安装脚本（推荐）

想一次性完成 Node.js、npm 镜像、Claude Code / Codex / Gemini / Droid CLI / OpenClaw 以及环境变量配置，请优先使用随文档提供的 install_script_macos.sh，而不是手动逐步安装。

1. 下载或找到官方一键安装脚本 install_script_macos.sh。
2. 打开 Terminal，赋予执行权限并运行：

   chmod +x install_script_macos.sh
   bash install_script_macos.sh

3. 按照脚本提示依次完成：
4. 检查 / 安装 Homebrew（推荐，可选国内镜像加速）。
5. 检查 / 安装 Node.js 和 npm。
6. 将 npm 源切换为 https://registry.npmmirror.com。
7. 安装或更新 Claude Code / Codex CLI / Gemini CLI / Droid CLI / OpenClaw。
8. 提示输入 API Base 和 API Token，脚本会自动写入环境变量和配置文件。
9. 脚本执行结束后，加载环境变量并验证：

   source ~/.zshrc  # 或 source ~/.bash_profile
   gemini --version

只有在不方便使用脚本或脚本执行失败时，才需要参考下面的"手动安装"步骤。

---

(二) 手动安装 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 i -g @google/gemini-cli

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

sudo npm i -g @google/gemini-cli

验证 Gemini CLI 安装

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

gemini --version

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

---

(三) 设置环境变量

配置 Gemini CLI 环境变量

如果你使用 Gemini CLI，需要设置以下环境变量：

Terminal 设置方法

在 Terminal 中运行以下命令：

export CODE_ASSIST_ENDPOINT="https://api.share-ai.woolen.wang"
export GOOGLE_CLOUD_ACCESS_TOKEN="你的API密钥"
export GOOGLE_GENAI_USE_GCA="true"

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

永久设置方法

添加到你的 shell 配置文件：

对于 zsh (默认)：

echo 'export CODE_ASSIST_ENDPOINT="https://api.share-ai.woolen.wang"' >> ~/.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://api.share-ai.woolen.wang"' >> ~/.bash_profile
echo 'export GOOGLE_CLOUD_ACCESS_TOKEN="你的API密钥"' >> ~/.bash_profile
echo 'export GOOGLE_GENAI_USE_GCA="true"' >> ~/.bash_profile
source ~/.bash_profile

验证 Gemini CLI 环境变量

在 Terminal 中验证：

echo $CODE_ASSIST_ENDPOINT
echo $GOOGLE_CLOUD_ACCESS_TOKEN
echo $GOOGLE_GENAI_USE_GCA

---