O que é o Claude Code e como começar

Quem ouve falar de inteligência artificial que escreve código costuma imaginar uma tela preta cheia de comandos difíceis, feita apenas para desenvolvedores experientes. Um aluno entrou no MazyOS achando que aprenderia a criar páginas do jeito antigo, arrastando blocos manualmente no Elementor. Já na segunda aula, quando clicou para visualizar o resultado no navegador, mandou mensagem no grupo dizendo que mal acreditava que estava criando um site inteiro sozinho, só conversando em português com a ferramenta.

O que o Claude Code faz

No chat comum do Claude no navegador, você faz uma pergunta e recebe um bloco de texto para copiar, colar e tentar organizar por conta própria. No Claude Code, a lógica muda por completo, porque a própria inteligência artificial trabalha dentro da pasta do projeto no seu computador. Ela lê os arquivos que já estão ali, cria as páginas que faltam, edita o que precisa de ajuste e executa os comandos necessários enquanto mostra cada etapa na tela.

Gosto de comparar o Claude Code a um programador experiente sentado ao seu lado, trabalhando sob a sua direção. Você descreve em português claro o que deseja construir ou corrigir, e ele cuida de toda a parte técnica nos bastidores.

Muita gente me pergunta se quem já assina o Claude precisa pagar algo por fora para ter o Code. Não precisa, porque os dois produtos são da Anthropic e usam a mesma conta. A diferença é que o chat apenas conversa, enquanto o Code executa o trabalho direto na pasta. Como a assinatura é única, a franquia de uso também é compartilhada entre o chat e o Claude Code, como explico em detalhes no guia sobre como funcionam os limites e tokens do Claude.

É justamente por trabalhar direto nos arquivos locais que a organização em pastas faz tanta diferença. Em uma aula aberta no YouTube em que mostro que toda a sua empresa vai funcionar dentro de pastas, deixei claro como o site do cliente, a proposta comercial e o tom de voz da marca ficam salvos no mesmo lugar para o Claude Code consultar sempre que precisar. Se você quer entender como o nosso método organiza essa rotina, veja a explicação sobre para que serve o MazyOS para quem já usa o Claude.

A ferramenta evolui rápido e ganha melhorias constantes. Quando conferi a documentação oficial para atualizar esta página, a versão mais recente era a 2.1.302, lançada em 16/10/2026. Quem instala pelo comando oficial recebe todas as atualizações automaticamente em segundo plano. Para conferir qual versão está instalada na sua máquina a qualquer momento, basta digitar claude --version no terminal.

Pra que serve pra quem não programa

Eu uso o Claude Code todos os dias para montar sites profissionais, propostas comerciais e estruturas de campanhas para os meus clientes, mesmo sem saber programar. Você não precisa decorar nenhuma linguagem de código para entregar um trabalho impecável. O Thiago Fernandes, por exemplo, entrou no treinamento numa terça-feira e já no dia seguinte fechou um contrato de R$ 8.000 aplicando a estratégia de preparar a prévia do site no Claude Code uma hora antes da reunião e mostrar tudo pronto na tela para o cliente:

Quando o projeto é um site institucional ou uma página de vendas, você não precisa se preocupar com configurações complexas de servidor. Já quando a entrega envolve um sistema com login e banco de dados que guarda informações de clientes, basta pedir ao próprio Claude para aplicar as travas de proteção do Supabase, seguindo os cuidados que detalho na resposta sobre se um site feito com IA é seguro e atende à LGPD.

Além de páginas institucionais e landing pages, essa mesma estrutura serve para construir sistemas internos sob medida e para criar um agente de IA que atende o WhatsApp de empresas locais e gera receita recorrente todo mês.

O que você precisa pra começar

Antes de abrir o instalador, vale conferir os quatro pontos básicos para que tudo funcione de primeira no seu computador:

• Uma assinatura ativa do Claude. O Claude Code não vem no plano grátis e vem incluso no Pro e no Max, sem nenhum custo adicional. Atualmente, o plano Pro custa R$ 110 por mês na assinatura pelo site, e você pode comparar todas as opções no guia sobre quanto custa cada plano do Claude ou tirar a dúvida sobre se existe alguma forma de usar o Claude Code de graça.
• Um computador comum com Windows ou Mac. Ele roda em qualquer máquina com Windows 10 (versão 1809 ou superior) ou macOS 13 (ou mais recente), pelo menos 4 GB de memória RAM e conexão com a internet. Não dá para instalar o programa completo no celular, mas você consegue disparar tarefas na nuvem e acompanhar o progresso pela aba Code do aplicativo móvel, como mostro em como usar o Claude Code no celular.
• O Git instalado na máquina. O Git é o programa gratuito que registra o histórico de versões dos seus arquivos e permite salvar cópias de segurança no GitHub. No Windows ele chega a ser opcional, mas recomendo fortemente instalar antes seguindo o nosso passo a passo para instalar e configurar o Git.
• Nenhuma experiência com código. Toda a comunicação com a ferramenta é feita em português, exatamente como você explicaria uma tarefa para alguém da sua equipe.

