Início/Blog/Claude Code
Claude Code

Como instalar o Claude Code no Windows e no Mac: passo a passo sem terminal

·11 min de leitura
Imagem editorial sobre como instalar o claude code no windows e no mac: passo a passo sem terminal

O Claude Code é a ferramenta de IA da Anthropic que coloca o Claude para executar trabalho dentro do seu computador: ler arquivos, escrever documentos, rodar processos, seguir um método do começo ao fim. Ele nasceu como assistente de codificação, uma IA para programação que lê sua base de código e executa comandos, e por isso quase todo tutorial de instalação foi escrito por programador, para programador, com terminal aberto.

Este guia passo a passo é diferente em uma coisa: ele não usa terminal em nenhum momento. Você vai instalar dois programas, entrar na sua conta e começar a usar em português. Se você trabalha com marketing e nunca instalou nada além de aplicativo de celular, é para você. Se você é programador e quer o comando de instalação pelo terminal, ele está mais abaixo, completo, porque também vale saber.

Instalar leva uns 20 minutos. Você faz isso uma vez.

O que é o Claude Code, em uma frase

É o Claude com as mãos livres. No claude.ai você conversa e ele responde. No Claude Code você conversa e ele executa: abre a pasta que você indicou, lê o que está lá dentro, cria arquivos, segue instruções gravadas e devolve um resultado pronto. É o que hoje se chama de agent, e não de chatbot. Para quem programa, isso significa escrever e corrigir código. Para quem faz marketing, significa auditoria, relatório, campanha e calendário saindo do mesmo lugar, do mesmo jeito toda vez, e automatizar tarefas que hoje você começa do zero. É essa segunda parte que me interessa, e é a razão de este site existir.

Antes de instalar: requisitos e o custo

Vale resolver isso antes de baixar qualquer coisa, porque é aqui que a maioria trava.

Sistema operacional. Windows 10 ou 11, ou macOS 10.15 em diante. Linux também funciona, pelo caminho do terminal.

Um plano pago do Claude. Este é o ponto que quase ninguém diz na cara. O plano gratuito do claude.ai não serve para o Claude Code. Você precisa do plano Pro, que custa US$ 20 por mês, ou de um plano acima dele. Também dá para usar por chave de API, pagando pelo uso, mas para quem está começando o plano mensal é mais simples e mais previsível. Se você não pretende usar pelo menos uma vez por semana, esse custo provavelmente não se paga, e é melhor saber agora.

Para o caminho sem terminal: só o VS Code, que é gratuito, na versão 1.94 ou mais nova. A extensão VS Code do Claude Code já traz o Claude Code embutido. Você não instala Git, não instala Node, não instala nada de programador.

Para o caminho pelo terminal: no Windows, o Git para Windows precisa estar instalado, porque o Claude Code usa o Git Bash por baixo. No Mac e no Linux não precisa de nada além do próprio terminal.

Você não precisa saber programar. Vou repetir isso mais uma vez ao longo do texto porque é a dúvida mais comum, e a resposta continua sendo não.

Caminho 1: instalar o Claude Code pelo VS Code, sem terminal

Este é o caminho que eu recomendo para quem trabalha com marketing. São quatro passos.

Passo 1: criar a conta na Anthropic e assinar o plano

Vá para claude.ai e clique em criar conta. Você digita o email, recebe um código de seis dígitos, confirma, preenche o nome. A conta nasce gratuita.

Depois, logado, clique na sua inicial ou foto no canto da tela, procure a opção de planos e escolha o Pro. Você decide entre pagar por mês ou pelo ano inteiro (o anual sai mais barato por mês). Na dúvida, comece no mensal. Preencha o cartão e confirme.

Você vai ver um plano chamado Max, bem mais caro. Ele existe para quem usa a IA o dia inteiro. Comece no Pro. Se um dia você esbarrar no limite de uso, o próprio Claude avisa, e aí você decide.

Passo 2: instalar o VS Code

O VS Code é um programa gratuito da Microsoft. Pense nele como a mesa de trabalho: você quase não vai usar nada dele, só precisa que ele esteja lá, porque é dentro dele que o painel do Claude Code vai morar.

