--- title: Gemini CLI | RunAPI description: Configura Gemini CLI con l’API Gemini nativa di RunAPI, verifica le richieste e ripristina la configurazione precedente. url: https://runapi.ai/it/docs/resources/tool-integrations/gemini-cli.md canonical: https://runapi.ai/it/docs/resources/tool-integrations/gemini-cli locale: it --- > Versione HTML: https://runapi.ai/it/docs/resources/tool-integrations/gemini-cli > Indice del sito per gli agenti: https://runapi.ai/llms.txt # Gemini CLI ## Panoramica Gemini CLI è un agente nel terminale. Questa guida cambia il suo fornitore di modelli nell’API Gemini nativa di RunAPI; aggiungere gli strumenti RunAPI tramite MCP è un passaggio distinto. ## Prima di iniziare Segui la [guida ufficiale all’installazione][1]. Crea una chiave API standard dedicata con la [guida all’autenticazione](https://runapi.ai/it/docs/guides/authentication.md), poi copia un ID di modello Gemini nativo dal [catalogo dei modelli](https://runapi.ai/it/models). Non includere mai la chiave nei commit. [1]: https://geminicli.com/docs/get-started/installation/ ```shell npm install -g @google/gemini-cli ``` ## Configura RunAPI Inizia con queste variabili nella shell corrente. L’URL di base è la radice HTTPS dell’API, senza `/v1beta`; l’SDK aggiunge `POST /v1beta/models/{model}:streamGenerateContent?alt=sse`. HTTP è consentito solo per 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 ``` Per un uso persistente, salva le stesse tre variabili in `~/.gemini/.env`, fuori dai repository. Limita l’accesso con `chmod 600 ~/.gemini/.env`. Gemini CLI cerca `.env` dalla directory corrente verso quelle superiori, poi controlla `~/.gemini/.env` e `~/.env`; verifica eventuali file in conflitto. Unisci queste due impostazioni in `~/.gemini/settings.json` preservando le altre. Usa `gemini-api-key` per l’autenticazione con chiave API; non riutilizzare un accesso Google memorizzato. La chiave viene inviata in `x-goog-api-key` per impostazione predefinita. ```json { "security": { "auth": {"selectedType": "gemini-api-key"} }, "model": {"name": "YOUR_RUNAPI_MODEL_ID"} } ``` ## Scegli un modello Usa `GEMINI_MODEL`, `--model YOUR_RUNAPI_MODEL_ID` o `/model` in una sessione interattiva. Evita `auto`, `pro` e `flash`: questi alias possono risolversi in ID di modelli Google non disponibili in RunAPI. Selezione interna, classificazione e rilevamento dei cicli possono richiedere anche modelli ausiliari flash o flash-lite; verificane separatamente la disponibilità. ## Verifica Esegui questi comandi in un repository fidato. Controlla il modello con `/about` o `/stats` in una sessione interattiva, poi conferma una richiesta `streamGenerateContent` corrispondente nei registri d’uso RunAPI. Una risposta CLI riuscita non dimostra da sola quale endpoint l’abbia ricevuta. ```shell gemini --version gemini -p "Describe this repository in one sentence." ``` ## Aggiungi strumenti RunAPI MCP aggiunge strumenti, non un fornitore di modelli. Questo comando registra il server locale; segui [Local MCP](https://runapi.ai/it/docs/resources/mcp/local.md) per l’autenticazione e la verifica separate. ```shell gemini mcp add runapi npx -y @runapi.ai/mcp ``` ## Risoluzione dei problemi Se le richieste arrivano ancora a Google, controlla i file `.env` in conflitto, `security.auth.selectedType`, l’accesso memorizzato e le variabili di autenticazione Google/Vertex. Se compare `Invalid auth method selected`, scegli `gemini-api-key` anziché `gateway` nelle impostazioni e riavvia. Con `401`, controlla la chiave ed eventuali modifiche di `GEMINI_API_KEY_AUTH_MECHANISM`; per impostazione predefinita viene usato `x-goog-api-key`. Per `404`, rimuovi `/v1beta` dall’URL di base e copia nuovamente un ID di modello Gemini nativo supportato. Se un modello ausiliario non è disponibile, verifica l’ID richiesto; scegliere il modello principale non garantisce tutte le funzioni CLI. RunAPI non espone `countTokens` né `embedContent`. Gemini CLI può stimare localmente i token se `countTokens` fallisce; le stime possono differire dai registri d’uso. Usa HTTPS tranne per localhost e non disabilitare la verifica dei certificati. ## Rimuovi RunAPI Rimuovi le tre variabili dalla shell e dai file `.env` salvati, ripristina `security.auth.selectedType` e il modello precedenti e revoca la chiave dedicata in RunAPI. Rimuovi il server MCP aggiunto separatamente solo se non ti servono più i suoi strumenti. ```shell unset GOOGLE_GEMINI_BASE_URL GEMINI_API_KEY GEMINI_MODEL ``` ## Passaggi successivi Prosegui con la [guida rapida all’API LLM](https://runapi.ai/it/docs/guides/llm-api/quickstart.md), [Gemini generateContent](https://runapi.ai/it/docs/api/gemini/generate-content.md), [streamGenerateContent](https://runapi.ai/it/docs/api/gemini/stream-generate-content.md), il [catalogo dei modelli](https://runapi.ai/it/models) o [Local MCP](https://runapi.ai/it/docs/resources/mcp/local.md). --- ## Altre risorse di RunAPI - [Home](https://runapi.ai/it/.md) - [Catalogo dei modelli](https://runapi.ai/it/models.md) - [Prezzi](https://runapi.ai/it/pricing.md) - [Fornitori](https://runapi.ai/it/models) - [Documentazione](https://runapi.ai/it/docs/guides) - [SDK](https://runapi.ai/it/sdk.md) - [CLI](https://runapi.ai/it/cli.md) - [MCP Server](https://runapi.ai/it/mcp.md) - [x402](https://runapi.ai/it/x402.md) - [Claude Code vs Cursor](https://runapi.ai/it/claude-code-vs-cursor.md) - [Configurazione Cursor API](https://runapi.ai/it/cursor-api-setup.md) - [RunAPI vs OpenRouter](https://runapi.ai/it/openrouter-alternative.md) - [Enterprise](https://runapi.ai/it/contact.md) - [Contatti](https://runapi.ai/it/contact.md) - [Termini](https://runapi.ai/it/terms.md) - [Privacy](https://runapi.ai/it/privacy.md) - [Indice del sito per gli agenti](https://runapi.ai/llms.txt) Contatti: contact@runapi.ai ## Dati strutturati ```json [ { "@context": "https://schema.org", "inLanguage": "it", "@type": "WebSite", "name": "RunAPI", "url": "https://runapi.ai/it", "potentialAction": { "@type": "SearchAction", "target": { "@type": "EntryPoint", "urlTemplate": "https://runapi.ai/it/models?q={search_term_string}" }, "query-input": "required name=search_term_string" } }, { "@context": "https://schema.org", "inLanguage": "it", "@type": "Organization", "name": "RunAPI", "url": "https://runapi.ai/it", "logo": { "@type": "ImageObject", "url": "https://runapi.ai/iticon.svg" }, "sameAs": [ "https://github.com/runapi-ai" ] }, { "@context": "https://schema.org", "inLanguage": "it", "@type": "TechArticle", "headline": "Gemini CLI", "description": "Configura Gemini CLI con l’API Gemini nativa di RunAPI, verifica le richieste e ripristina la configurazione precedente.", "url": "https://runapi.ai/it/docs/resources/tool-integrations/gemini-cli", "mainEntityOfPage": "https://runapi.ai/it/docs/resources/tool-integrations/gemini-cli" } ] ```