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

# Usa Gemini CLI con CometAPI

> Usa questa guida per configurare Gemini CLI con le credenziali CometAPI, le impostazioni del base URL e i model ID di Gemini.

Usa questa guida per eseguire [Gemini CLI](https://github.com/google-gemini/gemini-cli) con CometAPI come endpoint API.

Riferimenti ufficiali:

* [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>
  La disponibilità dei modelli cambia nel tempo. Controlla la [pagina Modelli di CometAPI](/it/overview/models)
  per i modelli Gemini disponibili.
</Note>

## Prerequisiti

| Requisito       | Dettagli                                                                  |
| --------------- | ------------------------------------------------------------------------- |
| Node.js         | 22+ (LTS consigliata)                                                     |
| OS              | macOS, Linux o Windows                                                    |
| Chiave CometAPI | Dal tuo [CometAPI Dashboard](https://www.cometapi.com) (inizia con `sk-`) |

## Configurazione

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

    Oppure tramite Homebrew (macOS / Linux):

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

    Verifica:

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

  <Step title="Imposta le variabili d'ambiente">
    ```bash theme={null}
    export GEMINI_API_KEY="sk-your-cometapi-key"
    export GOOGLE_GEMINI_BASE_URL="https://api.cometapi.com"
    ```

    Sostituisci `sk-your-cometapi-key` con la tua chiave CometAPI effettiva.
  </Step>

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

    Al primo avvio, ti verrà chiesto di scegliere un tema, confermare l'avviso di sicurezza e autorizzare la directory di lavoro.
  </Step>
</Steps>

## Rendi persistenti le variabili d'ambiente

Per evitare di riesportarle a ogni sessione, aggiungi questo alla configurazione della tua 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"
```

Riavvia il terminale affinché le modifiche abbiano effetto.

## Risoluzione dei problemi

<AccordionGroup>
  <Accordion title="Errore Invalid API Key">
    Verifica che `GEMINI_API_KEY` sia impostata correttamente. Esegui `echo $GEMINI_API_KEY` per controllare.
  </Accordion>

  <Accordion title="fetch failed">
    Le restrizioni di rete potrebbero bloccare la connessione. Prova un proxy a livello di sistema.
  </Accordion>

  <Accordion title="Versione di Node.js errata">
    Gemini CLI richiede Node.js 22+. Esegui `node --version` per controllare.
  </Accordion>

  <Accordion title="Disinstallare Gemini CLI">
    Esegui `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": "Usare Gemini CLI con CometAPI",
        "description": "Usa questa guida per configurare Gemini CLI con le credenziali CometAPI, le impostazioni della base URL e i model ID di Gemini.",
        "step": [
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/gemini-cli#step-1",
            "position": 1,
            "name": "Installare Gemini CLI",
            "text": "Completa il passaggio Install Gemini CLI nella guida Usare Gemini CLI con CometAPI."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/gemini-cli#step-2",
            "position": 2,
            "name": "Impostare le variabili d'ambiente",
            "text": "Completa il passaggio Set environment variables nella guida Usare Gemini CLI con CometAPI."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/gemini-cli#step-3",
            "position": 3,
            "name": "Avviare Gemini CLI",
            "text": "Completa il passaggio Start Gemini CLI nella guida Usare Gemini CLI con CometAPI."
          }
        ]
      },
      {
        "@type": "BreadcrumbList",
        "itemListElement": [
          {
            "@type": "ListItem",
            "position": 1,
            "name": "Documentazione CometAPI",
            "item": "https://apidoc.cometapi.com/"
          },
          {
            "@type": "ListItem",
            "position": 2,
            "name": "Integrazioni",
            "item": "https://apidoc.cometapi.com/integrations"
          },
          {
            "@type": "ListItem",
            "position": 3,
            "name": "Usare Gemini CLI con CometAPI",
            "item": "https://apidoc.cometapi.com/integrations/gemini-cli"
          }
        ]
      }
    ]
    }
    `}
</script>