Gemini Code Assist（命令行插件）配置手册

1. 说明与适用范围

本手册面向“命令行中的 Gemini Code Assist 插件”使用场景，实际运行载体为 Gemini CLI。

2. 前置条件

• Node.js 20+（Gemini CLI 官方要求）
• 可用的 Gemini API Key（用于环境变量鉴权）

3. 安装 Gemini CLI

任选一种方式：

npx 临时运行

npx @google/gemini-cli

npm 全局安装

npm install -g @google/gemini-cli

Homebrew（macOS / Linux）

brew install gemini-cli

安装后验证：

gemini --version

4. 使用环境变量鉴权

Gemini CLI 支持通过 GEMINI_API_KEY 设置 API Key。

macOS / Linux

临时（当前会话）

export GEMINI_API_KEY="your_api_key_here"

永久（写入 shell 配置）

echo 'export GEMINI_API_KEY="your_api_key_here"' >> ~/.zshrc
source ~/.zshrc

Windows（PowerShell）

临时（当前窗口）

$env:GEMINI_API_KEY="your_api_key_here"

永久（推荐）

[System.Environment]::SetEnvironmentVariable("GEMINI_API_KEY", "your_api_key_here", "User")

5. 网关 / Base URL（rongchuan.ai）

建议做法：

• 确认 rongchuan.ai 是否提供 Gemini API 兼容或 Gemini CLI 兼容的接入说明。
• 若对方提供“自定义 Endpoint/Proxy”的环境变量，请将其设置为 https://rongchuan.ai。
• 如无官方入口参数，则建议使用网关提供的专用启动器或包装脚本。

6. 启动与基本用法

启动交互式会话：

gemini

非交互模式（脚本中使用）：

gemini -p "Summarize this repository"

7. 配置文件位置（了解即可）

Gemini CLI 使用 ~/.gemini/settings.json 保存用户级配置；项目级配置在 .gemini/settings.json。

CLI 也会自动加载 .env / ~/.env 中的环境变量。

8. 常见问题

• 提示无权限/鉴权失败：检查 GEMINI_API_KEY 是否设置且有效。
• 命令找不到：确认 npm 全局路径或重新安装。
• 网关访问失败：检查网络、DNS、或网关提供的接入规范。

9. 安全提示

• 不要把 API Key 写入公开仓库。
• 优先使用环境变量或 .env 文件存储密钥。