> ## Documentation Index
> Fetch the complete documentation index at: https://docs.jiji.cc/llms.txt
> Use this file to discover all available pages before exploring further.

# Gemini CLI 常见问题

> 使用吉吉API 配置 Gemini CLI 时的常见问题。

## 安装与更新

<AccordionGroup>
  <Accordion title="提示命令未找到">
    安装完成后需要**打开一个新的终端窗口**再运行 `gemini`。

    使用 npm 安装的，确认 npm 全局目录已加入 PATH：

    ```bash theme={null}
    npm config get prefix
    # 把输出目录下的 bin 加入 PATH，例如：
    echo 'export PATH="$(npm config get prefix)/bin:$PATH"' >> ~/.zshrc
    source ~/.zshrc
    ```
  </Accordion>

  <Accordion title="如何更新 Gemini CLI">
    * **Homebrew**：`brew upgrade gemini-cli`
    * **npm**：`npm install -g @google/gemini-cli@latest --registry=https://registry.npmmirror.com`
  </Accordion>

  <Accordion title="安装失败">
    1. 确认 Node.js 版本不低于 18，参考 [Node.js 环境配置](/environment/setup)
    2. 使用国内镜像安装（命令中带 `--registry=https://registry.npmmirror.com`）
    3. macOS/Linux 提示权限不足时，推荐用 nvm 安装 Node.js，避免使用 `sudo`
  </Accordion>
</AccordionGroup>

## 配置问题

<AccordionGroup>
  <Accordion title="配置文件在哪里">
    * **macOS/Linux**：`~/.gemini/`
    * **Windows**：`C:\Users\你的用户名\.gemini\`

    需要 `.env` 和 `settings.json` 两个文件。
  </Accordion>

  <Accordion title="请求地址要不要加 /v1">
    不要。Gemini CLI 会自动补全路径，请求地址填：

    ```bash theme={null}
    GOOGLE_GEMINI_BASE_URL=https://www.jiji.cc
    ```
  </Accordion>

  <Accordion title=".env 文件格式">
    每行一个配置，值两边不要加引号，等号两边不要有空格：

    ```bash theme={null}
    GOOGLE_GEMINI_BASE_URL=https://www.jiji.cc
    GEMINI_API_KEY=your-api-key-here
    ```

    <Warning>
      Windows 下用记事本新建时，注意文件名是 `.env`，不要变成 `.env.txt`。
    </Warning>
  </Accordion>

  <Accordion title="启动时要求登录 Google 账号">
    确认 `~/.gemini/settings.json` 中已设置 `"selectedType": "gemini-api-key"`，参考 [配置](/gemini/introduction#配置)。也可以在启动后输入 `/auth`，选择 **Use Gemini API Key**。
  </Accordion>

  <Accordion title="如何切换模型">
    * **会话中切换**：输入 `/model`
    * **启动时指定**：`gemini -m 模型ID`
    * **设置默认模型**：在 `.env` 中加入 `GEMINI_MODEL=模型ID`

    可用的模型 ID 以 [模型广场](https://www.jiji.cc/extension/models) 为准。
  </Accordion>
</AccordionGroup>

## 错误排查

<AccordionGroup>
  <Accordion title="API Key 无效">
    * 确认 API Key 已完整复制，没有多余空格或引号
    * 确认 Key 所在分组包含 Gemini 模型，账户余额充足
    * 确认系统中没有设置其他 `GEMINI_API_KEY` 或 `GOOGLE_API_KEY` 环境变量覆盖 `.env`
  </Accordion>

  <Accordion title="API 连接失败">
    1. 运行 `cat ~/.gemini/.env`，确认请求地址和 Key 正确
    2. 关闭代理工具后重试
    3. 更新 Gemini CLI 到最新版本后再试
  </Accordion>
</AccordionGroup>

## 仍未解决？

<Card title="提交工单" icon="headset" href="https://www.jiji.cc/extension/tickets">
  以上方法都无法解决时，请提交工单联系我们
</Card>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.