Gemini CLI

准备好 ViVi-API 控制台创建的令牌 Key，并确认分组支持所选模型。已有配置请先备份，再合并所需字段。

1. 安装与检查

准备 Node.js 20 或更新版本和 npm，然后执行：

node --version
npm install -g @google/gemini-cli
gemini --version

2. 配置环境变量

Windows PowerShell
macOS / Linux

当前终端生效：

$env:GOOGLE_GEMINI_BASE_URL = "https://api.viviai.cc"
$env:GEMINI_API_KEY = "sk-your-api-key"

如需保存为当前用户的环境变量，可选执行：

[System.Environment]::SetEnvironmentVariable('GOOGLE_GEMINI_BASE_URL', 'https://api.viviai.cc', 'User')
[System.Environment]::SetEnvironmentVariable('GEMINI_API_KEY', 'sk-your-api-key', 'User')

用户环境变量保存后，新开的终端才会自动读取。

当前终端生效：

export GOOGLE_GEMINI_BASE_URL="https://api.viviai.cc"
export GEMINI_API_KEY="sk-your-api-key"

使用 Zsh 时，可把两行 export 加入 ~/.zshrc，然后执行：

source ~/.zshrc

使用 Bash 时，放入对应的 ~/.bashrc，再执行 source ~/.bashrc。

3. 启动与测试

gemini

首次运行时选择 Gemini API Key 认证方式。需要切换认证时，在交互界面输入 /auth。也可以用非交互命令测试：

gemini -p "Hello，测试连接是否正常"

如果默认模型不可用，使用 gemini -m gemini-3-flash-preview 指定账号支持的模型。这里的环境变量填写主机地址，由客户端拼接 Gemini API 路径。更多说明见接入概览与常见问题。

接入指南

AI助手

对话类

编程类

1. 安装与检查

2. 配置环境变量

3. 启动与测试

​1. 安装与检查

​2. 配置环境变量

​3. 启动与测试

1. 安装与检查

2. 配置环境变量

3. 启动与测试