O Cursor CLI oferece dois métodos de autenticação: login pelo navegador (recomendado) e chaves de API. Usa o fluxo pelo navegador para a experiência de autenticação mais simples: 
# Fazer login usando o fluxo pelo navegador
cursor-agent login

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

# Fazer logout e limpar a autenticação armazenada
cursor-agent logout
O comando de login vai abrir teu navegador padrão e pedir pra autenticar com tua conta do Cursor. Quando concluir, tuas credenciais vão ficar armazenadas localmente com segurança.

​
Autenticação com chave de API

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

​
Passo 1: Gerar uma chave de API

Gera uma chave de API no teu dashboard do Cursor em Integrations > User API Keys.

​
Passo 2: Definir a chave de API

Tu pode fornecer a chave de API de duas formas: Opção 1: Variável de ambiente (recomendado) 
export CURSOR_API_KEY=your_api_key_here
cursor-agent "implement user authentication"
Opção 2: Flag na linha de comando 
cursor-agent --api-key your_api_key_here "implement user authentication"

​
Status de autenticação

Confere teu status de autenticação atual: 
cursor-agent status
Esse comando vai exibir:
  • Se tu tá autenticado
  • As informações da tua conta
  • A configuração atual do endpoint

​
Solução de problemas

  • Erros “Not authenticated”: Roda cursor-agent login ou garante que tua chave de API tá configurada certinho
  • Erros de certificado SSL: Usa a flag --insecure em ambientes de desenvolvimento
  • Problemas de endpoint: Usa a flag --endpoint pra especificar um endpoint de API personalizado