Início rápido
Este guia leva você da instalação à sua primeira alteração útil no Cursor. Você fará login, pedirá ao Cursor para explicar sua base de código, fará uma pequena edição e revisará o resultado.
Instale o Cursor e faça login
Baixe o Cursor. Abra o app e faça login. Em seguida, escolha uma pasta e comece com uma tarefa simples.
- macOS 12 (Monterey) ou posterior
- Instalador nativo (.dmg)
- Compatível com Apple Silicon e Intel
- Windows 10 ou posterior
- Instalador nativo (.exe)
Debian/Ubuntu (recomendado)
# Adicione a chave GPG do Cursorcurl -fsSL https://downloads.cursor.com/keys/anysphere.asc | gpg --dearmor | sudo tee /etc/apt/keyrings/cursor.gpg > /dev/null# Adicione o repositório do Cursorecho "deb [arch=amd64,arm64 signed-by=/etc/apt/keyrings/cursor.gpg] https://downloads.cursor.com/aptrepo stable main" | sudo tee /etc/apt/sources.list.d/cursor.list > /dev/null# Atualize e instalesudo apt updatesudo apt install cursorRHEL/Fedora
# Adicione o repositório do Cursorsudo tee /etc/yum.repos.d/cursor.repo << 'EOF'[cursor]name=Cursorbaseurl=https://downloads.cursor.com/yumrepoenabled=1gpgcheck=1gpgkey=https://downloads.cursor.com/keys/anysphere.ascEOF# Instale o Cursorsudo dnf install cursorAppImage (portátil)
Baixe o arquivo .AppImage em cursor.com/downloads e, em seguida:
chmod +x Cursor-*.AppImage./Cursor-*.AppImageOs pacotes apt e yum são preferíveis ao AppImage. Eles oferecem ícones na área de trabalho, atualizações automáticas e ferramentas de CLI.
Peça ao Cursor para explicar sua base de código
Depois de escolher uma pasta, abra o agente com Cmd ICtrl I. Peça ao Cursor para explicar sua base de código e indicar as principais áreas para ler primeiro.
Explique esta base de código. Indique os principais pontos de entrada, módulos importantes e tudo o que devo ler antes de fazer alterações.
Try in CursorO Cursor pesquisará seu repositório, lerá arquivos relevantes e resumirá como as partes do projeto se encaixam. Esta é uma das maneiras mais rápidas de se orientar em uma base de código desconhecida.
Quer uma explicação mais detalhada? Consulte Entenda sua base de código.
Faça uma pequena alteração
Depois de entender o projeto, peça ao Cursor para sugerir algumas melhorias seguras. Escolha uma e peça que ele faça a alteração.
Sugira três melhorias pequenas e seguras nesta base de código. Explique as vantagens e desvantagens e espere que eu escolha uma.
Try in CursorBoas primeiras tarefas são de baixo risco, como melhorar alguns textos ou corrigir pequenos problemas de UI.
Se você já sabe o que quer alterar, peça diretamente e descreva o resultado desejado.
Revise o diff e verifique o resultado
Agora você pode acompanhar o Cursor trabalhando. A visualização de diff mostra as alterações feitas pelo agente.
Quando ele terminar, revise o diff e peça ao Cursor para executar as verificações que seu projeto já usa. Isso pode incluir testes, verificação de tipos, linting ou uma build local.
Quer um fluxo de trabalho de revisão mais robusto? Consulte Revisão e testes de código.
Use o modo Plan para alterações maiores
Agora que você conhece o básico, use o modo Plan para alterações maiores. Ele funciona bem quando a tarefa abrange vários arquivos, exige pesquisa ou precisa de aprovação antes da implementação.
Pressione Shift+Tab no campo de entrada do agente para alternar o modo Plan. Em vez de escrever código imediatamente, o Cursor irá:
- Pesquisar sua base de código para encontrar arquivos relevantes
- Fazer perguntas para esclarecer seus requisitos
- Criar um plano de implementação detalhado
- Aguardar sua aprovação antes de implementar
Para uma explicação mais detalhada, consulte Criar novas funcionalidades.