gemini-cli保姆级运行教程

未来，心

已于 2025-07-01 11:19:36 修改

阅读量719

点赞数 25

CC 4.0 BY-SA版权

文章标签：开源 AI编程

于 2025-07-01 11:16:26 首次发布

本文链接：https://blog.csdn.net/self_Name_/article/details/149041337

前言

随着大语言模型的快速发展，AI编程得到了快速的发展。出现了许多AI编程辅助工具。GitHub Copilot、cursor、Augment Code、Claude Code等快速迭代。但高额的成本，使得很多工具的门槛过高，无法被广泛的使用。这将限制AI编程的发展。
最近，Google这次推出的Gemini-cli给广大开发者带来福音，你只需要用个人Google账户登录，就能获得免费的Gemini
Code Assist许可证，每分钟60次调用，每天1000次调用，完全免费使用Gemini 2.5
Pro的完整版本这个额度对个人开发者来说真的很够用了。
为此，本文内容专门讲述如何在Windows11中部署gemini-cli，减少新手使用过多的时间部署gemini-cli。

一、gemini-cli是什么？

gemini-cli 是一个用于与 Google 的 Gemini AI 模型进行交互的命令行界面工具。通过该工具，你可以在终端中直接使用 Gemini 模型的强大功能，进行文本生成、代码编写、问答等操作，而无需通过网页界面访问。

主要功能和特点
命令行交互：提供简洁的命令行界面，便于快速输入和获取 AI 回复。
模型选择：支持多种 Gemini 模型（如 gemini-pro、gemini-pro-vision 等），可根据需求选择合适的模型。
多平台支持：可以在 Windows、macOS、Linux 等系统上运行。
流式输出：回复内容实时显示，提升交互体验。
历史记录：保存对话历史，方便查看和复用。
自定义配置：可通过配置文件或命令行参数调整模型参数（如温度、最大 tokens 等）。

二、准备工具

（1）node.js
（2）git
（3）v2ary(使用全局)
（4）注册google账号

三、使用步骤

1.下载gemini-cli

执行下面命令：

git clone https://github.com/google-gemini/gemini-cli
cd gemini-cli
npm install -g

注意：你需要安装git以及node.js（大于18.0版本）`,npm install -g表示全局安装，这样执行gemini才能成功。

2.登录google账号

执行

gemini

进入登录页面，通常可能因缺少环境变量配置导致登录失败。这是需要设置代理端口，在powershell执行如下操作：

$env:HTTP_PROXY = "http://127.0.0.1:端口号"
$env:HTTPS_PROXY = "http://127.0.0.1:端口号"
$env:http_proxy = "http://127.0.0.1:端口号"
$env:https_proxy = "http://127.0.0.1:端口号"

端口号可以通过下面两种形式查看：

# 查看系统代理设置
Get-ItemProperty -Path "HKCU:\Software\Microsoft\Windows\CurrentVersion\Internet Settings" | Select-Object ProxyServer, ProxyEnable
# 查看环境变量中的代理设置
Get-ChildItem Env: | Where-Object {$_.Name -like "*PROXY*"}

# CMD中查看所有代理相关环境变量
set | findstr PROXY

如果报错：

Failed to login. Workspace accounts and licensed Code Assist users must configure GOOGLE_CLOUD_PROJECT (see https://goo.gle/gemini-cli-auth-docs#workspace-gca).

则需要配置“GOOGLE_CLOUD_PROJECT”，打开Google cloud,获取项目ID。
在这里插入图片描述
Windows（CMD）