跳到主要内容

Gemini CLI Linux 使用指南

(一) 安装 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 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 密钥即可。

永久设置

对于 bash（默认）：

echo 'export CODE_ASSIST_ENDPOINT="https://bytecatcode.org/"' >> ~/.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://bytecatcode.org/"' >> ~/.zshrc
echo 'export GOOGLE_CLOUD_ACCESS_TOKEN="你的API密钥"' >> ~/.zshrc
echo 'export GOOGLE_GENAI_USE_GCA="true"' >> ~/.zshrc
source ~/.zshrc

验证环境变量​

echo $CODE_ASSIST_ENDPOINT
echo $GOOGLE_CLOUD_ACCESS_TOKEN
echo $GOOGLE_GENAI_USE_GCA

(四) 开始使用 Gemini CLI​

启动 Gemini CLI​

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

gemini

基本使用​

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