Vá para code.visualstudio.com. O site detecta o seu sistema e mostra o botão certo de download.

No Windows: abra o instalador que foi para a pasta Downloads, aceite os termos e vá avançando. Numa das telas aparecem caixinhas de opção. Marque a que diz para adicionar a ação de abrir com o Code ao menu de contexto de diretório. Isso te poupa cliques depois. Instale.

No macOS: abra o arquivo baixado, arraste o ícone do Visual Studio Code para a pasta Aplicativos e abra a partir dela. Na primeira vez o Mac pergunta se você confia; clique em abrir.

Na primeira abertura costuma aparecer um aviso no canto inferior direito oferecendo o pacote de idioma português. Aceite. Se o aviso não aparecer, siga em inglês, não muda nada do que vem a seguir.

Passo 3: instalar a extensão do Claude Code

Na barra fina do lado esquerdo, procure o ícone de quatro quadradinhos com um deles solto. É a loja de extensões. Clique nele.

Na caixa de busca que aparece no topo, digite Claude Code. O resultado certo é o que tem a Anthropic como autora. Clique em Install e espere. Leva menos de um minuto.

Se aparecer um erro dizendo que a versão do editor é antiga, é porque a extensão exige a 1.94 ou mais nova. Vá em Ajuda, depois em Verificar Atualizações, atualize e tente de novo. Quem acabou de baixar não passa por isso.

Se você usa uma IDE da JetBrains em vez do VS Code, existe o plugin Claude Code do JetBrains Marketplace, com o mesmo painel. O restante do tutorial vale igual.

Passo 4: autenticar e abrir o painel

Depois de instalar, aparece um ícone novo na mesma barra lateral: uma faísca. Clique nele. Um painel abre do lado. Na primeira vez ele pede para você entrar. Clique em Sign in.

O seu navegador abre sozinho, já logado na conta que você criou no passo 1. Confirme a autorização e volte para o editor. O painel agora mostra a caixa de digitar mensagem. Você só faz esse login uma vez. Da próxima vez que abrir, ele já está conectado.

Como conferir se funcionou: o primeiro prompt

Abra qualquer pasta (menu Arquivo, Abrir Pasta) e, no painel, escreva alguma coisa simples em português. Por exemplo:

lista o que tem nesta pasta e me diz o que é cada arquivo

Se ele responder olhando os arquivos de verdade, está funcionando. É o primeiro prompt, e ele já mostra a diferença para o chat comum: ele não está adivinhando, está lendo o que existe no seu computador.

Pronto. Você concluiu a instalação do Claude Code sem abrir um terminal.

Caminho 2: instalar Claude Code pelo terminal (comando de instalação)

Se você prefere trabalhar com comandos no terminal, ou se vai usar o Claude Code em Linux, num servidor, ou dentro do WSL, o caminho é o instalador nativo da Anthropic. Ele instala o CLI, que você chama digitando claude.

No macOS e no Linux, abra o terminal e execute:

curl -fsSL https://claude.ai/install.sh | bash

No Windows, com o Git para Windows já instalado, abra o PowerShell e execute:

irm https://claude.ai/install.ps1 | iex

Pelo WSL (Linux dentro do Windows), use o mesmo comando do Linux, dentro do WSL.

Pelo npm, se você já tem o Node.js e prefere gerenciar assim:

npm install -g @anthropic-ai/claude-code

Durante a instalação o instalador cuida do resto. Terminada, entre numa pasta de trabalho, digite claude e aperte Enter. Na primeira execução ele pede a autenticação: escolha entrar com a conta do Claude (a mesma do plano Pro), o navegador abre, você autoriza, e o terminal fica pronto para receber o primeiro prompt. Se em algum momento você precisar entrar de novo, o comando é /login.

Uma observação sobre o Windows: o Claude Code roda nativo, mas depende do Git Bash que vem com o Git para Windows. Se o instalador reclamar que não achou o Git, instale-o primeiro e rode de novo. Quem for pelo caminho 1 não passa por isso, porque a extensão já traz tudo.

