外观
Gemini CLI
Gemini CLI 是 Google 官方的命令行工具,可以在终端里直接用 Gemini 模型写代码、问答、改文件。把它指向 ArcAI 后,调用走你的组织 Key,费用从组织钱包扣除,每次请求都能在 Trace 里看到。
需要准备
- Node.js 20 或更高版本
- 一个 ArcAI 组织 API Key(见 API Key),所在分组包含要用的模型
安装
Windows
从 Node.js 官网 下载安装包,按默认选项安装。
按
Win + R,输入cmd打开命令提示符,确认安装成功:batnode -v npm -v安装 Gemini CLI:
batnpm install -g @google/gemini-cli
macOS
用 npm 或 Homebrew 任选一种:
bash
npm install -g @google/gemini-cli
# 或
brew install gemini-cli配置 ArcAI
需要设置三个环境变量:
| 变量 | 填写 |
|---|---|
GOOGLE_GEMINI_BASE_URL | https://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"设置后关闭并重新打开命令提示符才会生效。
方法二:图形界面设置
- 在开始菜单搜索"环境变量",打开 编辑系统环境变量。
- 点 环境变量。
- 在 用户变量 下点 新建,逐个添加上表中的变量。
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 的完整流程还没有实测过,上线前请按本页走一遍。