Gemini CLI 中转站配置使用教程

Gemini CLI 中转站配置使用教程
Photo by Václav Pechar / Unsplash

基本介绍

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

配置中转站的步骤

1. 设置环境变量

在使用中转站之前,你需要配置以下环境变量:

# 设置 API 密钥
export GEMINI_API_KEY=sk-WIsGdp2exGhBMWZNDvMWOb1

# 设置 API 中转站地址
export GEMINI_API_BASE_URL=https://mj.chatgptten.com
注意:你也可以将这些环境变量添加到你的 .bashrc.zshrc 或其他 shell 配置文件中,这样每次启动终端时都会自动设置这些变量。

2. 从你的二开仓库安装 Gemini CLI

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

# 使用 npx 从我们二开的仓库安装 Gemini CLI
npx https://github.com/a37836323/gemini-cli

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

3. 启动 Gemini CLI

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

gemini

4. 选择主题并开始使用

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

代理配置详解

除了通过 GEMINI_API_BASE_URL 设置中转站外,你也可以使用其他代理配置方式 1:1.使用配置文件:你可以在配置文件中设置代理参数 22.支持 ALL_PROXY 环境变量:除了直接设置 GEMINI_API_BASE_URL,最新版本的 Gemini CLI 也支持通过 ALL_PROXY 环境变量设置代理 2

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

3.命令行参数:你可以通过 --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.

故障排除

如果你在使用过程中遇到问题,可以参考以下几点:1.检查环境变量是否正确设置

echo $GEMINI_API_KEY
echo $GEMINI_API_BASE_URL

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

curl -I https://mj.chatgptten.com/

3.查看是否有错误信息输出,这些信息通常会指示问题所在4.如果使用 SOCKS 代理,确保代理格式正确,例如 socks5://<user>:<pass>@<proxy>:<port> 5

卸载

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

小结

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