🚀 Gemini Cli 二开增强版本 - Gemini Cli New 🚀

Gemini CLI 是谷歌提供的命令行 AI 工具，可帮助你进行代码查询、编辑大型代码库、生成应用程序及自动化各种任务。通过设置中转站（代理），能在网络受限情况下正常使用 Gemini CLI 服务。

开源地址：https://github.com/aigo666/gemini-cli-new.git 🔗

项目简介

本项目基于 Google 官方 Gemini CLI 二次开发，完全保留原版所有功能，同时新增多项特性。

✨ 新增特性

• 🌍 原生中转 API 支持：通过 GEMINI_API_BASE_URL 环境变量支持自定义 API 端点
• 🔀 增强代理功能：完整的 HTTP/HTTPS 代理支持，包括沙盒环境代理
• 📦 GitHub 直装：支持直接从 GitHub 仓库安装，无需发布到 npm
• 🛡️ 网络安全：提供完整的代理脚本示例和网络过滤功能
• 🔧 灵活配置：支持多种网络环境和代理配置方案

🎯 适用场景

特别适合需要通过代理或中转服务访问 Gemini API 的用户。

功能概述

本项目包含 Gemini CLI 全部功能，作为命令行 AI 工作流工具，可连接你的工具、理解代码并加速工作流程。使用 Gemini CLI，你可以：

• 在 Gemini 的 1M token 上下文窗口内外查询和编辑大型代码库
• 利用多模态功能从 PDF 或草图生成新应用
• 自动化操作任务（如查询拉取请求、处理复杂变基操作）
• 通过工具和 MCP 服务器连接新功能（包括使用 Imagen、Veo 或 Lyria 进行媒体生成）
• 使用内置的 Google 搜索工具完善查询

🚀 快速开始

你有两种安装 Gemini CLI 的选择：

一、使用 Node（使用官方账号）

前提条件：确保已安装 Node.js 版本 20 或更高版本。

1. 运行 CLI：在终端中执行以下命令：

   npx https://github.com/aigo666/gemini-cli-new
   

2. 之后可从任何地方运行 CLI：

   gemini
   

3. 选择颜色主题
4. 身份验证：出现提示时，使用个人 Google 账户登录。登录后可获得每分钟最多 60 个模型请求和每天 1,000 个模型请求的使用量。

完成以上步骤后，即可使用 Gemini CLI！

二、配置中转站的步骤

1. 设置环境变量
   使用中转站前，需配置以下环境变量：

   # 设置 API 密钥 （示例）
   export GEMINI_API_KEY=sk-WIsGdp2exGhBMWZNDvMXRvo4G01EF9AkLRdVIdIoOgGd5WOb1
   
   # 设置 API 中转站地址
   export GEMINI_API_BASE_URL=https://api.jisuai.top
   

   推荐极速 API，二开版本基于该中转平台研发适配，限时特价分组可用

   注意：可将这些环境变量添加到 .bashrc、.zshrc 或其他 shell 配置文件中，实现终端启动时自动设置。

2. 从二开仓库安装 Gemini CLI New
   与官方仓库不同，需从二次开发的仓库拉取代码：

   # 使用 npx 从二开仓库安装 Gemini CLI
   npx https://github.com/aigo666/gemini-cli-new
   

   该二开版本支持通过设置 GEMINI_API_BASE_URL 使用中转站。

3. 启动 Gemini CLI
   安装完成后，可在任何目录下运行以下命令启动：

   gemini
   

4. 选择主题并开始使用
   首次启动时，CLI 会提示选择颜色主题，按提示操作即可。

代理配置详解

除通过 GEMINI_API_BASE_URL 设置中转站外，还可使用其他代理配置方式：

1. 使用配置文件：在配置文件中设置代理参数
2. 支持 ALL_PROXY 环境变量：

   export ALL_PROXY=socks5://<user>:<pass>@<proxy>:<port>
   

3. 命令行参数：通过 --proxy 参数直接在命令行设置代理

详见：https://github.com/google-gemini/gemini-cli/pull/2649

常用命令和功能

安装并配置好 Gemini CLI 后，可使用以下常用功能：

探索代码库

> Describe the main pieces of this system's architecture.
> What security mechanisms are in place?
> Provide a step-by-step dev onboarding doc for developers new to the codebase.

处理现有代码

#> Implement a first draft for GitHub issue #123.
> Help me migrate this codebase to the latest version of Java. Start with a plan.

自动化工作流程

#> Make me a slide deck showing the git history from the last 7 days, grouped by feature and team member.
> Make a full-screen web app for a wall display to show our most interacted-with GitHub issues.

系统交互

#> Convert all the images in this directory to png, and rename them to use dates from the exif data.
> Organize my PDF invoices by month of expenditure.

故障排除

使用过程中遇到问题，可参考以下几点：

1. 检查环境变量是否正确设置：

   echo $GEMINI_API_KEY
   echo $GEMINI_API_BASE_URL
   

2. 检查网络连接是否稳定，中转站是否可访问：

   curl -I https://api.jisuai.top
   

3. 查看错误信息输出，通常会指示问题所在
4. 使用 SOCKS 代理时，确保格式正确（例如：socks5://<user>:<pass>@<proxy>:<port>）

卸载

如需卸载 Gemini CLI，可参考官方卸载指南。

小结

通过配置中转站，可在网络限制环境中顺利使用 Gemini CLI，享受其强大功能。该工具能显著提升开发效率，尤其适用于处理大型代码库、自动化任务和生成应用程序等场景。