> ## 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.

# 使用 Gemini CLI 搭配 CometAPI

> 使用本指南透過 CometAPI 憑證、base URL 設定與 Gemini model ID 來設定 Gemini CLI。

使用本指南以 CometAPI 作為 API 端點來執行 [Gemini CLI](https://github.com/google-gemini/gemini-cli)。

官方參考資料：

* [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-Hant/overview/models)
  以確認可用的 Gemini 模型。
</Note>

## 先決條件

| 要求           | 詳細資訊                                                           |
| ------------ | -------------------------------------------------------------- |
| Node.js      | 22+（建議使用 LTS）                                                  |
| OS           | 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 失敗">
    網路限制可能會封鎖連線。請嘗試使用系統層級的代理。
  </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>