02_Gemini_CLI配置教程

一、基本介绍
Gemini CLI 是谷歌提供的开源命令行 AI 工具，将 Gemini 的强大功能直接带入您的终端。通过设置中转代理，您可以在网络受限的情况下正常使用 Gemini CLI 服务。
二、系统要求

Node.js 版本 20 或更高
macOS、Linux 或 Windows

三、安装方式

3.1 使用 npx 即时运行
npx https://github.com/google-gemini/gemini-cli
3.2 使用 npm 全局安装
npm install -g @anthropic-ai/gemini-cli

四、配置环境变量

# 设置 API 密钥
export GEMINI_API_KEY=sk-xxxxx
 
# 设置 API 地址
export GOOGLE_GEMINI_BASE_URL=https://qmszai.cn/v1
 
# cmd 使用下面这个
set GEMINI_API_KEY=sk-xxxxx
set GOOGLE_GEMINI_BASE_URL=https://qmszai.cn/v1
您也可以将这些环境变量添加到 .bashrc、.zshrc 或其他 shell 配置文件中，这样每次启动终端时都会自动设置。

五、快速开始

5.1 在当前目录启动
gemini
5.2 包含多个目录
gemini --include-directories ../lib,../docs
5.3 使用特定模型
gemini -m gemini-2.5-flash
5.4 脚本非交互模式
gemini -p "解释这个代码库的架构"
gemini -p "解释这个代码库的架构" --output-format json

六、故障排除

检查环境变量是否正确设置：echo GOOGLE_GEMINI_BASE_URL

检查网络连接：curl -I https://qmszai.cn/v1

查看是否有错误信息输出

如果使用 SOCKS 代理，确保代理格式正确

使用内置命令报告问题：/bug
七、MCP 服务器使用
在 ~/.gemini/settings.json 中配置 MCP 服务器以扩展 Gemini CLI 的自定义工具。

Gemini_CLI配置教程

02_Gemini_CLI配置教程#

02_Gemini_CLI配置教程