Convidar amigos e ganhar tokens grátis!Saiba mais

Integrando o Gemini CLI com Modelos Personalizados CodingPlanX

Configure o Google Gemini CLI usando a sua Chave de API do CodingPlanX.ai.

Guia de Integração do Gemini CLI

O CodingPlanX.ai suporta o Claude Code, OpenAI Codex e Google Gemini CLI. Após adquirir um plano, essas três ferramentas compartilham a mesma cota do plano, permitindo que você escolha com flexibilidade a ferramenta que melhor se adapta ao seu fluxo de trabalho.

O que é o Gemini CLI?

O Gemini CLI é um assistente de programação de IA de linha de comando introduzido pelo Google. Semelhante ao Claude Code, ele ajuda a desenvolver código, depurar e manipular arquivos diretamente no seu terminal.

Modelos Disponíveis

Você pode acessar os seguintes modelos do Gemini através do CodingPlanX.ai:

ModeloDescrição
gemini-3-pro-previewVersão de pré-visualização mais recente (Recomendado)
gemini-2.5-proVersão estável

Versão Mais Recente: Gemini CLI v0.33.1 (12/03/2026), apresentando o sistema de Extensões, temas personalizados e muito mais.

Visão Geral da Configuração

O Gemini CLI requer que as seguintes variáveis de ambiente sejam definidas:

  • GOOGLE_GEMINI_BASE_URL - URL do endpoint do serviço
  • GEMINI_API_KEY - Chave de API (A mesma do Claude Code)
  • GEMINI_MODEL - Modelo selecionado

Configuração macOS

Passo 1: Instalar Ambiente Node.js

O Gemini CLI requer o Node.js para funcionar.

Método 1: Usando Homebrew (Recomendado)

Se você tem o Homebrew instalado, é a maneira mais fácil de instalar o Node.js:

# Atualizar Homebrew
brew update

# Instalar Node.js
brew install node
Método 2: Baixar do Site Oficial
  1. Visite https://nodejs.org/
  2. Baixe a versão LTS para macOS
  3. Abra o arquivo .pkg baixado
  4. Siga as instruções do instalador
Notas para macOS
  • Se você encontrar problemas de permissão, pode ser necessário usar sudo.
  • A primeira execução pode exigir permissão nas Configurações do Sistema.
  • Recomenda-se usar o Terminal ou o iTerm2.
Verificar a Instalação do Node.js

Após a instalação, abra o Terminal e digite:

node --version
npm --version

Se as versões forem exibidas, a instalação foi bem-sucedida!

Passo 2: Instalar Gemini CLI

Instale o Gemini CLI globalmente usando npm:

npm install -g @google/gemini-cli

Verifique a instalação:

gemini --version

Passo 3: Configurar Variáveis de Ambiente do Gemini CLI

Defina as seguintes variáveis de ambiente para se conectar ao serviço de proxy:

Configuração Temporária (Sessão Atual)

Execute estes comandos no seu terminal:

export GOOGLE_GEMINI_BASE_URL="https://api.codingplanx.ai"
export GEMINI_API_KEY="cr_xxxxxxxxxx"
export GEMINI_MODEL="gemini-3-pro-preview"

Substitua cr_xxxxxxxxxx pela sua Chave de API do CodingPlanX.ai. Você pode usar a mesma chave de API que usa para o Claude Code.

Configuração Permanente (Perfil do Shell)

Adicione as seguintes linhas ao seu arquivo de configuração do shell (ex: ~/.zshrc):

# Configuração do Gemini CLI
export GOOGLE_GEMINI_BASE_URL="https://api.codingplanx.ai"
export GEMINI_API_KEY="cr_xxxxxxxxxx"
export GEMINI_MODEL="gemini-3-pro-preview"

Em seguida, aplique as alterações:

source ~/.zshrc

Verificar Variáveis de Ambiente

Teste as variáveis no seu terminal:

echo $GOOGLE_GEMINI_BASE_URL
echo $GEMINI_API_KEY
echo $GEMINI_MODEL

Configuração Linux / WSL2

Passo 1: Instalar Ambiente Node.js

O Gemini CLI requer o Node.js para funcionar.

Método 1: Usando nvm (Recomendado)

O nvm facilita o gerenciamento de várias versões do Node.js:

# Instalar nvm
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash

# Recarregar a configuração do shell
source ~/.bashrc

# Instalar a versão LTS mais recente
nvm install --lts
Método 2: Usando Gerenciadores de Pacotes
# Ubuntu/Debian
curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash -
sudo apt-get install -y nodejs

# Fedora
sudo dnf install nodejs

# Arch Linux
sudo pacman -S nodejs npm
Notas para Linux / WSL2
  • Usuários do WSL2 devem instalar o Node.js dentro do subsistema Linux, não no Windows.
  • Usar o nvm ajuda a evitar problemas de permissão.
  • Certifique-se de que o perfil do seu shell carrega o nvm corretamente.
