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

# Gemini CLI 接入老张API：设置 GOOGLE_GEMINI_BASE_URL

> 用 GEMINI_API_KEY 和 GOOGLE_GEMINI_BASE_URL 两个环境变量，让 Google Gemini CLI 通过老张API调用 Gemini 3.8 Flash 等模型，在终端里读写代码和执行命令。

Gemini CLI 只需设置两个环境变量就能接入老张API：密钥变量填老张API密钥，地址变量填老张API域名，认证方式选 Gemini API Key。请求走 Gemini 原生协议，按 token 计费。

| 项目 | 内容 |
| - | - |
| 密钥变量 | `GEMINI_API_KEY` |
| 地址变量 | `GOOGLE_GEMINI_BASE_URL=https://api.laozhang.ai` |
| 认证方式 | Use Gemini API Key（`gemini-api-key`） |
| 推荐模型 | `gemini-3.8-flash`；复杂任务用 `gemini-3.1-pro-preview` |
| 最后核对 | 2026 年 10 月 5 日，Gemini CLI 0.62.0 |

## 安装 Gemini CLI

用 npm 全局安装（需要先安装 Node.js）：

```bash theme={null}
npm install -g @google/gemini-cli
gemini --version
```

## 配置老张API

<Steps>
  <Step title="设置环境变量">
    把以下两行写进 shell 配置文件（zsh 为 `~/.zshrc`，bash 为 `~/.bashrc`），然后重新打开终端：

    ```bash theme={null}
    export GEMINI_API_KEY="你的老张API密钥"
    export GOOGLE_GEMINI_BASE_URL="https://api.laozhang.ai"
    ```

    地址只填域名，不要加 `/v1` 或 `/v1beta`，Gemini CLI 会自己拼接路径。
  </Step>

  <Step title="选择 Gemini API Key 认证">
    第一次运行 `gemini` 时会询问登录方式，选择 **Use Gemini API Key**。也可以直接在 `~/.gemini/settings.json` 中写入：

    ```json theme={null}
    {
      "security": {
        "auth": {
          "selectedType": "gemini-api-key"
        }
      }
    }
    ```

    不要选 Login with Google，那种方式会直接连 Google 账号，不经过老张API。
  </Step>

  <Step title="指定模型并测试">
    在项目目录运行：

    ```bash theme={null}
    gemini -m gemini-3.8-flash
    ```

    或用非交互模式快速确认：

    ```bash theme={null}
    gemini -m gemini-3.8-flash -p "Reply with exactly one word: connected"
    ```

    非交互模式要求当前目录已被信任，首次在新目录运行时，先在交互模式中确认信任该目录。
  </Step>
</Steps>

## 选择模型

| 模型 | 适合 |
| - | - |
| `gemini-3.8-flash` | 日常开发，速度快、单价低 |
| `gemini-3.6-flash` | 与 3.8 Flash 对比或兼容旧流程 |
| `gemini-3.1-pro-preview` | 复杂推理、大型代码库分析 |

每次启动时用 `-m` 指定模型，避免 Gemini CLI 使用老张API未提供的默认模型 ID。各模型价格见[模型与价格总表](/models)，模型线路说明见 [Gemini 协议](/api-reference/gemini)。

## 常见问题

### 报 API key not valid 或请求发到了 Google？

确认 `GOOGLE_GEMINI_BASE_URL` 在当前终端生效（`echo $GOOGLE_GEMINI_BASE_URL`），并且认证方式是 Gemini API Key。项目目录或 `~/.gemini/.env` 中如果另有 `GEMINI_API_KEY`，也可能被读取，一并检查。

### 报模型不存在？

模型 ID 要与[模型与价格总表](/models)完全一致，并用同一个密钥请求 `GET https://api.laozhang.ai/v1/models` 确认它在列表里。

### 可以用 Gemini CLI 生成图片吗？

Gemini CLI 主要用于对话和编程。生成图片请直接调用 Nano Banana 接口，见 [Nano Banana API](/api-capabilities/nano-banana-image)。

## 相关文档

* [工具接入总览](/scenarios)
* [Gemini 协议：generateContent 请求格式](/api-reference/gemini)
* [Gemini CLI 项目主页](https://github.com/google-gemini/gemini-cli)


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