Gemini
通过环境变量的方式在电脑上安装和配置 Gemini CLI （命令行工具）
如果遇到问题，可以将本页全部内容和问题截图，复制给 豆包 或者 deepseek 等AI，按照他的提示执行对应命令即可
如果 AI 也无法解决，可以联系我们的工程师，为您提供技术上的支持与帮助
Windows
1. 安装 Node.js
前往 Node.js 官网 下载并安装 LTS 版本。（如果已经安装可以跳过）
验证安装：
如果出现下面的提示就说明 node 已经安装成功了
需要注意的是，Nodejs 的版本必须为 18+
如果低于这个版本，可以问一下 AI 如何升级 Nodejs 版本，让 AI 先给您命令收集系统信息，之后它就会提供最快最准确的指导
2. 安装 Gemini CLI
打开 PowerShell（建议以管理员身份运行）并执行：
1npm install -g @google/gemini-cli --registry=https://registry.npmmirror.com/
如果遇到在此系统上禁止运行脚本，需要用管理员权限运行powershell，然后执行 Set-ExecutionPolicy Unrestricted 命令
3. 创建配置文件
打开 PowerShell（建议以管理员身份运行）并执行：
1# 创建 ~/.gemini 目录（存在不报错）
2mkdir "$env:USERPROFILE\.gemini" -Force | Out-Null
3
4# 写入 .env（UTF-8 无 BOM，覆盖）
5$envText = @'
6GEMINI_API_KEY=在这里替换成你的_API_KEY
7GOOGLE_GEMINI_BASE_URL=https://api.aicodewith.com/gemini_cli
8GEMINI_MODEL=gemini-3-pro
9'@
10[System.IO.File]::WriteAllText("$env:USERPROFILE\.gemini\.env", $envText, (New-Object System.Text.UTF8Encoding($false)))
11
12# 写入 settings.json（UTF-8 无 BOM，覆盖）
13$json = @'
14{
15 "ide": {
16 "enabled": true
17 },
18 "security": {
19 "auth": {
20 "selectedType": "gemini-api-key"
21 }
22 }
23}
24'@
25[System.IO.File]::WriteAllText("$env:USERPROFILE\.gemini\settings.json", $json, (New-Object System.Text.UTF8Encoding($false)))
验证是否设置成功：
1Get-Content "$env:USERPROFILE\.gemini\.env"
2Get-Content "$env:USERPROFILE\.gemini\settings.json"
4. 验证配置
终端中输入 gemini 启动，然后在对话框中，输入：您好！
跟他打个招呼，如果正常回复，并且在平台内看到调用记录，则说明配置成功
MacOS
1. 安装 Node.js
首先需要确认您的电脑上有 Homebrew ，如果没有的话，可以点击进去，有一行命令，一键复制就可以安装
安装 Homebrew 的时候，有一部分资源在海外，需要设置 TUN 代理
安装好之后，使用 Homebrew 安装 Nodejs（如果已经安装可以跳过）
请使用下面的命令，验证安装，如果出现下面的提示就说明 node 已经安装成功了
需要注意的是，Nodejs 的版本必须为 18+
如果低于这个版本，可以问一下 AI 如何升级 Nodejs 版本，让 AI 先给您命令收集系统信息，之后它就会提供最快最准确的指导
2. 安装 Gemini CLI
使用 npm 安装：
1npm install -g @google/gemini-cli --registry=https://registry.npmmirror.com/
3. 创建配置文件
打开终端并执行：
1mkdir -p "$HOME/.gemini"
2
3cat > "$HOME/.gemini/.env" << 'EOF'
4GEMINI_API_KEY=在这里替换成你的_API_KEY
5GOOGLE_GEMINI_BASE_URL=https://api.aicodewith.com/gemini_cli
6GEMINI_MODEL=gemini-3-pro
7EOF
8
9cat > "$HOME/.gemini/settings.json" << 'EOF'
10{
11 "ide": {
12 "enabled": true
13 },
14 "security": {
15 "auth": {
16 "selectedType": "gemini-api-key"
17 }
18 }
19}
20EOF
验证是否设置成功：
1cat "$HOME/.gemini/.env"
2cat "$HOME/.gemini/settings.json"
4. 验证配置
终端中输入 gemini 启动，然后在对话框中，输入：您好！
跟他打个招呼，如果正常回复，并且在平台内看到调用记录，则说明配置成功
Linux
1. 安装 Node.js
安装 Nodejs 的命令（如果已经安装可以跳过）：
1curl -fsSL https://deb.nodesource.com/setup_lts.x | bash -
2apt-get install -y nodejs
验证安装：
需要注意的是，Nodejs 的版本必须为 18+
如果低于这个版本，可以问一下 AI 如何升级 Nodejs 版本，让 AI 先给您命令收集系统信息，之后它就会提供最快最准确的指导
2. 安装 Gemini CLI
使用 npm 安装：
1npm install -g @google/gemini-cli --registry=https://registry.npmmirror.com/
如下图所示，则说明安装成功
3. 创建配置文件
打开终端并执行：
1mkdir -p "$HOME/.gemini"
2
3cat > "$HOME/.gemini/.env" << 'EOF'
4GEMINI_API_KEY=在这里替换成你的_API_KEY
5GOOGLE_GEMINI_BASE_URL=https://api.aicodewith.com/gemini_cli
6GEMINI_MODEL=gemini-3-pro
7EOF
8
9cat > "$HOME/.gemini/settings.json" << 'EOF'
10{
11 "ide": {
12 "enabled": true
13 },
14 "security": {
15 "auth": {
16 "selectedType": "gemini-api-key"
17 }
18 }
19}
20EOF
验证是否设置成功：
1cat "$HOME/.gemini/.env"
2cat "$HOME/.gemini/settings.json"
4. 验证配置
终端中输入 gemini 启动，然后在对话框中，输入：您好！
跟他打个招呼，如果正常回复，并且在平台内看到调用记录，则说明配置成功