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

# Usar Gemini CLI com CometAPI

> Use este guia para configurar o Gemini CLI com credenciais da CometAPI, definições de base URL e model IDs do Gemini.

Use este guia para executar o [Gemini CLI](https://github.com/google-gemini/gemini-cli) com a CometAPI como endpoint da API.

Referências oficiais:

* [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>
  A disponibilidade de modelos muda com o tempo. Verifique a [página de modelos da CometAPI](/pt/overview/models)
  para ver os modelos Gemini disponíveis.
</Note>

## Pré-requisitos

| Requisito      | Detalhes                                                                 |
| -------------- | ------------------------------------------------------------------------ |
| Node.js        | 22+ (LTS recomendado)                                                    |
| SO             | macOS, Linux ou Windows                                                  |
| Chave CometAPI | No seu [Painel da CometAPI](https://www.cometapi.com) (começa com `sk-`) |

## Configuração

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

    Ou via Homebrew (macOS / Linux):

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

    Verifique:

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

  <Step title="Definir variáveis de ambiente">
    ```bash theme={null}
    export GEMINI_API_KEY="sk-your-cometapi-key"
    export GOOGLE_GEMINI_BASE_URL="https://api.cometapi.com"
    ```

    Substitua `sk-your-cometapi-key` pela sua chave real da CometAPI.
  </Step>

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

    No primeiro lançamento, você será solicitado a escolher um tema, confirmar o aviso de segurança e confiar no diretório de trabalho.
  </Step>
</Steps>

## Persistir variáveis de ambiente

Para evitar exportá-las novamente a cada sessão, adicione ao seu arquivo de configuração do 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"
```

Reinicie o terminal para que as alterações tenham efeito.

## Solução de problemas

<AccordionGroup>
  <Accordion title="Erro de chave de API inválida">
    Verifique se `GEMINI_API_KEY` está definido corretamente. Execute `echo $GEMINI_API_KEY` para verificar.
  </Accordion>

  <Accordion title="fetch failed">
    Restrições de rede podem bloquear a conexão. Tente um proxy em todo o sistema.
  </Accordion>

  <Accordion title="Versão errada do Node.js">
    O Gemini CLI requer Node.js 22+. Execute `node --version` para verificar.
  </Accordion>

  <Accordion title="Desinstalar o Gemini CLI">
    Execute `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": "Usar o Gemini CLI com CometAPI",
        "description": "Use este guia para configurar o Gemini CLI com credenciais da CometAPI, configurações de URL base e IDs de modelo Gemini.",
        "step": [
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/gemini-cli#step-1",
            "position": 1,
            "name": "Instalar o Gemini CLI",
            "text": "Conclua a etapa Instalar o Gemini CLI no guia Usar o Gemini CLI com CometAPI."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/gemini-cli#step-2",
            "position": 2,
            "name": "Definir variáveis de ambiente",
            "text": "Conclua a etapa Definir variáveis de ambiente no guia Usar o Gemini CLI com CometAPI."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/gemini-cli#step-3",
            "position": 3,
            "name": "Iniciar o Gemini CLI",
            "text": "Conclua a etapa Iniciar o Gemini CLI no guia Usar o Gemini CLI com CometAPI."
          }
        ]
      },
      {
        "@type": "BreadcrumbList",
        "itemListElement": [
          {
            "@type": "ListItem",
            "position": 1,
            "name": "Documentação da CometAPI",
            "item": "https://apidoc.cometapi.com/"
          },
          {
            "@type": "ListItem",
            "position": 2,
            "name": "Integrações",
            "item": "https://apidoc.cometapi.com/integrations"
          },
          {
            "@type": "ListItem",
            "position": 3,
            "name": "Usar o Gemini CLI com CometAPI",
            "item": "https://apidoc.cometapi.com/integrations/gemini-cli"
          }
        ]
      }
    ]
    }
    `}
</script>