Verificar a Instalação do Node.js

Abra o seu terminal e digite:

node --version
npm --version

Passo 2: Instalar Gemini CLI

Instale o Gemini CLI globalmente usando npm:

npm install -g @google/gemini-cli

Verifique a instalação:

gemini --version

Passo 3: Configurar Variáveis de Ambiente do Gemini CLI

Configuração Temporária (Sessão Atual)
export GOOGLE_GEMINI_BASE_URL="https://api.codingplanx.ai"
export GEMINI_API_KEY="cr_xxxxxxxxxx"
export GEMINI_MODEL="gemini-3-pro-preview"

Substitua cr_xxxxxxxxxx pela sua Chave de API do CodingPlanX.ai.

Configuração Permanente (Perfil do Shell)

Adicione o seguinte ao seu perfil do shell (~/.bashrc):

# Configuração do Gemini CLI
export GOOGLE_GEMINI_BASE_URL="https://api.codingplanx.ai"
export GEMINI_API_KEY="cr_xxxxxxxxxx"
export GEMINI_MODEL="gemini-3-pro-preview"

Aplique as alterações:

source ~/.bashrc

Se você usa Zsh, adicione ao ~/.zshrc e execute source ~/.zshrc.

Verificar Variáveis de Ambiente

echo $GOOGLE_GEMINI_BASE_URL
echo $GEMINI_API_KEY
echo $GEMINI_MODEL

Configuração Windows

Passo 1: Instalar Ambiente Node.js

Método 1: Baixar do Site Oficial (Recomendado)
  1. Visite https://nodejs.org/
  2. Clique na versão "LTS" para fazer o download.
  3. Execute o arquivo .msi baixado.
  4. Siga o assistente de instalação, mantendo as configurações padrão.
Método 2: Usando um Gerenciador de Pacotes

Se você tiver o Chocolatey ou o Scoop instalados:

# Usando Chocolatey
choco install nodejs

# Ou usando Scoop
scoop install nodejs
Notas para Windows
  • Recomenda-se usar o PowerShell em vez do CMD.
  • Se você enfrentar erros de permissão, tente executar como Administrador.
  • Alguns softwares antivírus podem acionar falsos positivos; adicione à lista de permissões, se necessário.
Verificar a Instalação do Node.js

Abra o PowerShell ou o CMD e digite:

node --version
npm --version

Passo 2: Instalar Gemini CLI

npm install -g @google/gemini-cli

Verifique a instalação:

gemini --version

Passo 3: Configurar Variáveis de Ambiente do Gemini CLI

Configuração Temporária no PowerShell (Sessão Atual)

Execute o seguinte no PowerShell:

$env:GOOGLE_GEMINI_BASE_URL = "https://api.codingplanx.ai"
$env:GEMINI_API_KEY = "cr_xxxxxxxxxx"
$env:GEMINI_MODEL = "gemini-3-pro-preview"

Substitua cr_xxxxxxxxxx pela sua Chave de API do CodingPlanX.ai.

Configuração Permanente no PowerShell (Nível do Usuário)

Execute o seguinte no PowerShell:

# Definir variáveis de ambiente no nível do usuário (Permanente)
[System.Environment]::SetEnvironmentVariable("GOOGLE_GEMINI_BASE_URL", "https://api.codingplanx.ai", [System.EnvironmentVariableTarget]::User)
[System.Environment]::SetEnvironmentVariable("GEMINI_API_KEY", "cr_xxxxxxxxxx", [System.EnvironmentVariableTarget]::User)
[System.Environment]::SetEnvironmentVariable("GEMINI_MODEL", "gemini-3-pro-preview", [System.EnvironmentVariableTarget]::User)

Você precisa reiniciar a janela do PowerShell para que essas alterações entrem em vigor.

Verificar Variáveis de Ambiente

echo $env:GOOGLE_GEMINI_BASE_URL
echo $env:GEMINI_API_KEY
echo $env:GEMINI_MODEL

FAQ / Solução de Problemas

Versão do Node.js Muito Baixa

Problema: O Gemini CLI informa que a versão do Node.js é incompatível.

Solução:

  1. Verifique sua versão: node --version
  2. Recomenda-se o Node.js 18.x ou superior.
  3. Atualize usando nvm: nvm install --lts && nvm use --lts

Variáveis de Ambiente Não Entrando em Vigor

Problema: Não é possível conectar após definir as variáveis de ambiente.

Solução:

  1. Certifique-se de ter reiniciado o terminal ou executado o comando source.
  2. Verifique se os nomes das variáveis estão escritos corretamente (diferencia maiúsculas de minúsculas).
  3. Verifique o formato da sua chave de API (começa com cr_).

Problemas de Conexão de Rede

Problema: Incapaz de conectar aos serviços CodingPlanX.ai.

Solução:

  1. Verifique sua conexão com a internet.
  2. Verifique se a variável GOOGLE_GEMINI_BASE_URL está definida corretamente.