O Claude Code é a ferramenta de programação da Anthropic que roda no terminal: uma CLI com um agente de inteligência artificial que lê o seu projeto, edita arquivos, roda comandos e explica o que está fazendo. Para instalar, basta um comando (curl -fsSL https://claude.ai/install.sh | bash no Mac, no Linux e no WSL, ou irm https://claude.ai/install.ps1 | iex no PowerShell do Windows) e, depois, digitar claude dentro da pasta do projeto. O uso exige um plano pago da Anthropic ou uma conta do Console, e o Curso de Claude Code do ValorFinal ensina a ferramenta do zero ao avançado, com aulas gratuitas.
Resposta rápida
- O Claude Code é um agente de IA que trabalha no terminal, dentro da pasta do projeto: lê, edita, roda comandos e usa o git. Também existe no VS Code, no JetBrains, em aplicativo de desktop e na web.
- Instalação:
curl -fsSL https://claude.ai/install.sh | bashno Mac, Linux e WSL;irm https://claude.ai/install.ps1 | iexno PowerShell. Confira comclaude --versioneclaude doctor. - Custo: exige Pro, Max, Team, Enterprise ou uma conta do Console, que cobra pelo uso. O plano gratuito do Claude não inclui a ferramenta.
- Para começar com segurança: abra o terminal na pasta do projeto, digite
claude, peça primeiro uma explicação e mantenha o projeto no git para poder voltar atrás.
Como instalar o Claude Code, passo a passo
O caminho recomendado pela documentação oficial, e o que o curso ensina, é o instalador nativo: um comando que baixa a ferramenta da fonte da Anthropic, configura tudo e mantém o Claude Code atualizado sozinho, em segundo plano. Ele não depende do Node.js. O roteiro completo tem cinco passos:
- Confira os requisitos: macOS 13 ou mais novo; Windows 10 na versão 1809 ou mais nova (ou Windows Server 2019); Ubuntu 20.04, Debian 10 ou Alpine 3.19 em diante. O computador precisa de pelo menos 4 GB de RAM, processador x64 ou ARM64 e internet, porque o raciocínio do agente acontece nos servidores da Anthropic.
- Abra o terminal certo. No Windows, busque PowerShell no menu Iniciar e veja se a linha começa com PS. No Mac, abra o Terminal em Aplicativos, Utilitários, ou pelo Spotlight. No Linux, o atalho Ctrl + Alt + T costuma abrir o terminal. Quem nunca usou um terminal pode começar pela aula o terminal sem medo, que explica o básico sem jargão.
- Cole o comando do seu sistema, mostrado logo abaixo, e aperte Enter.
- Abra um terminal novo e digite
claude --version. Se aparecer um número de versão, a instalação deu certo. - Entre na pasta do projeto e digite
claude. Na primeira vez, o navegador abre para você fazer login na sua conta.
No Mac, no Linux e no WSL
No terminal, rode o instalador nativo:
curl -fsSL https://claude.ai/install.sh | bashO WSL é o Linux que roda dentro do Windows. Para usar o Claude Code por ele, abra a sua distribuição do WSL e rode o mesmo comando do Linux: você instala e inicia o claude dentro do terminal do WSL, e não pelo PowerShell. É a escolha de quem já trabalha com ferramentas de Linux no Windows.
No Windows, pelo PowerShell
irm https://claude.ai/install.ps1 | iexNão é preciso abrir o PowerShell como administrador. O Git para Windows é opcional, mas recomendado: com ele instalado, o Claude Code usa o Git Bash para rodar comandos; sem ele, usa o próprio PowerShell. Se você estiver no Prompt de Comando (CMD), em que a linha começa só com o caminho, sem o PS, o comando é outro:
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmdEsse comando para o CMD está na documentação oficial. O curso usa o PowerShell em todos os exemplos de Windows, porque é o terminal que ele recomenda.
Outros caminhos: npm, Homebrew e WinGet
Há alternativas oficiais para quem já usa um gerenciador de pacotes. A diferença que mais pesa no dia a dia é a atualização: o instalador nativo se atualiza sozinho, e Homebrew e WinGet pedem que você rode a atualização.
| Caminho | Comando de instalação | Como atualizar |
|---|---|---|
| Instalador nativo (recomendado) | O comando com curl ou com irm, mostrado acima | Sozinho, em segundo plano; claude update força na hora |
| npm (pede Node.js 22 ou mais novo) | npm install -g @anthropic-ai/claude-code | npm install -g @anthropic-ai/claude-code@latest |
| Homebrew (Mac e Linux) | brew install --cask claude-code | brew upgrade claude-code |
| WinGet (Windows) | winget install Anthropic.ClaudeCode | winget upgrade Anthropic.ClaudeCode |
No npm, dois cuidados. Nunca instale com sudo npm install -g, que causa problema de permissão e risco de segurança. E, para atualizar, evite o npm update -g, que respeita a faixa de versão da instalação original e pode não trazer a versão mais nova. Em Debian, Ubuntu, Fedora, RHEL e Alpine, a documentação oficial também publica repositórios apt, dnf e apk, atualizados pelo fluxo normal de atualização do sistema.
Confirme que deu certo
claude --version
claude doctorO primeiro comando mostra o número da versão instalada, seguido de (Claude Code). O segundo faz um diagnóstico só de leitura, sem abrir sessão: confere a saúde da instalação, valida os arquivos de configuração e aponta avisos com a correção sugerida. A aula instalando o Claude Code no Windows, no Mac e no Linux repete esse roteiro e traz um jogo de verdade ou mito sobre os tropeços da instalação.
O que é o Claude Code e como ele trabalha
A diferença entre o Claude Code e um chat de IA é a que existe entre um consultor que manda um relatório por e-mail e um colega que senta ao seu lado e abre os arquivos. O chat devolve texto para você copiar. O Claude Code age dentro da pasta onde foi iniciado: lê o código, escreve e edita arquivos, roda testes e comandos, faz commits no git e explica o que está fazendo. Por ser uma CLI, uma interface de linha de comando, ele mora no terminal, e é ali que os recursos novos costumam chegar primeiro.
Por dentro, ele trabalha em ciclo: entende o pedido, planeja, age com uma ferramenta (ler um arquivo, editar, rodar um comando, buscar um trecho), observa o resultado e decide o próximo passo. O ciclo termina quando o objetivo é cumprido ou quando ele precisa de uma decisão sua. Saber disso ajuda a pedir melhor: um pedido com objetivo, contexto e critério de sucesso dá ao agente um alvo e um jeito de saber que terminou.
Três nomes costumam ser confundidos. Claude é a família de modelos de IA da Anthropic, com linhas como Opus (a mais capaz), Sonnet (o equilíbrio) e Haiku (a mais rápida e econômica). Claude.ai é o chat, no site e nos aplicativos. Claude Code é a ferramenta que põe o modelo para trabalhar no seu projeto, e o comando /model troca o modelo da sessão. A aula o que é o Claude Code, afinal abre o curso com essa distinção.
Na prática, ele rende mais em tarefas que um chat resolve mal: entender um projeto que você acabou de herdar, caçar um bug espalhado por vários arquivos, escrever e rodar testes, aplicar a mesma correção em muitos lugares e abrir um pull request com a descrição do que mudou. Nada disso dispensa a sua revisão, porque o agente também erra, e erra com a mesma confiança com que acerta.
Existe Claude Code para baixar, com janela e botões?
Quem procura o download do Claude Code costuma esperar um instalador de clicar. A versão de terminal não funciona assim: o próprio comando de instalação baixa o programa oficial da Anthropic e o configura, sem arquivo para abrir. Desconfie de site que oferece o Claude Code para baixar em outro endereço e instale só pelos comandos da documentação oficial.
Para quem prefere janelas, existe o aplicativo de desktop do Claude Code, para Mac, Windows e Linux, com o mesmo agente numa interface gráfica. E há outras portas para a mesma ferramenta:
- extensão para o VS Code e plugin para as IDEs da JetBrains, em que as mudanças aparecem no próprio editor como diferenças que você revisa ali;
- versão web, que roda no navegador sem instalar nada;
- acesso pelo celular, para acompanhar uma tarefa longe da mesa;
- integrações de automação, como o GitHub Actions e o SDK para montar agentes próprios.
É o mesmo agente em todas. O que você aprende no terminal vale no editor e no aplicativo, e o terminal segue como a base mais completa.
Quanto custa o Claude Code e qual plano ele exige?
O Claude Code não tem versão gratuita. Ele exige uma conta com plano compatível: as assinaturas Pro, Max, Team ou Enterprise, ou uma conta do Console, a plataforma de desenvolvedores da Anthropic, que cobra pelo uso. O plano gratuito do Claude.ai, o do chat, não inclui a ferramenta. Essa era a regra na revisão do curso, em julho de 2026, e a página oficial de planos da Anthropic, consultada em setembro de 2026, continuava marcando o Claude Code como incluído no Pro, no Max, no Team e no Enterprise e fora do plano Free.
| Forma de acesso | Como cobra | Para quem serve |
|---|---|---|
| Assinatura Pro, Max, Team ou Enterprise | Valor fixo por mês, dentro dos limites do plano | Uso pessoal e diário, com custo previsível |
| Console (API) | Pelo uso, sem mensalidade fixa | Automação e uso programático, com controle fino do gasto |
| Provedor de nuvem (Amazon Bedrock, Google Cloud, Microsoft Foundry) | Pelo contrato da empresa com o provedor | Times que centralizam tudo na nuvem que já usam |
Os valores ficam de fora daqui de propósito: mudam com frequência, e a página oficial é a fonte. O que não custa nada é aprender. As aulas do curso são gratuitas, e a aula planos, login e autenticação do Claude Code explica a diferença entre assinatura e Console com um jogo de classificar.
Quer aprender o Claude Code com método, e não por tentativa e erro?
O Curso de Claude Code do ValorFinal tem 19 módulos e 95 aulas em português. Começa no terminal e na instalação e chega a plan mode, subagentes, skills, hooks, MCP e automação, com um jogo em cada aula e uma mini-prova no fim de cada módulo.
Como fazer o login e a primeira conversa
Abra o terminal já dentro da pasta do projeto e digite claude. A pasta importa: o agente enxerga os arquivos a partir de onde foi iniciado, e começar no lugar errado é o tropeço mais comum de quem está começando.
cd caminho/da/pasta-do-projeto
claude
# ou já com o primeiro pedido:
claude "explique o que este projeto faz"Na primeira vez, o navegador abre para você entrar na sua conta da Anthropic e autorizar o acesso. Depois de confirmar, volte ao terminal: a sessão fica conectada e não pede login toda vez. Para trocar de conta, use /login dentro da ferramenta. Quem usa uma chave de API do Console pode definir a variável ANTHROPIC_API_KEY, e aí a ferramenta pede uma única vez para aprovar a chave, sem abrir o navegador.
Faça o primeiro pedido sem risco, só de leitura, como explique o que este projeto faz e por onde eu começaria a estudar. Ler não altera nada. Quando você pedir uma mudança, como corrigir um erro, o comportamento depende do modo de permissão: no modo manual, ele mostra a ação e espera você aprovar, recusar ou reformular. A tecla Esc interrompe o agente no meio sem perder o que já foi feito, /help lista os comandos e /exit encerra a sessão. A aula sua primeira conversa com o agente monta esse roteiro na ordem certa.
Quais comandos usar nos primeiros dias?
Dentro da sessão, você conversa em português. Os comandos que começam com barra são atalhos para controlar a ferramenta: digite / para ver a lista da sua versão e filtre pelas primeiras letras. Estes são os que mais aparecem no começo:
| Comando ou tecla | Para que serve |
|---|---|
claude | Abre uma sessão na pasta atual |
claude "pedido" | Abre a sessão já com o primeiro pedido |
claude -c | Retoma a conversa mais recente daquela pasta |
claude doctor | Diagnóstico da instalação, sem abrir sessão |
/help | Lista os comandos disponíveis |
/init | Cria um CLAUDE.md inicial analisando o projeto |
/clear | Começa uma conversa nova, com o contexto vazio |
/compact | Resume a conversa para liberar espaço e seguir no mesmo assunto |
/model | Troca o modelo de IA da sessão |
/permissions | Gerencia as regras de liberar, perguntar e bloquear |
/login | Entra na conta ou troca de conta |
/exit | Sai da sessão |
| Esc | Interrompe o agente sem perder o trabalho já feito |
| Shift + Tab | Alterna entre os modos de permissão |
! no começo da linha | Roda um comando direto no terminal |
@ e o nome do arquivo | Aponta um arquivo específico no pedido |
A dupla que mais confunde é /clear e /compact. Mudou de assunto, use /clear. O mesmo assunto ficou longo demais e a qualidade começou a cair, use /compact, que condensa a conversa e preserva o essencial.
O que o Claude Code faz sem pedir a sua aprovação?
Quem decide é o modo de permissão, um controle deslizante entre cautela e autonomia. Os modos principais:
| Modo | O que roda sem perguntar | Quando usar |
|---|---|---|
Manual (valor default) | Só leituras; editar, criar arquivo ou rodar comando pede aprovação | Começar e trabalho sensível |
Plano (plan) | Leituras: ele explora e propõe um plano antes de editar | Entender o projeto antes de mudar |
Aceitar edições (acceptEdits) | Leituras, edições de arquivo e comandos comuns como mkdir, mv e cp | Iterar num código que você revisa depois |
Automático (auto) | Quase tudo, com uma checagem de segurança em segundo plano | Tarefas longas, com menos interrupção |
Sem freios (bypassPermissions) | Tudo, sem checagem | Só em container ou máquina virtual isolada |
Uma mudança recente merece atenção. A documentação oficial, consultada em setembro de 2026, informa que, a partir da versão 2.1.283, as sessões no terminal e no VS Code começam no modo automático, em que um segundo modelo revisa as ações no seu lugar. Antes dela, só alguns planos pagos abriam assim, e o comum era começar no manual. Se você quer aprovar passo a passo, como o curso recomenda para quem está começando, aperte Shift + Tab: saindo do automático, o primeiro toque leva ao manual, e a barra de status passa a mostrar manual mode on. Para já abrir nesse modo, use claude --permission-mode manual.
Algumas travas valem sempre. Gravações em caminhos protegidos, como a pasta .git e a configuração do próprio Claude Code, nunca passam direto: pedem aprovação no manual e no de aceitar edições e passam pela checagem de segurança no automático. Regras de bloqueio configuradas em /permissions valem em todos os modos. E o modo sem freios, que pula quase todas as checagens, só faz sentido em ambiente isolado e descartável, nunca na máquina de trabalho.
Dois hábitos completam a segurança. Mantenha o projeto no git, com um commit a cada estado bom, para voltar atrás quando algo sair errado; o Claude Code também oferece checkpoints, pontos de retorno da própria sessão. E desconfie de conteúdo de fora, como páginas e arquivos baixados, que pode esconder instruções feitas para enganar o agente. A aula os modos de permissão do Claude Code mostra quando afrouxar e quando apertar o freio.
O que é o CLAUDE.md e por que criar um logo no começo
Cada sessão do Claude Code começa com a memória em branco. O CLAUDE.md é o arquivo de texto que resolve isso: instruções permanentes sobre o projeto que o agente lê no começo de toda sessão. Entra ali o que você reexplicaria sempre, como os comandos de teste, as convenções de código e as regras do tipo nunca faça isso sem perguntar. O comando /init cria um rascunho analisando o projeto, e você ajusta. Um exemplo curto:
# Projeto: loja virtual
## Comandos
- Rodar os testes: npm test
- Subir o servidor local: npm run dev
## Regras
- Textos visíveis sempre em português do Brasil.
- Não altere a pasta legado/ sem perguntar antes.Escreva instruções específicas e que dê para conferir, organize com títulos e listas e mantenha o arquivo enxuto, com menos de cerca de 200 linhas: arquivo grande gasta contexto e reduz a adesão. O CLAUDE.md existe em níveis que se somam, da política da organização às suas notas pessoais do projeto, passando pelo seu arquivo de usuário e pelo arquivo compartilhado com o time. Ele orienta, mas não impõe; para garantir que algo sempre aconteça existem os hooks. As configurações da ferramenta ficam em arquivos settings.json, e o formatador e validador de JSON ajuda a achar a vírgula fora do lugar quando você editar um deles à mão. A aula o que é o CLAUDE.md e por que ele muda tudo traz o teste simples para decidir o que merece entrar.
Erros comuns na instalação e como resolver
Quase todo tropeço de instalação cai em poucos casos, e a mensagem na tela diz qual é:
| O que aparece | O que significa | Como resolver |
|---|---|---|
command not found ou comando não reconhecido ao digitar claude | O terminal foi aberto antes da instalação, ou a pasta do programa não entrou no PATH | Feche e abra o terminal; se continuar, siga a seção de PATH da página oficial de resolução de problemas |
'irm' is not recognized as an internal or external command | Você está no Prompt de Comando (CMD), e não no PowerShell | Abra o PowerShell ou use o comando próprio do CMD |
The token '&&' is not a valid statement separator | Você colou o comando do CMD no PowerShell | No PowerShell, use o comando com irm |
Aviso EBADENGINE ao instalar pelo npm | Node.js mais antigo que o 22 | É só um aviso e o claude roda; atualize o Node.js ou use o instalador nativo |
| Erro de permissão ao instalar pelo npm | Instalação global sem permissão de escrita, às vezes por uso de sudo | Não use sudo; prefira o instalador nativo |
| A conta entra, mas não consegue usar o Claude Code | O plano da conta não inclui a ferramenta | O Free não inclui; confira o seu plano na página oficial |
| O agente não encontra os seus arquivos | A sessão foi aberta fora da pasta do projeto | Saia, entre na pasta com cd e rode claude de novo |
Se o comando de instalação falhar com erro de download, como syntax error near unexpected token '<' ou um 403, a página oficial de resolução de problemas liga cada mensagem à correção. Procure a mensagem exata ali antes de testar dicas soltas da internet, que envelhecem rápido. A aula manter o Claude Code atualizado e resolver problemas fecha o módulo de instalação com esse roteiro e com um cuidado para quem for desinstalar: apagar a pasta de configuração remove ajustes, permissões e o histórico de sessões.
Vale a pena fazer o curso de Claude Code?
Vale para quem vai usar a ferramenta com frequência e quer pular a fase de tentativa e erro. O curso tem 19 módulos e 95 aulas, com carga estimada de 40 horas, e vai do terminal e da primeira conversa até plan mode, git e GitHub, subagentes, skills, hooks, MCP, automação sem interação e fluxos de trabalho profissionais, com um projeto final no último módulo.
Cada aula traz um jogo para fixar o conceito e diagramas que mostram como o agente pensa; cada módulo termina em mini-prova, e há exame final. Ler as aulas é gratuito e não exige cadastro; o certificado de conclusão é para assinantes do ValorFinal VIP. O curso é do ValorFinal, independente da Anthropic, e se apoia na documentação oficial da ferramenta.
Para outras trilhas, como lógica de programação, Python e ChatGPT, veja todos os cursos gratuitos do ValorFinal.
Limitações do Claude Code e deste guia
O Claude Code erra. Ele escreve código que parece certo e às vezes não é, entende um pedido vago de um jeito diferente do que você queria e pode reescrever mais do que devia se você aprovar sem ler. Por isso revisar o que ele mostra, rodar os testes e fazer um commit a cada estado bom vale mais que qualquer atalho. A ferramenta não substitui a revisão de quem conhece o projeto.
Rodar o Claude Code exige um plano pago do Claude ou uma conta do Console, cobrada pelo uso. O plano gratuito não inclui a ferramenta, e os limites de uso de cada plano mudam com o tempo. Este guia não traz preços por esse motivo: confira a página oficial de planos antes de assinar. O curso ensina a usar a ferramenta, mas não dá acesso a ela.
A ferramenta também muda rápido. Os comandos, os modos de permissão e as mensagens de erro citados aqui foram conferidos na documentação oficial em setembro de 2026, e a troca do modo inicial na versão 2.1.283 mostra como um detalhe muda de uma versão para outra. Se algo na sua tela for diferente, a documentação oficial vale mais que este texto. O guia também cobre só o começo: subagentes, hooks, MCP e automação ficam para o curso.
Conclusão
O Claude Code é um agente de programação que trabalha dentro do seu projeto, no terminal ou no editor. A instalação cabe em um comando, a confirmação em outros dois (claude --version e claude doctor), e o uso exige um plano pago ou uma conta do Console. Comece com um pedido de leitura, escolha o modo de permissão com consciência, crie um CLAUDE.md e mantenha tudo no git. Para aprender com método, siga o Curso de Claude Code. Para o chat de uso geral, leia como usar o ChatGPT de graça; se programação ainda é novidade, como aprender programação do zero dá o pano de fundo; e, para levar IA ao seu negócio, há o curso de inteligência artificial para pequenos negócios. Veja também as ferramentas de tecnologia do portal e como validamos os conteúdos.
Fontes e referências
A instalação, os comandos, os modos de permissão e os planos foram conferidos nas páginas oficiais em setembro de 2026:
- Documentação oficial do Claude Code: instalação e requisitos: requisitos de sistema, comandos por sistema, atualização e desinstalação.
- Documentação oficial do Claude Code: modos de permissão: o que cada modo libera, o modo inicial e os caminhos protegidos.
- Documentação oficial do Claude Code: referência de comandos: o que fazem os comandos com barra.
- Documentação oficial do Claude Code: problemas de instalação e login: cada mensagem de erro ligada à correção.
- Anthropic: planos e preços do Claude: quais planos incluem o Claude Code.