Gemini CLI 配置教程

基本介绍

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

配置中转的步骤

1. 设置环境变量

在使用中转之前，你需要配置以下环境变量：

注意：你也可以将这些环境变量添加到你的 .bashrc、.zshrc 或其他 shell 配置文件中，这样每次启动终端时都会自动设置这些变量。

2. 从二开仓库安装 Gemini CLI

与使用官方仓库不同，你需要从二次开发的仓库中拉取代码：

这个二开版本支持通过设置 GEMINI_API_BASE_URL 来使用中转代理。

3. 启动 Gemini CLI

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

4. 选择主题并开始使用

首次启动时，CLI 会提示你选择一个颜色主题，按照提示操作即可。

API 配置详解

除了通过 GEMINI_API_BASE_URL 设置中转外，你也可以使用其他代理配置方式 1：

使用配置文件：你可以在配置文件中设置代理参数 2

支持 ALL_PROXY 环境变量：除了直接设置 GEMINI_API_BASE_URL，最新版本的 Gemini CLI 也支持通过 ALL_PROXY 环境变量设置代理 2：

命令行参数：你可以通过 --proxy 参数直接在命令行设置代理 2

常用命令和功能

安装并配置好 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.

故障排除

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

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

检查网络连接是否稳定，中转代理是否可访问

查看是否有错误信息输出，这些信息通常会指示问题所在

如果使用 SOCKS 代理，确保代理格式正确，例如 socks5://<user>:<pass>@<proxy>:<port> 5

卸载

如果你需要卸载 Gemini CLI，可以参考官方的卸载指南。

小结

通过配置中转代理，你可以在网络限制的环境中顺利使用 Gemini CLI，享受其强大的功能。这个工具可以大大提升你的开发效率，特别是在处理大型代码库、自动化任务和生成应用程序等场景中。

Gemini CLI 配置教程

基本介绍#

配置中转的步骤#

1. 设置环境变量#

2. 从二开仓库安装 Gemini CLI#

3. 启动 Gemini CLI#

4. 选择主题并开始使用#

API 配置详解#

常用命令和功能#

探索代码库#

处理现有代码#

自动化工作流程#

系统交互#

故障排除#

卸载#

小结#