O Cursor CLI oferece dois métodos de autenticação: login via navegador (recomendado) e chaves de API.

​
Autenticação pelo navegador (recomendado)

Use o fluxo do navegador para ter a experiência de autenticação mais fácil: 
# Fazer login usando o fluxo do navegador
cursor-agent login

# Verificar status da autenticação
cursor-agent status

# Fazer logout e limpar autenticação armazenada
cursor-agent logout
O comando de login vai abrir seu navegador padrão e pedir para você se autenticar com sua conta do Cursor. Depois de concluído, suas credenciais ficam armazenadas localmente de forma segura.

​
Autenticação com chave de API

Para automação, scripts ou ambientes de CI/CD, use a autenticação com chave de API:

​
Passo 1: Gerar uma chave de API

Gere uma chave de API no seu painel do Cursor em Integrações > Chaves de API do Usuário.

​
Passo 2: Configurar a chave de API

Você pode fornecer a chave de API de duas maneiras: Opção 1: Variável de ambiente (recomendado) 
export CURSOR_API_KEY=your_api_key_here
cursor-agent "implement user authentication"
Opção 2: Parâmetro de linha de comando 
cursor-agent --api-key your_api_key_here "implement user authentication"

​
Status de autenticação

Confira seu status de autenticação atual: 
cursor-agent status
Este comando vai mostrar:
  • Se você está autenticado
  • Suas informações de conta
  • Configuração atual do endpoint

​
Solução de Problemas

  • Erros de “Não autenticado”: Execute cursor-agent login ou certifique-se de que sua chave de API está configurada corretamente
  • Erros de certificado SSL: Use a flag --insecure para ambientes de desenvolvimento
  • Problemas de endpoint: Use a flag --endpoint para especificar um endpoint de API customizado