Gemini CLI 中转站配置使用教程
基本介绍
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,享受其强大的功能。这个工具可以大大提升你的开发效率,特别是在处理大型代码库、自动化任务和生成应用程序等场景中。