Gemini Linux使用指南

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

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

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

1. 下载或找到官方一键安装脚本 install_script.sh。
2. 赋予执行权限并以 root 身份运行：

   chmod +x install_script.sh
   sudo bash install_script.sh

3. 按照脚本提示依次完成：
4. 自动检测系统类型（Ubuntu/CentOS/Arch 等），使用对应包管理器安装依赖。
5. 从淘宝镜像下载安装 Node.js v20+。
6. 将 npm 源切换为 https://registry.npmmirror.com。
7. 安装或更新 Claude Code / Codex CLI / Gemini CLI / Droid CLI / OpenClaw。
8. 提示输入 API Base 和 API Token，脚本会自动写入环境变量和配置文件。
9. 脚本执行结束后，加载环境变量并验证：

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

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

---

(二) 手动安装 Node.js 环境

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

Linux 安装方法

方法一：使用官方仓库（推荐）

# 添加 NodeSource 仓库
curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash -
# 安装 Node.js
sudo apt-get install -y nodejs

方法二：使用系统包管理器

虽然版本可能不是最新的，但对于基本使用已经足够：

# Ubuntu/Debian
sudo apt update
sudo apt install nodejs npm
# CentOS/RHEL/Fedora
sudo dnf install nodejs npm

Linux 注意事项

• 某些发行版可能需要安装额外的依赖
• 如果遇到权限问题，使用 sudo
• 确保你的用户在 npm 的全局目录有写权限

验证安装是否成功

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

node --version
npm --version

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

---

(二) 安装 Gemini CLI

安装 Gemini CLI

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

# 全局安装 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，需要设置以下环境变量：

终端设置方法

在终端中运行以下命令：

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 配置文件：

对于 bash (默认)：

echo 'export CODE_ASSIST_ENDPOINT="https://api.share-ai.woolen.wang"' >> ~/.bashrc
echo 'export GOOGLE_CLOUD_ACCESS_TOKEN="你的API密钥"' >> ~/.bashrc
echo 'export GOOGLE_GENAI_USE_GCA="true"' >> ~/.bashrc
source ~/.bashrc

对于 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

验证 Gemini CLI 环境变量

在终端中验证：

echo $CODE_ASSIST_ENDPOINT
echo $GOOGLE_CLOUD_ACCESS_TOKEN
echo $GOOGLE_GENAI_USE_GCA

---