---
title: Início rápido
description: Instale o Lampson, abra um projeto, escolha um modelo de IA e dê sua primeira tarefa ao agente de programação no terminal — em cerca de dois minutos.
---
# Início rápido

O Lampson é um agente de programação que vive no seu projeto. Você o abre dentro de uma pasta, diz o que quer em palavras simples, e ele lê, edita e executa — mostrando cada passo e perguntando antes de qualquer ação arriscada.

## Instalar

```sh
npm i -g lampson
```

Não tem Node.js? Existe um instalador de uma linha para [Windows, macOS e Linux](/install) que traz tudo o que é preciso.

## Abrir um projeto

```sh
cd path/to/your/project
lampson            # no terminal
lampson --web      # no navegador, em http://127.0.0.1:8080
```

A pasta em que você está vira o **espaço de trabalho** (workspace) do agente: o único lugar em que ele pode ler ou escrever. Tanto o terminal quanto a versão web trabalham no mesmo projeto e compartilham as mesmas configurações e as mesmas sessões.

## Escolher um modelo

Na primeira vez, o Lampson pergunta duas coisas: qual **provedor** você usa (DeepSeek, Anthropic, OpenAI, Kimi, Groq, OpenRouter, Ollama…) e a sua **chave de API**. Isso fica salvo na sua máquina — em nenhum outro lugar — e é compartilhado pelo terminal e pela interface web. Mude quando quiser com `/model`.

Não tem um favorito? O DeepSeek é barato e funciona muito bem. O Ollama roda um modelo no seu próprio computador, sem chave nenhuma. Veja [Modelos e provedores](/pt/docs/providers).

## Pedir algo

Digite o que você quer, como diria a um colega:

```
❯ o formulário de login não mostra erro quando a senha está errada. corrija isso
```

Você verá o Lampson pesquisar, ler os arquivos relevantes, editar um deles e rodar os testes — cada passo em sua própria linha, com um ✓ e um resultado curto. Quando ele quer fazer algo com consequências (instalar um pacote, apagar arquivos, `git reset`), ele para e pergunta:

```
? bash npm install zod        allow? ❯ yes  no
```

Responda com as setas do teclado, ou com `p`/`d`. Ler e editar arquivos dentro do projeto nunca precisa de aprovação.

## Próximos passos

- [Sua primeira sessão](/pt/docs/first-run) — o terminal, os comandos com `/`, `!` para executar coisas você mesmo.
- [Permissões](/pt/docs/permissions) — o que é permitido, o que pergunta, o que é sempre recusado.
- [Plugins](/pt/docs/plugins) — dê novas ferramentas ao agente e ative-os quando quiser.