KozeKoze
← Voltar ao blog
Tutorial2026年3月23日·管理员

Tutorial de configuração da CLI do Gemini

Tutorial de configuração da CLI do Gemini

📋 Etapas Preparatórias

Antes de começar, certifique-se de que você:

  • Tenho registrado uma conta Koze e feito login
  • Tenho criado uma chave de API na página de Gerenciamento de API
  • Tenho instalado o Gemini CLI (npm install -g @anthropic-ai/gemini-cli ou consulte o Repositório Oficial)

🚀 Método 1: Acesso via API Gemini (Recomendado)

Defina as seguintes variáveis de ambiente no terminal:

# Configurar o endereço do proxy Koze Gemini export GOOGLE_GEMINI_BASE_URL='https://api.kozeai.com/gemini'

# Defina sua chave de API da Koze
export GEMINI_API_KEY='sua chave de API'

# Especifique o modelo a ser usado
export GEMINI_MODEL='gemini-2.5-pro'

Método de autenticação:Selecione Usar chave de API Gemini na inicialização. Se for solicitado que você insira uma chave de API, basta pressionar Enter e deixar em branco.

💡 Se você for redirecionado automaticamente para a página de login do Google ao iniciar, exclua ~/.gemini/settings.json e reinicie.

🔧 Método Dois: Acesso via API Code Assist

Outro método de acesso, adequado para alguns cenários especiais:

# Configurar o endpoint do Code Assist

export CODE_ASSIST_ENDPOINT='https://api.kozeai.com/gemini'

# Configurar o token de acesso (usando sua chave de API da Koze)

export GOOGLE_CLOUD_ACCESS_TOKEN='sua chave de API'

# Ativar o modo GCA

export GOOGLE_GENAI_USE_GCA='true'

# Especificar o modelo

export GEMINI_MODEL='gemini-2.5-pro'

Método de autenticação:Selecione Entrar com o Google na inicialização.

⚠️ Observação: O console da CLI Gemini pode exibir "Falha ao obter informações do usuário: 401 Não autorizado", o que é normal e não afeta o uso.

🎯 Etapa 3: Inicie a CLI Gemini

Após a configuração, inicie-a no terminal:

gemini

📌 Persistir variáveis de ambiente

Recomenda-se escrever as variáveis de ambiente no arquivo de configuração do shell (usando o método 1 como exemplo):

# Usuário Zsh

cat >> ~/.zshrc << < EOF <

export GOOGLE_GEMINI_BASE_URL=

export GEMINI_API_KEY= chave

export GEMINI_MODEL=

EOF source ~/.zshrc

📌 Modelos Disponíveis

Nome do Modelo Descrição
gemini-2.5-pro Gemini 2.5 Pro, a mais recente geração de modelos de alto desempenho
gemini-2.5-flash Gemini 2.5 Flash, mais rápido e mais custo-benefício
gemini-2.0-flash Gemini 2.0 Flash

⚠️ Perguntas Frequentes (FAQ)
Problema Solução
Redirecionar automaticamente para o login do Google após a inicialização Exclua ~/.gemini/settings.json e tente novamente
Erro 401 Não Autorizado Este é um aviso normal e Não afeta o uso; ignore.
Modelo indisponível Verifique no Lobby de Modelos da Koze se o seu plano atual inclui modelos Gemini.

 

Tutorial de configuração da CLI do Gemini | Koze AI