Os jeitos de usar o Claude Code

Você pode abrir e operar o Claude Code em quatro ambientes diferentes. Por trás da tela, o motor da inteligência artificial, a sua conta e o limite do seu plano são exatamente os mesmos; o que muda é apenas a interface visual onde você prefere trabalhar.

Quando alguém menciona o nome Claude CLI ou Claude Code CLI, está falando justamente de como usar o Claude Code no terminal. Você abre a janela de comando dentro da pasta do projeto, digita claude e passa a ter todos os comandos do Claude Code à disposição, como o /code-review, que revisa todas as alterações feitas nos arquivos em busca de falhas antes da entrega. A instalação do Claude CLI leva apenas um comando tanto no Windows quanto no Mac.

Se você já tem uma assinatura ativa do ChatGPT e prefere não trocar de plataforma agora, vale conhecer o que é o Codex da OpenAI, que cumpre o mesmo papel trabalhando direto nas pastas do computador e também roda o MazyOS.

Claude Code contra todas

A regra mais prática para escolher a sua ferramenta é simples: se você já assina o Claude, use o Claude Code; se já assina o ChatGPT, use o Codex; e se não pode pagar nenhuma assinatura agora, comece pelo Antigravity. O MazyOS funciona perfeitamente nos três ambientes, porque toda a memória de cada cliente fica salva nos arquivos da sua pasta, e não presa dentro de uma ferramenta específica.

Sempre que me perguntam qual é a melhor alternativa ao Claude Code, explico que a escolha da melhor IA para programar e construir projetos reais é aquela que cabe no seu momento atual sem travar o seu início. Quatro pontos ajudam a enxergar essa diferença com clareza:

• O Claude Code exige assinatura paga. Ele começa no plano Pro, que custa R$ 110 por mês pelo site oficial, já que a ferramenta não vem no plano gratuito.
• O Codex permite começar antes do plano Plus. Tanto na conta gratuita quanto no plano Go da OpenAI, o Codex vem só no app do ChatGPT pro computador, com o modelo GPT-6 Luna (a OpenAI libera aos poucos). Já o uso pelo terminal, no Codex CLI, entra a partir do plano Plus, que sai por US$ 20 por mês.
• O Antigravity oferece um plano grátis, de US$ 0 por mês, com limite de uso por semana. Por isso, ele é a porta de entrada ideal para quem precisa levantar os primeiros sites sem assumir mensalidade de inteligência artificial.
• Os três ambientes aceitam a mesma estrutura. Como a pasta do projeto e as instruções são universais, você pode migrar de um para o outro a qualquer momento sem perder nada do que já construiu, como detalho na explicação sobre onde o MazyOS funciona.

Na tabela comparativa abaixo, reuni o Claude Code ao lado do Codex, do Antigravity, do Cursor, do OpenCode, do Gemini CLI e das demais ferramentas que costumam gerar dúvida. Para quem presta serviço, as duas colunas decisivas são as que mostram se o programa aceita a pasta de comandos do MazyOS e se entrega o código livre para você publicar no domínio do seu cliente.

• Editores voltados para programadores: ferramentas como Cursor, GitHub Copilot, Kiro e Devin Desktop (antigo Windsurf) foram desenhadas para quem já escreve código linha por linha e quer autocompletar funções. Para quem não programa, elas trazem complexidade desnecessária, como detalho no comparativo entre Cursor ou Claude Code.
• Plataformas que prendem o site na nuvem delas: serviços como Lovable, Base44 e Manus criam a página dentro da própria plataforma, consumindo créditos a cada ajuste. Elas servem para testar um rascunho rápido, mas dificultam a vida de quem precisa entregar o site independente no nome do cliente.
• Modelos puros de inteligência artificial: nomes como DeepSeek, Kimi e Qwen são os cérebros de resposta, e não o programa que lê pastas no seu computador. Para funcionarem como o Claude Code, exigem configuração técnica de chaves de API e agentes externos.
• A ferramenta da xAI ainda está em observação: o Grok Build consegue ler o arquivo CLAUDE.md e as skills do Claude Code, mas ainda estamos avaliando o desempenho prático dele em projetos reais, enquanto o Grok Bot opera de outro jeito, rodando em um computador isolado na nuvem.

Depois de escolher por onde começar, mantenha a mesma ferramenta até entregar o projeto do seu primeiro cliente, pois trocar de ambiente no meio do caminho só gera distração. E se mais adiante você decidir mudar de assinatura, todo o histórico e o contexto do cliente continuam intactos nos arquivos .md dentro da pasta do projeto, seguindo a estrutura de CLAUDE.md e memória do Claude Code, prontos para serem lidos pela nova ferramenta.