O terminal integrado do próprio VS Code também serve para isso. Mas, para ser claro, o painel da extensão faz tudo que você precisa sem esse passo. E existe ainda o aplicativo desktop do Claude, que também abre o Claude Code, se você preferir uma janela própria em vez do editor.

Como atualizar e como desinstalar

Pela extensão: as atualizações chegam sozinhas, junto com as outras extensões. Você não precisa fazer nada. Para desinstalar, volte na loja de extensões, encontre o Claude Code e clique em desinstalar.

Pelo CLI: ele se atualiza sozinho em segundo plano, e você pode forçar com claude update. Para desinstalar, remova do jeito que instalou (pelo npm, com npm uninstall -g @anthropic-ai/claude-code; pelo instalador nativo, apagando o binário que ele criou na sua pasta de usuário).

Configuração inicial: por onde começar a usar Claude Code

Instalar é a parte fácil. O que muda o resultado é o que você configura em volta, e é aqui que o fluxo de trabalho de quem faz marketing começa a se separar do de quem programa.

O arquivo CLAUDE.md. É um arquivo de texto simples que você deixa na raiz da pasta de trabalho, com instruções que o Claude Code lê antes de qualquer conversa: quem você é, o que essa pasta é, como você quer que ele trabalhe. É a diferença entre explicar tudo de novo toda vez e ele já saber. Para configurar, basta criar o arquivo e escrever em português.

As skills. São arquivos que carregam um processo inteiro (a sequência de passos, os critérios, o que conferir), para o Claude Code executar do mesmo jeito toda vez. É com skill que ele deixa de ser um chat esperto e vira uma ferramenta de trabalho. Escrevi um guia só sobre isso: o que são skills do Claude Code e como instalar.

Os servidores MCP. São conexões que dão ao Claude Code acesso a outras ferramentas: um navegador, uma planilha, uma API. Não precisa disso no primeiro dia. Precisa saber que existe.

A configuração avançada (permissões, modelo padrão, integrações) está toda na documentação oficial, o Claude Code Docs, que tem versão em português. Vale um favorito, não vale uma leitura no primeiro dia.

Se você trabalha com marketing e quer pular a parte de montar tudo isso do zero, é exatamente o que o Marketing Pronto entrega: skills prontas para auditoria, campanha, relatório e conteúdo, uma apostila com foto de cada tela, e o entregável saindo com a sua marca. A instalação que você acabou de fazer é o passo 1 da apostila.

Perguntas frequentes

O Claude Code funciona no Windows? Sim. Pela extensão do VS Code, funciona direto. Pelo terminal, funciona no Windows nativo desde que o Git para Windows esteja instalado, ou dentro do WSL.

Preciso pagar para usar o Claude Code? Sim. O plano gratuito do claude.ai não dá acesso ao Claude Code. O plano de entrada é o Pro, a US$ 20 por mês, e também dá para usar por chave de API pagando pelo consumo.

Preciso saber programar? Não. Você conversa em português. O que muda entre um programador e um profissional de marketing usando o Claude Code é o que cada um pede, não a ferramenta.

Qual modelo do Claude o Claude Code usa? Ele usa os modelos atuais da Anthropic e escolhe um padrão sozinho de acordo com o seu plano. Dá para trocar de modelo durante o uso, mas no começo você não precisa mexer nisso.

Instalei pela extensão. Preciso instalar pelo terminal também? Não. A extensão traz o Claude Code embutido. O CLI é um caminho alternativo, não um pré-requisito.

Funciona em qualquer terminal? No Mac e no Linux, sim, nos terminais comuns. No Windows, pelo PowerShell ou pelo Git Bash, ou pelo WSL. E há o terminal integrado do VS Code, se você preferir tudo num lugar só.

Quer a IA executando isso por você?

O Marketing Pronto entrega skills prontas de Claude Code para auditoria, campanha, relatório e conteúdo. O processo roda do mesmo jeito toda vez, e o entregável sai com a sua marca.