1. 🖥️ 安装环境和CLI 命令行工具
SudoCode使用文档
  • 引言
  • 🚀 快速开始
    • 👨‍💼❶注册和登录
    • 💰❷给账户充值
    • 🏷️ ❸模型分组介绍
    • 🔐 ❹ 创建令牌
  • 🕹️ CC Switch安装
    • 软件介绍和配置
  • 🖥️ 安装环境和CLI 命令行工具
    • Claude Code CLI 配置教程
    • Codex CLI 配置教程
    • Gemini CLI 配置教程
  • 🔌IDE插件和客户端
    • OpenCode 配置教程
    • ⚙️ ClaudeCode for VS Code 插件配置
    • ⚙️Cline for VS Code 插件配置
    • 🍒 Cherry Studio配置
  • 🦞OpenClaw 安装和配置模型
    • 🦞 ⚙️ OpenClaw 从0到1安装
    • 🦞🔑 OpenClaw 配置大模型
  • 🙋‍♀️ 帮助中心
    • AI返回字段: 思考相关
    • HTTP状态码及其含义
    • 联系客服
  • ⚖️ 服务条款
    • 使用政策
    • 服务条款
    • 支持的国家和地区
  1. 🖥️ 安装环境和CLI 命令行工具

Gemini CLI 配置教程

Gemini CLI 中文使用指南#

基本介绍#

Gemini CLI 是谷歌提供的开源命令行 AI 工具,将 Gemini 的强大功能直接带入您的终端。它提供轻量级的 Gemini 访问方式,为您提供从提示到模型的最直接路径。通过设置中转站(代理),您可以在网络受限的情况下正常使用 Gemini CLI 服务。

📦 安装方式#

快速安装#

使用 npx 即时运行(无需安装)#

使用 npm 全局安装#

使用 Homebrew 安装(macOS/Linux)#

系统要求#

Node.js 版本 20 或更高
macOS、Linux 或 Windows

配置中转站(代理)使用#

1. 设置环境变量#

在使用中转站之前,您需要配置以下环境变量:
注意:您也可以将这些环境变量添加到 .bashrc、.zshrc 或其他 shell 配置文件中,这样每次启动终端时都会自动设置这些变量。

🚀 快速开始#

基本使用#

在当前目录启动#

包含多个目录#

使用特定模型#

脚本非交互模式#

获取简单文本响应:
获取结构化 JSON 输出:

快速示例#

启动新项目#

分析现有代码#

📋 主要功能#

代码理解与生成#

查询和编辑大型代码库
使用多模态能力从 PDF、图片或草图生成新应用
使用自然语言调试问题和故障排除

自动化与集成#

自动化操作任务,如查询拉取请求或处理复杂的变基操作
使用 MCP 服务器连接新功能
在脚本中非交互式运行以实现工作流自动化

高级功能#

使用内置 Google 搜索获取实时信息
对话检查点以保存和恢复复杂会话
自定义上下文文件(GEMINI.md)为您的项目定制行为

常用命令和功能示例#

探索代码库#

> 描述这个系统架构的主要组成部分
> 有哪些安全机制?
> 为新开发者提供一份分步骤的入门文档

处理现有代码#

> 为 GitHub issue #123 实现一个初稿
> 帮我将这个代码库迁移到最新版本的 Java。先制定一个计划

自动化工作流程#

> 制作一个幻灯片,展示过去 7 天的 git 历史,按功能和团队成员分组
> 制作一个全屏 Web 应用用于墙上显示,展示我们互动最多的 GitHub issues

系统交互#

> 将此目录中的所有图像转换为 png,并使用 exif 数据中的日期重命名它们
> 按支出月份整理我的 PDF 发票

GitHub 集成#

使用 Gemini CLI GitHub Action 将 Gemini CLI 直接集成到您的 GitHub 工作流中:
拉取请求审查:自动代码审查,提供上下文反馈和建议
Issue 分类:基于内容分析自动标记和优先级排序 GitHub issues
按需帮助:在 issues 和拉取请求中提及 @gemini-cli 获取调试、解释或任务委派的帮助
自定义工作流:构建适合您团队需求的自动化、定时和按需工作流

故障排除#

如果您在使用过程中遇到问题,可以参考以下几点:
1.
检查环境变量是否正确设置:
2.
检查网络连接是否稳定,中转站是否可访问:
3.
查看是否有错误信息输出,这些信息通常会指示问题所在
4.
如果使用 SOCKS 代理,确保代理格式正确,例如 socks5://<user>:<pass>@<proxy>:<port>
5.
使用内置命令报告问题:

发布版本说明#

预览版(Preview)#

每周二 UTC 23:59 发布新的预览版本。使用 preview 标签安装:

稳定版(Stable)#

每周二 UTC 20:00 发布新的稳定版本。使用 latest 标签安装:

每夜版(Nightly)#

每天 UTC 00:00 发布每夜版本。使用 nightly 标签安装:

MCP 服务器使用#

在 ~/.gemini/settings.json 中配置 MCP 服务器以扩展 Gemini CLI 的自定义工具:
> @github 列出我的开放拉取请求
> @slack 向 #dev 频道发送今天提交的摘要
> @database 运行查询查找不活跃用户

📚 相关资源#

官方路线图:查看即将推出的功能
NPM 包:包注册表
GitHub Issues:报告 bug 或请求功能
安全建议:安全更新

卸载#

如果您需要卸载 Gemini CLI,请参考官方的卸载指南。
修改于 2026-03-06 13:12:14
上一页
Codex CLI 配置教程
下一页
OpenCode 配置教程
Built with