macOS/Linux Gemini CLI安装指南

以下是整理的 macOS/Linux 与 Windows 双平台 Gemini CLI 安装指南文章:


Gemini CLI 安装配置指南

Gemini CLI 是 Google 官方提供的命令行工具,支持通过 API 密钥直接与 Gemini 模型交互。本文档将指导您在不同操作系统上完成安装与配置。


系统要求

操作系统 版本要求
macOS 10.15 或更高版本
Linux 主流发行版(如 Ubuntu 20.04+、Debian 11+、CentOS 7+ 等)
Windows Windows 10(版本 1809 / build 17763)及以上

一、安装 Gemini CLI

无论使用何种操作系统,均需通过 npm 全局安装官方包:

bash 复制代码
npm install -g @google/gemini-cli

确保已安装 Node.js(建议版本 18 或更高)。


二、获取 API 密钥

  1. 访问 API 密钥管理页面(仪表板的「API密钥」界面)
  2. 创建并复制一个新的 API 密钥
  3. 妥善保存,后续配置需要使用

三、配置环境变量

Gemini CLI 需要通过环境变量获取 API 密钥和自定义 API 地址。

macOS / Linux

编辑用户配置文件(通常为 ~/.zshrc 或 ~/.bashrc),在末尾添加以下内容:

bash 复制代码
# GEMINI Environment Variables
export GOOGLE_GEMINI_BASE_URL="https://api.aicodemirror.com/api/gemini"
export GEMINI_API_KEY="你的密钥"

保存后执行以下命令使配置生效:

bash 复制代码
source ~/.zshrc   # 若使用 zsh
# 或
source ~/.bashrc  # 若使用 bash

Windows

通过「控制面板」→「系统」→「高级系统设置」→「环境变量」添加以下两项:

变量名 变量值
GOOGLE_GEMINI_BASE_URL https://api.aicodemirror.com/api/gemini
GEMINI_API_KEY 你的密钥

添加完成后需重启终端使配置生效。


四、启动与初始化

1. 启动 Gemini CLI

bash 复制代码
gemini

首次启动时会进入配置页面。

2. 选择认证方式

使用方向键选择 Use Gemini API Key ,按下回车确认。


五、可选配置

开启 Preview Features

进入 Gemini CLI 后输入:

复制代码
/settings

按提示开启预览功能。

切换模型

默认模型可能为旧版本,建议切换至 Gemini 3 Pro:

  1. 输入 /quit 退出
  2. 重新运行 gemini
  3. 输入 /model,选择 Gemini 3 Pro 模型

六、开始使用

安装完成后,您可以在任意项目目录中启动 Gemini CLI:

bash 复制代码
# 进入项目目录
cd your-project-folder

# 启动 Gemini CLI
gemini

之后即可通过命令行与 Gemini 模型进行交互。


常见问题

Q:启动时提示"command not found"

A:请检查 Node.js 是否安装,以及 npm 全局安装路径是否在系统 PATH 中。

Q:API 密钥无效或认证失败

A:请确认环境变量中的 GEMINI_API_KEY 与 GOOGLE_GEMINI_BASE_URL 已正确设置,并重启终端。

Q:如何更新 Gemini CLI

A:执行 npm update -g @google/gemini-cli


如需进一步帮助,请联系技术支持。

相关推荐
少司府5 小时前
嵌入式外设篇(二)GPIO·二:GPIO输出与LED控制
linux·stm32·单片机·嵌入式硬件·mcu·51单片机·系统
Rabitebla6 小时前
【Linux操作系统】 文件篇(一):文件描述符与 Linux 文件管理机制
linux·网络·c++·笔记·学习
发疯的技术鼠8 小时前
03-优先级与调度
linux
无足鸟ICT9 小时前
【RHCA+】sosreport(收集诊断文档)
linux·运维·服务器
GeW10 小时前
世界目光聚焦中国:底层技术、Linux、数据库的破局逻辑
linux·数据库
IT大白鼠10 小时前
当 AI 开始自动化渗透:FBI ARTEX 警报的防守对策
运维·人工智能·自动化
Decay__10 小时前
SQLServer 运维自动化平台 —— PowerShell + SQL Agent 作业:部署、监控、巡检、告警、工单闭环一体化
运维·数据库·sql·mysql·架构
A-刘晨阳11 小时前
K8S 二进制集群搭建(一主两从)v1.37.2 版本
运维·云原生·容器·kubernetes·calico·nerdctl
tonydf11 小时前
没完了,Nginx又报新漏洞!
运维·nginx
星恒随风11 小时前
MySQL 从零入门(十):MVCC、Undo Log 与 Read View 详解——InnoDB 如何实现事务隔离?
linux·数据库·笔记·sql·mysql