macOS/Linux Gemini CLI 使用说明

在 macOS 或 Linux 系统上安装官方 Gemini CLI，并配置为使用积木AI代码助手。

返回 下载脚本 登录后创建 Gemini Key
开始前先做这一步：先到 Key 管理 创建 Gemini Key。文档里所有 你的Gemini_API_KEY 都必须替换成你自己的真实 Key，否则无法使用。

先选一种方式

如果你只是想尽快装好并开始使用，优先用“下载脚本”；如果你更习惯自己在终端执行命令，就用“复制脚本”；只有需要逐步排障时，再看完整说明。
下载脚本 完整说明 
curl -fsSL https://code.jimuxyz.com/env_deploy/gemini-install.sh | bash
npm install -g @google/gemini-cli@latest --registry=https://registry.npmmirror.com
curl -fsSL https://code.jimuxyz.com/env_deploy/gemini-deploy.sh | bash -s -- "你的Gemini_API_KEY"

系统要求

系统
macOS 10.15+ 或 Linux
依赖
Node.js 20+ + npm
Node.js 安装（如果没有安装）
macOS：前往 nodejs.org/zh-cn/download 下载
Linux（Debian/Ubuntu）：curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -，然后 sudo apt-get install -y nodejs

安装步骤

1

打开终端

macOS 可用 Cmd+Space 搜索 Terminal，或使用 VS Code / JetBrains 的内置终端打开；Linux 打开你常用的终端即可。

2

复制并执行环境检查脚本

curl -fsSL https://code.jimuxyz.com/env_deploy/gemini-install.sh | bash
3

卸载已安装的 Gemini CLI（可选，未安装请跳过）

# 下面是通用操作
npm uninstall -g @google/gemini-cli

# 下面是macOS专属（Linux忽略），通用操作在macOS执行成功，以下步骤macOS也可忽略
brew uninstall codex
4

安装 Gemini CLI 官方原版包

npm install -g @google/gemini-cli@latest --registry=https://registry.npmmirror.com
5

验证安装

gemini -v
6

登录后创建并复制 Gemini Key

登录后到「Key 管理」页面创建一个新的 Gemini Key，并复制你自己的 你的Gemini_API_KEY 对应真实值。

7

一键写入配置（脚本写入配置）

curl -fsSL https://code.jimuxyz.com/env_deploy/gemini-deploy.sh | bash -s -- "你的Gemini_API_KEY"

脚本会把环境变量写入 ~/.zshrc 或 ~/.bashrc。

或者

如果你不想用脚本，可手动写入以下内容：

export GOOGLE_GEMINI_BASE_URL="https://code.jimuxyz.com/p"
export GEMINI_API_KEY="你的Gemini_API_KEY"

写入后执行 source ~/.zshrc 生效（若使用 bash，替换为 source ~/.bashrc）。

8

启动 Gemini

设置完成后需要先关闭终端，然后重新打开一个新的终端使用，或者在插件中使用。

# 导航到你的项目（可选）
cd your-project

# 启动 Gemini
gemini

在登录页直接选择 3（不执行任何操作），或选择 “Use Gemini API Key” 继续。

进入 Gemini 后可输入 /settings 开启 Preview Features（可选），输入 /model 选择模型。