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

> Скористайтеся цим посібником, щоб налаштувати Gemini CLI з обліковими даними CometAPI, параметрами base URL і Gemini model ID.

Скористайтеся цим посібником, щоб запускати [Gemini CLI](https://github.com/google-gemini/gemini-cli) з CometAPI як API endpoint.

Офіційні посилання:

* [Gemini CLI GitHub](https://github.com/google-gemini/gemini-cli)
* [Автентифікація Gemini CLI](https://github.com/google-gemini/gemini-cli/blob/main/docs/get-started/authentication.mdx)

<Note>
  Доступність моделей змінюється з часом. Перевіряйте [сторінку моделей CometAPI](/uk/overview/models)
  для перегляду доступних моделей Gemini.
</Note>

## Передумови

| Вимога        | Деталі                                                                              |
| ------------- | ----------------------------------------------------------------------------------- |
| Node.js       | 22+ (рекомендовано LTS)                                                             |
| OS            | macOS, Linux або Windows                                                            |
| Ключ CometAPI | З вашої [панелі керування CometAPI](https://www.cometapi.com) (починається з `sk-`) |

## Налаштування

<Steps>
  <Step title="Install 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="Set environment variables">
    ```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.
  </Step>

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

    Під час першого запуску вам буде запропоновано вибрати тему, підтвердити сповіщення про безпеку та довірити робочий каталог.
  </Step>
</Steps>

## Збереження змінних середовища

Щоб не виконувати повторний export у кожній сесії, додайте це до конфігурації вашої оболонки:

```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="Помилка Invalid API Key">
    Переконайтеся, що `GEMINI_API_KEY` задано правильно. Виконайте `echo $GEMINI_API_KEY`, щоб перевірити.
  </Accordion>

  <Accordion title="fetch failed">
    Мережеві обмеження можуть блокувати з’єднання. Спробуйте загальносистемний proxy.
  </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": "Використання Gemini CLI з CometAPI",
        "description": "Скористайтеся цим посібником, щоб налаштувати Gemini CLI з обліковими даними CometAPI, параметрами base URL і Gemini model ID.",
        "step": [
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/gemini-cli#step-1",
            "position": 1,
            "name": "Встановити Gemini CLI",
            "text": "Виконайте крок «Встановити Gemini CLI» у посібнику «Використання Gemini CLI з CometAPI»."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/gemini-cli#step-2",
            "position": 2,
            "name": "Задати змінні середовища",
            "text": "Виконайте крок «Задати змінні середовища» у посібнику «Використання Gemini CLI з CometAPI»."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/gemini-cli#step-3",
            "position": 3,
            "name": "Запустити Gemini CLI",
            "text": "Виконайте крок «Запустити Gemini CLI» у посібнику «Використання Gemini CLI з CometAPI»."
          }
        ]
      },
      {
        "@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": "Використання Gemini CLI з CometAPI",
            "item": "https://apidoc.cometapi.com/integrations/gemini-cli"
          }
        ]
      }
    ]
    }
    `}
</script>