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

# 使用 CometAPI 配置 Gemini CLI

> 使用本指南通过 CometAPI 凭证、base URL 设置和 Gemini model ID 来配置 Gemini CLI。

使用本指南通过 [Gemini CLI](https://github.com/google-gemini/gemini-cli) 将 CometAPI 作为 API 端点运行。

官方参考资料：

* [Gemini CLI GitHub](https://github.com/google-gemini/gemini-cli)
* [Gemini CLI Authentication](https://github.com/google-gemini/gemini-cli/blob/main/docs/get-started/authentication.mdx)

<Note>
  模型可用性会随时间变化。请查看 [CometAPI Models page](/zh-Hans/overview/models)
  了解可用的 Gemini 模型。
</Note>

## 前提条件

| 要求           | 详情                                                              |
| ------------ | --------------------------------------------------------------- |
| Node.js      | 22+（推荐 LTS）                                                     |
| 操作系统         | macOS、Linux 或 Windows                                           |
| CometAPI key | 来自你的 [CometAPI Dashboard](https://www.cometapi.com)（以 `sk-` 开头） |

## 设置

<Steps>
  <Step title="安装 Gemini CLI">
    ```bash theme={null}
    npm install -g @google/gemini-cli
    ```

    或通过 Homebrew 安装（macOS / Linux）：

    ```bash theme={null}
    brew install gemini-cli
    ```

    验证：

    ```bash theme={null}
    gemini --version
    ```
  </Step>

  <Step title="设置环境变量">
    ```bash theme={null}
    export GEMINI_API_KEY="sk-your-cometapi-key"
    export GOOGLE_GEMINI_BASE_URL="https://api.cometapi.com"
    ```

    将 `sk-your-cometapi-key` 替换为你的实际 CometAPI key。
  </Step>

  <Step title="启动 Gemini CLI">
    ```bash theme={null}
    cd your-project
    gemini
    ```

    首次启动时，系统会提示你选择主题、确认安全提示，并信任当前工作目录。
  </Step>
</Steps>

## 持久化环境变量

为了避免每次会话都重新导出，请将以下内容添加到你的 shell 配置中：

```bash theme={null}
# Add to ~/.zshrc (macOS) or ~/.bashrc (Linux)
export GEMINI_API_KEY="sk-your-cometapi-key"
export GOOGLE_GEMINI_BASE_URL="https://api.cometapi.com"
```

重启终端以使更改生效。

## 故障排查

<AccordionGroup>
  <Accordion title="无效的 API Key 错误">
    请确认 `GEMINI_API_KEY` 已正确设置。运行 `echo $GEMINI_API_KEY` 进行检查。
  </Accordion>

  <Accordion title="fetch failed">
    网络限制可能会阻止连接。请尝试使用系统级代理。
  </Accordion>

  <Accordion title="Node.js 版本错误">
    Gemini CLI 要求 Node.js 22+。运行 `node --version` 进行检查。
  </Accordion>

  <Accordion title="卸载 Gemini CLI">
    运行 `npm uninstall -g @google/gemini-cli`。
  </Accordion>
</AccordionGroup>

<script type="application/ld+json">
  {`
    {
    "@context": "https://schema.org",
    "@graph": [
      {
        "@type": "HowTo",
        "@id": "https://apidoc.cometapi.com/integrations/gemini-cli#howto",
        "name": "使用 CometAPI 搭配 Gemini CLI",
        "description": "使用本指南通过 CometAPI 凭证、base URL 设置和 Gemini model ID 配置 Gemini CLI。",
        "step": [
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/gemini-cli#step-1",
            "position": 1,
            "name": "安装 Gemini CLI",
            "text": "完成“使用 CometAPI 搭配 Gemini CLI”指南中的“安装 Gemini CLI”步骤。"
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/gemini-cli#step-2",
            "position": 2,
            "name": "设置环境变量",
            "text": "完成“使用 CometAPI 搭配 Gemini CLI”指南中的“设置环境变量”步骤。"
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/gemini-cli#step-3",
            "position": 3,
            "name": "启动 Gemini CLI",
            "text": "完成“使用 CometAPI 搭配 Gemini CLI”指南中的“启动 Gemini CLI”步骤。"
          }
        ]
      },
      {
        "@type": "BreadcrumbList",
        "itemListElement": [
          {
            "@type": "ListItem",
            "position": 1,
            "name": "CometAPI 文档",
            "item": "https://apidoc.cometapi.com/"
          },
          {
            "@type": "ListItem",
            "position": 2,
            "name": "集成",
            "item": "https://apidoc.cometapi.com/integrations"
          },
          {
            "@type": "ListItem",
            "position": 3,
            "name": "使用 CometAPI 搭配 Gemini CLI",
            "item": "https://apidoc.cometapi.com/integrations/gemini-cli"
          }
        ]
      }
    ]
    }
    `}
</script>