# Guia: DeerFlow, o agente grátis da ByteDance que transforma uma pergunta num projeto pronto

> Um guia do @souoallan.
> DeerFlow: https://github.com/bytedance/deer-flow · da ByteDance (a dona do TikTok), grátis, código aberto (MIT),
> mais de 80 mil estrelas (conferido em 29/10/2026). Site: https://deerflow.tech

## O que é

Um agente de IA que não para na primeira resposta. Tu faz uma pergunta e ele continua: pesquisa, escreve código e cria
arquivos, até em tarefa que leva horas. Divide pedaços do trabalho com agentes ajudantes e lembra o que aprendeu no
caminho. No fim tu revisa um trabalho pronto, com as fontes pra conferir.

## Do que tu precisa

- Um computador (Mac, Windows ou Linux) com o **Claude Code** (ou o Codex) pra fazer a instalação por ti.
- O Docker Desktop (grátis). O Claude te ajuda a instalar.
- Um modelo de IA pro DeerFlow usar. Dá pra usar a tua chave de API (OpenAI, Anthropic, Google, OpenRouter), que cobra
  pelo uso, ou a tua conta do Claude Code ou do Codex, que o DeerFlow aceita como provedor.
- Uma tarde pra primeira instalação.

## Passo a passo

1. Cria uma pasta vazia (em Documentos, por exemplo) e abre ela no Claude Code.
2. Cola o prompt abaixo. Ele segue o guia oficial de instalação da ByteDance e te pede licença: tu só clica em **Permitir**.
3. Quando ele precisar de chave, abre o arquivo de configuração no editor pra tu colar. Chave nunca vai no chat.
4. Quando terminar, ele te dá o endereço da tela do DeerFlow no navegador. Faz a primeira pergunta.

## O prompt pra colar no Claude Code (ou no Codex)

```text
Clona o DeerFlow nesta pasta, se precisar, e prepara ele pra rodar no meu computador seguindo o guia oficial:
https://raw.githubusercontent.com/bytedance/deer-flow/main/Install.md
Usa o Docker se der.

Fala comigo sempre em português do Brasil, simples, como se eu nunca tivesse aberto um terminal.
Eu não mexo em terminal: roda tu todos os comandos, eu só clico em Permitir.
Se faltar o Docker Desktop, me explica o que é, me manda o link oficial e me espera instalar.

Sobre o modelo de IA:
- me pergunta se eu quero usar a minha conta do Claude Code/Codex ou uma chave de API, e me diz o custo de cada um;
- nunca me pede chave no chat: abre o arquivo de configuração no editor pra eu colar.

No fim, abre o DeerFlow no navegador, me diz o endereço e me sugere uma primeira pergunta pra testar, tipo:
"Estuda o mercado de cafeteria delivery em Porto Alegre, compara 3 opções de cardápio e rascunha um plano de 30 dias."
Termina com: **Feito**, **O que eu preciso de ti** e **Próximo passo**.
```

## Bom saber

- **É de graça?** O DeerFlow é. O modelo de IA que ele usa cobra pelo uso (ou gasta do teu plano do Claude/Codex).
  Tarefa longa gasta mais: começa com pergunta pequena.
- **Confio no que ele entrega?** Confere as fontes. A vantagem é revisar um trabalho pronto, não cinco chats soltos.
- **É seguro?** Roda no teu computador, dentro do Docker. Não dá acesso a pasta com coisa sensível.
