---
title: Configuração
description: Tudo é opcional. Onde ficam as configurações do Lampson, o que o .env pode sobrescrever e os poucos ajustes do agente de programação que vale a pena conhecer.
---
# Configuração

Nada é obrigatório. O assistente da primeira execução escreve o que precisa; todo o resto tem um padrão sensato.

## Onde

- `~/lampson/.lampson/config.json` — provedor, modelo, chaves (seladas), preferências. Escrito por `/setup`, pelo ⚙ da web e pela pílula do provedor. Compartilhado pelo terminal e pela interface web.
- `~/lampson/.env` — sobrescritas opcionais das mesmas configurações, mais os ajustes abaixo. O `.env` prevalece sobre o `config.json`.
- `LAMPSON_HOME` — mover `~/lampson` para outro lugar.

## Provedor

```sh
LAMPSON_PROVIDER=deepseek        # openai | deepseek | kimi | groq | grok | openrouter | ollama | anthropic | minimax
LAMPSON_API_KEY=sk-...           # ou LAMPSON_API_KEY_DEEPSEEK=… uma por provedor
LAMPSON_MODEL=deepseek-chat
LAMPSON_BASE_URL=…               # qualquer endpoint compatível (sem barra no final)
LAMPSON_WIRE=openai              # openai | anthropic, quando o preset não consegue adivinhar
```

## Comportamento

```sh
LAMPSON_PERMISSION=ask           # ask | yolo | strict (o modo padrão)
LAMPSON_MAX_STEPS=40             # passos de ferramenta por turno
LAMPSON_BUDGET_TOKENS=400000     # orçamento de custo por turno (tokens em cache contam 10%)
LAMPSON_COMPACT_AT=80000         # compactar o contexto acima desta estimativa
LAMPSON_MAX_TOKENS=8192          # limite de saída por resposta (dobra sozinho em resposta vazia)
LAMPSON_TIMEOUT=180              # segundos por chamada ao modelo
LAMPSON_EXPLORE_CAP=12           # chamadas de só leitura seguidas antes de um empurrão para agir
```

## Shell (Windows)

Os comandos rodam pelo bash do Git por padrão. Para usar outra coisa:

```sh
LAMPSON_SHELL=C:\Program Files\Git\bin\bash.exe
LAMPSON_SHELL_FLAG=-c
```

## Execuções sem ninguém por perto e aprovações

```sh
LAMPSON_TZ=-03:00                # para "daily 09:00" (padrão: o do sistema)
LAMPSON_PUBLIC_URL=https://…     # como este Lampson é alcançado de fora
LAMPSON_WEBHOOK_URL=https://…    # POST para cada aprovação pendente
LAMPSON_WEBHOOK_SECRET=…         # assinatura HMAC-SHA256 do corpo
LAMPSON_WEB_TOKEN=…              # permitir que um script não local chame a API web (Bearer)
```

Veja [Tarefas agendadas](/pt/docs/schedules).

## Por projeto

Coisas que você pode querer versionar, para que sua equipe também as tenha: `.lampson/plugins/` ([plugins](/pt/docs/plugins)), `.lampson/mcp.json`, `.lampson/lsp.json`, `skills/`, `AGENTS.md`. O Lampson não escreve mais nada no seu projeto.