aicentos客户端接入
Gemini CLI
在 Gemini CLI 中使用 aicentos —— 通过环境变量配置自定义网关
最后更新于:
Gemini CLI 是 Google 官方推出的命令行工具，支持通过环境变量配置自定义网关来接入 Codex Proxy 服务，实现在终端中与 Gemini 模型进行交互对话。
准备工作
Gemini CLI 通过 npm 全局安装，需要先准备好 Node.js 18+ 和 npm 环境。
安装 Node.js
- 访问 Node.js 官网下载页面：https://nodejs.org/en/download
- macOS/Windows：下载并安装 LTS 版本
- Linux：按页面提供的发行版方式安装
- macOS（Homebrew 用户）：执行
brew install node
验证安装
node -v
npm -v安装 Gemini CLI
使用 npm 全局安装 Gemini CLI：
npm install -g @google/gemini-cli验证安装：
gemini --version配置环境变量
Gemini CLI 支持通过以下三个环境变量接入自定义网关：
| 环境变量 | 说明 |
|---|---|
GOOGLE_GEMINI_BASE_URL | 网关服务根地址，替换 Google 默认端点 |
GEMINI_API_KEY | 你的 API Key |
GEMINI_MODEL | 默认使用的模型 |
配置示例
export GOOGLE_GEMINI_BASE_URL="https://aicentos.com"
export GEMINI_API_KEY="your_api_key_here"
export GEMINI_MODEL="gemini-2.0-flash"注意事项
GOOGLE_GEMINI_BASE_URL填写服务根地址，不需要带具体接口路径- 临时测试：直接在当前 shell 会话中执行上述 export 命令
- 永久生效：将 export 语句加入
~/.zshrc或~/.bashrc，然后执行source ~/.zshrc使其生效
启动 Gemini CLI
配置完成后，直接运行以下命令启动：
gemini启动后即可在终端中与 Gemini 模型进行交互对话。
验证接入
在 Gemini CLI 中发起一次对话，如果能正常收到回复，说明接入成功。
常见问题排查
- 如果遇到鉴权错误，请确认
GEMINI_API_KEY是否正确 - 检查
GOOGLE_GEMINI_BASE_URL是否指向正确的服务地址
注意事项
- 当前服务已支持 Gemini 兼容接口，可直接用于 Gemini CLI
- 环境变量配置建议加入 shell 配置文件以实现永久生效
- Gemini CLI 会自动拼接 API 路径，无需在 BASE_URL 中添加具体接口路径