Pular para o conteúdo
← Todos os tutoriais

Trilha Agentes de código do zero · 1 de 3

Claude Code do zero: seu primeiro site em 20 minutos, sem saber programar

Tutorial para iniciantes: instale o Claude Code no macOS, Windows ou Linux e peça, em português, um site que abre no seu navegador.

20 min: Claude Code do zero: seu primeiro site, sem saber programar

Por que aprender isso agora

Opinião do Inferia

Na nossa visão, usar um agente de código é a habilidade de IA que mais rende para quem não programa. Você deixa de depender de alguém para tarefas pequenas, como uma página de vendas, um ajuste no site ou um script que organiza planilhas. E o que você aprende aqui serve para os outros agentes, como o Codex.

Vale para você se
  • quer criar páginas e protótipos sem esperar um dev
  • repete tarefas no computador que poderiam ser automáticas
  • quer testar uma ideia de negócio em uma tarde
Ainda não vale se
  • você só quer conversar com IA: o chat grátis resolve
  • não quer pagar assinatura: o Claude Code exige o plano Pro ou superior

Atualizado em 17/10/2026· conferido com a documentação oficial do Claude Code

Teste automático:macOS: em configuraçãoWindows: em configuraçãoLinux: em configuração

Quando a ferramenta muda, este tutorial é testado de novo e esta data muda junto.

Iniciante · 20 min · precisa do plano Pro do Claude ou superior

Seu computador

  1. Confira se você pode usar

    O Claude Code precisa de uma assinatura paga do Claude (Pro, Max, Team ou Enterprise) ou de uma conta no Console da Anthropic. O plano grátis do claude.ai não inclui o Claude Code.

    O que é Console da Anthropic?

    O painel para desenvolvedores, em que você paga pelo uso em vez de uma assinatura mensal.

    Prefere não usar o terminal? Existe o app desktop do Claude Code para macOS, Windows e Linux. Este tutorial segue pelo terminal, que funciona igual em todos.

  2. Abra o terminal

    Aperte Cmd + Espaço, digite Terminal e aperte Enter.

    Abra o menu Iniciar, digite PowerShell e abra o Windows PowerShell.

    Aperte Ctrl + Alt + T. Na maioria das distribuições, isso abre o terminal.

    O que é terminal?

    Uma janela em que você dá ordens ao computador digitando, em vez de clicar. Parece intimidador, mas aqui você só vai copiar e colar.

  3. Instale o Claude Code

    Copie o comando, cole no terminal e aperte Enter. Ele não mostra progresso enquanto baixa: espere até o terminal voltar a aceitar comandos.

    terminal
    curl -fsSL https://claude.ai/install.sh | bash
    terminal
    irm https://claude.ai/install.ps1 | iex
    terminal
    curl -fsSL https://claude.ai/install.sh | bash
    Deu erro?
    • Apareceu “syntax error”, “403” ou outro erro: a página oficial de solução de problemas de instalação lista cada erro e a correção.
    Deu erro?
    • “irm não é reconhecido”: você abriu o Prompt de Comando (CMD), não o PowerShell. Abra o PowerShell e cole de novo.
    • Outro erro: veja a página oficial de solução de problemas de instalação.
    Deu erro?
    • Apareceu “syntax error”, “403” ou outro erro: veja a página oficial de solução de problemas de instalação.

  4. Confira a instalação

    Feche o terminal, abra um novo e rode:

    terminal
    claude --version

    O que deve aparecer: um número de versão, como “2.1.211 (Claude Code)”.

    Deu erro?
    • “claude não encontrado” ou “não reconhecido”: o terminal ainda não enxerga o programa. Feche todas as janelas do terminal e abra de novo. Se continuar, rode claude doctor, que mostra o problema e como resolver.

  5. Crie uma pasta para o site

    O Claude Code trabalha dentro da pasta em que você está. Crie uma pasta nova e entre nela, um comando de cada vez:

    O que é pasta no terminal?

    É a mesma pasta que você vê no Finder ou no Explorador de Arquivos. mkdir cria a pasta e cd entra nela.

    terminal
    mkdir meu-site
cd meu-site

  6. Abra o Claude Code e faça login

    Rode o comando abaixo. Na primeira vez, o navegador abre para você entrar com a sua conta do Claude. Depois, volte para o terminal.

    terminal
    claude
    Deu erro?
    • O navegador não abriu: copie o link que aparece no terminal e cole no navegador.

  7. Peça o seu site

    Escreva o pedido em português, como se falasse com uma pessoa, e aperte Enter. Quando o Claude perguntar se pode criar o arquivo, aceite.

    O que é prompt?

    O pedido que você escreve para a IA. Quanto mais detalhes (cores, textos, o que você vende), melhor o resultado.

    digite no Claude Code
    Crie um site de uma página para a minha cafeteria, com cardápio, horário de funcionamento e um botão de WhatsApp. Use só HTML e CSS, em um arquivo index.html.

    Troque “cafeteria” pelo seu negócio. Depois, peça ajustes do mesmo jeito: “deixe o fundo escuro”, “aumente o título”.

  8. Veja o resultado

    Digite /exit para sair do Claude Code e abra o site no navegador:

    terminal
    open index.html
    terminal
    start index.html
    terminal
    xdg-open index.html

    O que deve aparecer: o navegador abre o seu site.

Histórico deste tutorial

  • 17/10/2026 · publicado, conferido com a documentação oficial

Fontes: Documentação oficial do Claude Code: instalação. Escrito pela IA do Inferia. Versão em Markdown: /tutoriais/claude-code-do-zero.md