E se eu não puder pagar agora?

Se o orçamento estiver curto neste momento, comece pelo Antigravity, a plataforma do Google que oferece um plano grátis, de US$ 0 por mês, com limite de uso por semana. Ele segue a mesma lógica de trabalhar direto nas pastas do seu computador e aceita os comandos do MazyOS. Você pode conhecer todos os detalhes no guia sobre o que é o Google Antigravity ou ver a comparação direta entre os dois em Antigravity ou Claude Code.

Da mesma forma, se você já paga o ChatGPT no seu dia a dia, não precisa abrir outra assinatura agora. Basta aproveitar o Codex que já vem no seu plano e comparar o funcionamento prático dos dois no comparativo entre Codex e Claude Code.

Eu sempre repito para os alunos na comunidade que ninguém deve travar por falta de ferramenta paga no início. Comece com o que você já tem em mãos, seja o plano gratuito do Antigravity ou a assinatura que você já usa, monte a primeira prévia e feche o primeiro serviço. Quando o pagamento do cliente cair na conta, você usa esse próprio valor para assinar o Claude.

Por onde eu começaria

Se você quer colocar o Claude Code para rodar ainda hoje sem dar volta, siga esta sequência de quatro passos:

1. 1Ative o plano Pro da Anthropic, que já libera o Claude Code na sua conta, ou confira antes qual plano vale mais a pena assinar entre Pro e Max.
2. 2Instale o Git no seu computador seguindo o passo a passo de instalação do Git para garantir que os comandos e backups funcionem sem aviso de erro.
3. 3Baixe o VS Code e instale a extensão oficial seguindo o guia do Claude Code no VS Code. Se preferir usar direto pelo terminal, siga o tutorial de instalação no Windows ou no Mac.
4. 4Abra uma pasta vazia para o seu projeto, conecte o login da sua assinatura e faça o seu primeiro pedido em português.

Gravei um tutorial completo em vídeo mostrando exatamente essa jornada na minha tela, desde a instalação do zero até o primeiro projeto funcionando:

Para você ver como esse passo a passo é tranquilo mesmo para quem nunca abriu um terminal na vida, olha o relato que um aluno de 67 anos deixou nos comentários logo depois de assistir à aula e repetir o processo em casa:

Se você prefere aprender com acompanhamento estruturado ou quer conhecer as opções de formação disponíveis no mercado, preparei um comparativo completo de cursos de Claude Code, incluindo as aulas oficiais da Anthropic.

O primeiro contato com a ferramenta é sempre o momento que dá mais frio na barriga. Quando alguém entra no MazyOS e comenta que os comandos não apareceram na tela, quase sempre é só questão de abrir a pasta principal do sistema no editor. E se mesmo assim você travar, a nossa equipe entra em uma chamada de vídeo com você para deixar tudo configurado, pois essa é a Garantia de Destrave Técnico, uma das nossas três garantias oficiais.

Os erros que mais travam quem tá começando

Caso apareça algum aviso em inglês na sua tela durante a instalação ou no primeiro uso, separei a solução exata para os cinco alertas mais comuns:

• Git is not in PATH, que aparece quando o sistema ainda não encontrou o Git instalado no computador.
• Credit balance is too low, que acontece quando você tem a assinatura paga, mas acabou fazendo login pela conta de créditos de API sem perceber.
• Prompt is too long, quando uma mesma conversa acumula arquivos demais e ultrapassa o tamanho de leitura da sessão.
• Aviso de comando não reconhecido no Windows, quando a instalação termina, mas o PowerShell ainda precisa atualizar o caminho da pasta do programa.
• Limite de uso atingido, quando a franquia da janela de cinco horas chega ao fim e você precisa saber como continuar o projeto.

Logo abaixo você encontra o mapa completo com todos os tutoriais de instalação, configuração e resolução de erros do Claude Code, além da nossa página de perguntas frequentes para consultas rápidas.

Se você quiser explorar os recursos que trabalham ao lado dele, vale conhecer também o Claude Cowork, que organiza tarefas da sua rotina dentro do aplicativo de computador, e entender como funcionam as skills do Claude, que ensinam a inteligência artificial a repetir um método de trabalho sempre com o mesmo padrão.

O Claude Code e o MazyOS

Quando você usa o Claude Code puro, ele já é uma ferramenta impressionante, mas a cada projeto novo você precisa explicar do zero como quer o design, a estrutura de vendas e o tom de voz. O MazyOS resolve exatamente isso sem ser um programa separado, como detalho ao explicar se o MazyOS é um aplicativo. Ele é uma pasta inteligente de comandos e processos que roda no Claude Code, no Codex e no Antigravity. Basta abrir a pasta do sistema, chamar o comando da etapa em que você está e deixar o Claude montar o site, a proposta comercial e os materiais do cliente mantendo toda a memória do negócio organizada.