# Gemini-Cli

**Repository Path**: LongLie/gemini-cli

## Basic Information

- **Project Name**: Gemini-Cli
- **Description**: Gemini Cli环境搭建
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-11-03
- **Last Updated**: 2025-11-05

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Gemini-Cli

#### 介绍
Gemini Cli环境搭建，Gemini CLI是google基于Gemini大模型提供的命令行工具，本地安装后能使用命令行中与模型交互。这一提供方式与网页版或者应用APP的入口不同，能够方便开发人员集成到本地代码仓库，或者门禁等CI工程中，极大提升软件开发人员的编码效率。

#### 环境准备
##### 网络环境
因为安装Gemini CLI和后续API调用都需要访问google服务，因此首先需要配置网络代理，如已经有网络代理可跳过本步骤。
* 网络代理：https://glados.space/ 可使用学校邮箱教育账号认证免费使用一年，付费标准如下：
![1762141767804](image/README/1762141767804.png)
* 代理需要开启虚拟网卡模式(TUN模式)，即让所有的流量都走代理，否则因为Gemini CLI的API访问仍可能没走到代理。以FlClash举例：
![1762141969920](image/README/1762141969920.png)
以上准备工作完成后，验证可以访问www.google.com，则前置环境准备完成。
![1762142127443](image/README/1762142127443.png)

#### Gemini CLI安装教程
1. NodeJS环境准备，Gemini CLI安装运行依赖NodeJS环境，要求Node版本选择最新即可。安装方法，本机可能存在多个Node版本，推荐使用nvm管理安装不同版本的NodeJS环境。
* 下载地址：https://www.nvmnode.com/guide/download.html，安装后，使用nvm命令安装node环境。
    ```
    nvm --version
    nvm list available
    nvm install xxx
    nvm use xxx
    nvm list

    npm --version
    ```
    ![1762142809645](image/README/1762142809645.png)
2. Gemini CLI官方仓库：https://github.com/google-gemini/gemini-cli
```
npm install -g @google/gemini-cli
```

#### 使用说明

1.  登录Gemini CLI
   * 安装完成后，gemini --vesrion能看到版本号，直接在命令行中输入gemini即可拉起gemini cli。
   首次启动Gemini CLI，需要认证登录，当前提供三种登录方式，选择Google账号登陆即可。
2.  绑定项目ID与Gemini API授权
   * google账号认证成功后，还需要绑定项目ID并打开项目中Gemini API的授权才可以成功访问API。
   google项目创建：https://console.cloud.google.com/apis/dashboard?project=capable-hangout-476707-b8
   ![1762143392541](image/README/1762143392541.png)
   * 拿到项目ID后，设置到windows系统环境变量中
    ![alt text](image.png)
* 在项目中授权API访问：
    ![1762143566876](image/README/1762143566876.png)
* 授权后，稍作等待，5分钟后，重启命令行终端，输入gemini即可访问并使用。
![1762143679136](image/README/1762143679136.png)

#### chrome devtools mcp使用
官方仓库：https://github.com/ChromeDevTools/chrome-devtools-mcp
chrome devtools mcp是chrome官方提供的mcp服务，可以让类似Gemini CLI这样的模型对接控制浏览器的行为，自动调试分析页面等。
安装方式：
```
gemini mcp add -s user chrome-devtools npx chrome-devtools-mcp@latest
```
实际上述安装命令实在当前用户的Gemini目录setting.json配置文件下新增：
```
{
  "mcpServers": {
    "chrome-devtools": {
      "command": "npx",
      "args": [
	    "-y",
        "chrome-devtools-mcp@latest"
      ]
    }
  }
}
```
然后可以在Gemini CLI界面，/mcp list命令看到所安装的mcp服务，可以使用自然语言与之交互控制浏览器：
![1762152685381](image/README/1762152685381.png)
结合--browserUrl=http://localhost:9222命令参数选项，能够让Gemini CLI控制远程调试设备上的Web实例。（结合devtools远程调试能力的端口转发）
```
{
  "mcpServers": {
    "chrome-devtools": {
      "command": "npx",
      "args": [
	    "-y",
        "chrome-devtools-mcp@latest",
	    "--browserUrl=http://localhost:9222"
      ]
    }
  }
}
```
这样就实现了gemini CLI远程控制调试设备的能力。
* 举例，使用Gemini CLI + chrome devtools mcp做网页自适应布局：
0. 原始页面
![1762254882036](image/README/1762254882036.png)
1. 提示词输入
![1762256211418](image/README/1762256211418.png)
2. 修复方式与修复结果
![1762256269666](image/README/1762256269666.png)
![1762254902933](image/README/1762254902933.png)

0. 原始页面
    ![1762323530889](image/README/1762323530889.jpg)
1. 提示词
   ![1762312281919](image/README/1762312281919.png)
2. 修复方式与修复结果
   ![1762312326750](image/README/1762312326750.png)
    ![1762323549531](image/README/1762323549531.jpg)