基本介绍

Gemini CLI 是谷歌提供的开源命令行 AI 工具，将 Gemini 的强大功能直接带入您的终端。它提供轻量级的 Gemini 访问方式，为您提供从提示到模型的最直接路径。通过设置中转站（代理），您可以在网络受限的情况下正常使用 Gemini CLI 服务。

🚀 为什么选择 Gemini CLI？
🧠 强大的 Gemini 2.5 Pro：访问 100 万 token 上下文窗口
🔧 内置工具：Google 搜索基础功能、文件操作、Shell 命令、网页抓取
🔌 可扩展：支持 MCP（模型上下文协议）进行自定义集成
💻 终端优先：专为在命令行中工作的开发者设计
🛡️ 开源：Apache 2.0 许可证

📦 安装方式

1.安装 Node.js

📌

提示：如果您已经安装了 Node.js 18.0 或更高版本，可以跳过此步骤。

Windows用户

打开node.js官方进行下载安装

Ubuntu / Debian 用户

#安装 Node.js LTS 版本
curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo bash -
sudo apt-get install -y nodejs

# 验证安装
node --version

macOS 用户

# 安装 Xcode 命令行工具
sudo xcode-select --install

# 安装 Homebrew（如果尚未安装）
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

# 通过 Homebrew 安装 Node.js
brew install node

# 验证安装
node --version

2. 安装 Gemini CLI

Windows用户

使用快捷键 WINDOWS + R，然后输入cmd，打开电脑终端

然后使用 npm 全局安装 Gemini CLI：

npm install -g @google/gemini-cli

# 验证安装
gemini --version

3. 配置并开始使用

然后好Gemini CLI后，我们还需要获取必要的配置信息，不然无法启动使用

前往https://xinghuapi.com/ 注册并登录，前往控制台 -> API令牌页面复制令牌备用。

您需要准备两个重要的配置项：

配置项	说明	获取方式
GEMINI_API_KEY	API 认证令牌	注册后在 API令牌页面点击添加令牌获得（以 sk- 开头）
GOOGLE_GEMINI_BASE_URL	API 服务地址	使用 https://xinghuapi.com（与主站地址相同）

📝 创建令牌时的建议设置：

名称：随意命名
分组：可以选择优质gemini分组，gemini官方直连分组，或者其他的分组
额度：设为无限额度
其他选项：保持默认设置

**启动 Gemini **
在您的项目目录下运行：

Windows系统，使用终端cmd运行

进入项目目录

cd your-project-folder

#设置环境变量

set GEMINI_API_KEY=sk-...  # 替换为您的实际令牌
set GOOGLE_GEMINI_BASE_URL=https://xinghuapi.com

# 启动 Gemini ClI
gemini

Mac系统设置环境变量

# 进入项目目录
cd your-project-folder

#  Linux/Unix设置环境变量
export GEMINI_API_KEY=sk-...  # 替换为您的实际令牌
export GOOGLE_GEMINI_BASE_URL=https://xinghuapi.com

# 启动 Gemini ClI
gemini

初次运行配置

启动后，您将看到以下页面

✨ 恭喜！现在您可以开始与您的 AI 编程搭档一起写代码了！

Gemini CLI API配置教程

基本介绍#

📦 安装方式#

1.安装 Node.js#

2. 安装 Gemini CLI#

3. 配置并开始使用#

基本介绍

📦 安装方式

1.安装 Node.js

2. 安装 Gemini CLI

3. 配置并开始使用