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

# Sử dụng Gemini CLI với CometAPI

> Sử dụng hướng dẫn này để cấu hình Gemini CLI với thông tin xác thực CometAPI, cài đặt base URL và model ID của Gemini.

Sử dụng hướng dẫn này để chạy [Gemini CLI](https://github.com/google-gemini/gemini-cli) với CometAPI làm API endpoint.

Tài liệu tham khảo chính thức:

* [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>
  Khả dụng của model thay đổi theo thời gian. Hãy kiểm tra [trang Models của CometAPI](/vi/overview/models)
  để xem các model Gemini hiện có.
</Note>

## Điều kiện tiên quyết

| Yêu cầu       | Chi tiết                                                                       |
| ------------- | ------------------------------------------------------------------------------ |
| Node.js       | 22+ (khuyến nghị LTS)                                                          |
| OS            | macOS, Linux hoặc Windows                                                      |
| Khóa CometAPI | Từ [CometAPI Dashboard](https://www.cometapi.com) của bạn (bắt đầu bằng `sk-`) |

## Thiết lập

<Steps>
  <Step title="Cài đặt Gemini CLI">
    ```bash theme={null}
    npm install -g @google/gemini-cli
    ```

    Hoặc qua Homebrew (macOS / Linux):

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

    Xác minh:

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

  <Step title="Thiết lập biến môi trường">
    ```bash theme={null}
    export GEMINI_API_KEY="sk-your-cometapi-key"
    export GOOGLE_GEMINI_BASE_URL="https://api.cometapi.com"
    ```

    Thay `sk-your-cometapi-key` bằng khóa CometAPI thực tế của bạn.
  </Step>

  <Step title="Khởi động Gemini CLI">
    ```bash theme={null}
    cd your-project
    gemini
    ```

    Ở lần khởi chạy đầu tiên, bạn sẽ được nhắc chọn một giao diện, xác nhận thông báo an toàn và tin cậy thư mục làm việc.
  </Step>
</Steps>

## Lưu biến môi trường

Để tránh phải export lại ở mỗi phiên, hãy thêm vào cấu hình shell của bạn:

```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"
```

Khởi động lại terminal để các thay đổi có hiệu lực.

## Khắc phục sự cố

<AccordionGroup>
  <Accordion title="Lỗi Invalid API Key">
    Xác minh `GEMINI_API_KEY` được thiết lập chính xác. Chạy `echo $GEMINI_API_KEY` để kiểm tra.
  </Accordion>

  <Accordion title="fetch failed">
    Các hạn chế mạng có thể chặn kết nối. Hãy thử proxy toàn hệ thống.
  </Accordion>

  <Accordion title="Sai phiên bản Node.js">
    Gemini CLI yêu cầu Node.js 22+. Chạy `node --version` để kiểm tra.
  </Accordion>

  <Accordion title="Gỡ cài đặt Gemini CLI">
    Chạy `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": "Sử dụng Gemini CLI với CometAPI",
        "description": "Sử dụng hướng dẫn này để cấu hình Gemini CLI với thông tin xác thực CometAPI, cài đặt base URL và model ID Gemini.",
        "step": [
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/gemini-cli#step-1",
            "position": 1,
            "name": "Cài đặt Gemini CLI",
            "text": "Hoàn thành bước Cài đặt Gemini CLI trong hướng dẫn Sử dụng Gemini CLI với CometAPI."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/gemini-cli#step-2",
            "position": 2,
            "name": "Thiết lập biến môi trường",
            "text": "Hoàn thành bước Thiết lập biến môi trường trong hướng dẫn Sử dụng Gemini CLI với CometAPI."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/gemini-cli#step-3",
            "position": 3,
            "name": "Khởi động Gemini CLI",
            "text": "Hoàn thành bước Khởi động Gemini CLI trong hướng dẫn Sử dụng Gemini CLI với CometAPI."
          }
        ]
      },
      {
        "@type": "BreadcrumbList",
        "itemListElement": [
          {
            "@type": "ListItem",
            "position": 1,
            "name": "Tài liệu CometAPI",
            "item": "https://apidoc.cometapi.com/"
          },
          {
            "@type": "ListItem",
            "position": 2,
            "name": "Tích hợp",
            "item": "https://apidoc.cometapi.com/integrations"
          },
          {
            "@type": "ListItem",
            "position": 3,
            "name": "Sử dụng Gemini CLI với CometAPI",
            "item": "https://apidoc.cometapi.com/integrations/gemini-cli"
          }
        ]
      }
    ]
    }
    `}
</script>