1. 安装 Gemini CLI

最低要求：Node.js >=20。

npm install -g @google/gemini-cli

验证安装：

gemini --version

2. 配置 Gemini CLI

方法一：配置文件（推荐）

在用户目录下创建 .gemini 文件夹和 .env 配置文件：

配置文件路径：

~/.gemini/.env

配置内容：

GOOGLE_GEMINI_BASE_URL=https://aicode.cat/v1beta
GEMINI_API_KEY=你的API密钥
GEMINI_MODEL=gemini-3-pro-preview

创建步骤

# 创建 .gemini 目录（如已存在则跳过）
mkdir -p ~/.gemini

# 创建并编辑配置文件
nano ~/.gemini/.env

将上述配置内容粘贴到文件中并保存（Ctrl+O 保存，Ctrl+X 退出）。

方法二：环境变量

如果不想使用配置文件，也可以通过环境变量配置：

临时设置（当前终端）

export GOOGLE_GEMINI_BASE_URL="https://aicode.cat/v1beta"
export GEMINI_API_KEY="你的API密钥"
export GEMINI_MODEL="gemini-3-pro-preview"

永久设置（写入 ~/.zshrc）

export GOOGLE_GEMINI_BASE_URL="https://aicode.cat/v1beta"
export GEMINI_API_KEY="你的API密钥"
export GEMINI_MODEL="gemini-3-pro-preview"

执行：

source ~/.zshrc

重启提示

配置完成后需要重启终端才能生效。如果在 VS Code / Cursor 等 IDE 的集成终端中使用，需要彻底重启整个 IDE（不只是重启终端），否则配置可能不会生效。

3. 开始使用

gemini

可运行 gemini --help 查看命令说明。