AiCodeCat Docs

主题

1. 安装 Gemini CLI ​

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

powershell
npm install -g @google/gemini-cli

验证安装：

powershell
gemini --version

2. 配置 Gemini CLI ​

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

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

配置文件路径：

C:\Users\<你的用户名>\.gemini\.env

配置内容：

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

创建步骤

  1. 打开文件资源管理器，进入 C:\Users\<你的用户名>\ 目录
  2. 新建文件夹 .gemini（如已存在则跳过）
  3. 在 .gemini 文件夹中新建文件 .env
  4. 将上述配置内容粘贴到文件中并保存

方法二：环境变量 ​

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

临时设置（当前会话） ​

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

永久设置（用户级） ​

[System.Environment]::SetEnvironmentVariable("GOOGLE_GEMINI_BASE_URL", "https://aicode.cat/v1beta", [System.EnvironmentVariableTarget]::User)
[System.Environment]::SetEnvironmentVariable("GEMINI_API_KEY", "你的API密钥", [System.EnvironmentVariableTarget]::User)
[System.Environment]::SetEnvironmentVariable("GEMINI_MODEL", "gemini-3-pro-preview", [System.EnvironmentVariableTarget]::User)

重启提示

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

3. 开始使用 ​

powershell
gemini

可运行 gemini --help 查看支持的命令。