--- title: Gemini CLI | RunAPI description: Configure o Gemini CLI com a API Gemini nativa da RunAPI, verifique as solicitações e restaure sua configuração anterior. url: https://runapi.ai/pt-BR/docs/resources/tool-integrations/gemini-cli.md canonical: https://runapi.ai/pt-BR/docs/resources/tool-integrations/gemini-cli locale: pt-BR --- > Versão HTML: https://runapi.ai/pt-BR/docs/resources/tool-integrations/gemini-cli > Índice do site para agentes: https://runapi.ai/llms.txt # Gemini CLI ## Visão geral O Gemini CLI é um agente de terminal. Este guia altera seu provedor de modelos para a API Gemini nativa da RunAPI; adicionar ferramentas da RunAPI via MCP é uma etapa separada. ## Antes de começar Siga o [guia oficial de instalação][1]. Crie uma chave de API padrão exclusiva com o [guia de autenticação](https://runapi.ai/pt-BR/docs/guides/authentication.md) e copie um ID de modelo Gemini nativo do [catálogo de modelos](https://runapi.ai/pt-BR/models). Nunca inclua a chave em um commit. [1]: https://geminicli.com/docs/get-started/installation/ ```shell npm install -g @google/gemini-cli ``` ## Configurar o RunAPI Comece com estas variáveis no shell atual. A URL base é a raiz HTTPS da API, sem `/v1beta`; o SDK acrescenta `POST /v1beta/models/{model}:streamGenerateContent?alt=sse`. HTTP só é permitido para localhost. ```shell export GOOGLE_GEMINI_BASE_URL=https://runapi.ai export GEMINI_API_KEY=YOUR_RUNAPI_API_KEY export GEMINI_MODEL=YOUR_RUNAPI_MODEL_ID ``` Para uso permanente, salve as mesmas três variáveis em `~/.gemini/.env`, fora dos repositórios. Restrinja o acesso com `chmod 600 ~/.gemini/.env`. O Gemini CLI procura `.env` do diretório atual até os diretórios superiores e depois verifica `~/.gemini/.env` e `~/.env`; confira possíveis arquivos em conflito. Mescle estas duas opções em `~/.gemini/settings.json`, preservando as demais. Use `gemini-api-key` para autenticação por chave de API; não reutilize um login do Google armazenado. Por padrão, a chave é enviada em `x-goog-api-key`. ```json { "security": { "auth": {"selectedType": "gemini-api-key"} }, "model": {"name": "YOUR_RUNAPI_MODEL_ID"} } ``` ## Escolher um modelo Use `GEMINI_MODEL`, `--model YOUR_RUNAPI_MODEL_ID` ou `/model` em uma sessão interativa. Evite `auto`, `pro` e `flash`: esses aliases podem apontar para IDs de modelos do Google indisponíveis na RunAPI. Seleção interna, classificação e detecção de loops também podem solicitar modelos auxiliares flash ou flash-lite; confira a disponibilidade separadamente. ## Verificar Execute isto em um repositório confiável. Confira o modelo com `/about` ou `/stats` em uma sessão interativa e confirme uma solicitação `streamGenerateContent` correspondente nos registros de uso da RunAPI. Uma resposta bem-sucedida da CLI não comprova sozinha qual endpoint a recebeu. ```shell gemini --version gemini -p "Describe this repository in one sentence." ``` ## Adicionar ferramentas RunAPI O MCP adiciona ferramentas, não um provedor de modelos. Este comando registra o servidor local; siga [Local MCP](https://runapi.ai/pt-BR/docs/resources/mcp/local.md) para sua autenticação e verificação separadas. ```shell gemini mcp add runapi npx -y @runapi.ai/mcp ``` ## Solucionar problemas Se as solicitações ainda vão ao Google, confira arquivos `.env` em conflito, `security.auth.selectedType`, o login armazenado e variáveis de autenticação Google/Vertex. Se aparecer `Invalid auth method selected`, selecione `gemini-api-key` em vez de `gateway` nas configurações e reinicie. Em caso de `401`, confira a chave e qualquer alteração de `GEMINI_API_KEY_AUTH_MECHANISM`; o padrão usa `x-goog-api-key`. Para `404`, remova `/v1beta` da URL base e copie novamente um ID de modelo Gemini nativo compatível. Se um modelo auxiliar estiver indisponível, confira o ID solicitado; escolher o modelo principal não garante todas as funções da CLI. A RunAPI não oferece `countTokens` nem `embedContent`. O Gemini CLI pode estimar tokens localmente quando `countTokens` falha; as estimativas podem diferir dos registros de uso. Use HTTPS, exceto para localhost, e não desative a verificação de certificados. ## Remover RunAPI Remova as três variáveis do shell e dos arquivos `.env` salvos, restaure `security.auth.selectedType` e o modelo anteriores e revogue a chave exclusiva na RunAPI. Remova o servidor MCP adicionado separadamente apenas se não precisar mais de suas ferramentas. ```shell unset GOOGLE_GEMINI_BASE_URL GEMINI_API_KEY GEMINI_MODEL ``` ## Próximas etapas Continue com o [início rápido da API LLM](https://runapi.ai/pt-BR/docs/guides/llm-api/quickstart.md), [Gemini generateContent](https://runapi.ai/pt-BR/docs/api/gemini/generate-content.md), [streamGenerateContent](https://runapi.ai/pt-BR/docs/api/gemini/stream-generate-content.md), o [catálogo de modelos](https://runapi.ai/pt-BR/models) ou [Local MCP](https://runapi.ai/pt-BR/docs/resources/mcp/local.md). --- ## Mais de RunAPI - [Início](https://runapi.ai/pt-BR/.md) - [Catálogo de modelos](https://runapi.ai/pt-BR/models.md) - [Preços](https://runapi.ai/pt-BR/pricing.md) - [Provedores](https://runapi.ai/pt-BR/models) - [Documentação](https://runapi.ai/pt-BR/docs/guides) - [SDKs](https://runapi.ai/pt-BR/sdk.md) - [CLI](https://runapi.ai/pt-BR/cli.md) - [Servidor MCP](https://runapi.ai/pt-BR/mcp.md) - [x402](https://runapi.ai/pt-BR/x402.md) - [Claude Code vs Cursor](https://runapi.ai/pt-BR/claude-code-vs-cursor.md) - [Configuração da API do Cursor](https://runapi.ai/pt-BR/cursor-api-setup.md) - [RunAPI vs OpenRouter](https://runapi.ai/pt-BR/openrouter-alternative.md) - [Enterprise](https://runapi.ai/pt-BR/contact.md) - [Contato](https://runapi.ai/pt-BR/contact.md) - [Termos](https://runapi.ai/pt-BR/terms.md) - [Privacidade](https://runapi.ai/pt-BR/privacy.md) - [Índice do site para agentes](https://runapi.ai/llms.txt) Contato: contact@runapi.ai ## Dados estruturados ```json [ { "@context": "https://schema.org", "inLanguage": "pt-BR", "@type": "WebSite", "name": "RunAPI", "url": "https://runapi.ai/pt-BR", "potentialAction": { "@type": "SearchAction", "target": { "@type": "EntryPoint", "urlTemplate": "https://runapi.ai/pt-BR/models?q={search_term_string}" }, "query-input": "required name=search_term_string" } }, { "@context": "https://schema.org", "inLanguage": "pt-BR", "@type": "Organization", "name": "RunAPI", "url": "https://runapi.ai/pt-BR", "logo": { "@type": "ImageObject", "url": "https://runapi.ai/pt-BRicon.svg" }, "sameAs": [ "https://github.com/runapi-ai" ] }, { "@context": "https://schema.org", "inLanguage": "pt-BR", "@type": "TechArticle", "headline": "Gemini CLI", "description": "Configure o Gemini CLI com a API Gemini nativa da RunAPI, verifique as solicitações e restaure sua configuração anterior.", "url": "https://runapi.ai/pt-BR/docs/resources/tool-integrations/gemini-cli", "mainEntityOfPage": "https://runapi.ai/pt-BR/docs/resources/tool-integrations/gemini-cli" } ] ```