Skip to content

Gemini CLI ​

Gemini CLI 是 Google 官方的命令行工具,可以在终端里直接用 Gemini 模型写代码、问答、改文件。把它指向 ArcAI 后,调用走你的组织 Key,费用从组织钱包扣除,每次请求都能在 Trace 里看到。

需要准备 ​

  • Node.js 20 或更高版本
  • 一个 ArcAI 组织 API Key(见 API Key),所在分组包含要用的模型

安装 ​

Windows ​

  1. 从 Node.js 官网 下载安装包,按默认选项安装。

  2. 按 Win + R,输入 cmd 打开命令提示符,确认安装成功:

    bat
    node -v
    npm -v
  3. 安装 Gemini CLI:

    bat
    npm install -g @google/gemini-cli

macOS ​

用 npm 或 Homebrew 任选一种:

bash
npm install -g @google/gemini-cli
# 或
brew install gemini-cli

配置 ArcAI ​

需要设置三个环境变量:

变量填写
GOOGLE_GEMINI_BASE_URLhttps://arcnovatech.info
GEMINI_API_KEY你的 ArcAI Key
GEMINI_MODEL默认模型,例如 gemini-4-argon,可选

TIP

控制台 API 密钥 列表里点 使用密钥,会生成带好你的 Key 的配置,可以直接复制。

Windows ​

方法一:命令行设置(推荐)

setx 写入当前用户的环境变量,重启后依然有效:

bat
setx GOOGLE_GEMINI_BASE_URL "https://arcnovatech.info"
setx GEMINI_API_KEY "<你的 ArcAI Key>"
setx GEMINI_MODEL "gemini-4-argon"

设置后关闭并重新打开命令提示符才会生效。

方法二:图形界面设置

  1. 在开始菜单搜索"环境变量",打开 编辑系统环境变量。
  2. 点 环境变量。
  3. 在 用户变量 下点 新建,逐个添加上表中的变量。

macOS / Linux ​

把下面几行加到 ~/.zshrc(bash 用户是 ~/.bashrc)末尾:

bash
export GOOGLE_GEMINI_BASE_URL="https://arcnovatech.info"
export GEMINI_API_KEY="<你的 ArcAI Key>"
export GEMINI_MODEL="gemini-4-argon"

保存后让配置生效:

bash
source ~/.zshrc

开始使用 ​

bash
cd your-project
gemini

第一次启动时,如果提示选择登录方式,选 Use Gemini API key。程序会读取上面设置的 GEMINI_API_KEY。

确认版本:

bash
gemini -v

计费 ​

Gemini CLI 的每一轮对话都会调用模型,按实际 Token 用量从组织钱包扣费。执行一次任务可能包含多次调用,可以在控制台 使用记录 和 追踪 里逐条查看。

想限制某个人的花费,给他设 成员额度,或给他用的 Key 设额度上限。

常见问题 ​

提示认证失败:检查 GEMINI_API_KEY 是否是 ArcAI 的 Key(不是 Google AI Studio 的 Key),以及该 Key 是否已启用。

提示模型不可用:GEMINI_MODEL 必须是 Key 所在分组允许的模型,见 可用模型。

改了环境变量不生效:Windows 需要重新打开命令提示符;macOS 执行 source ~/.zshrc 或新开一个终端。

待确认

Gemini CLI 经 ArcAI 的完整流程还没有实测过,上线前请按本页走一遍。

内容以控制台实际显示为准