PT
FrançaisEnglishEspañolItalianoDeutsch日本語

Guias práticos

Como instalar o Claude Code e dar os primeiros passos: guia passo a passo

Requisitos, instalação no macOS, Linux e Windows, primeira sessão, planos e integração com VS Code ou JetBrains, segundo a documentação da Anthropic.

Por ·

O Claude Code é o agente de programação da Anthropic: ele lê seu projeto, propõe alterações e executa comandos a partir do terminal, de uma IDE, do aplicativo para desktop ou da web. Este guia segue a documentação oficial; cada comando foi conferido com ela em 20 de outubro de 2026. Para números de uso e planos, veja a página da ferramenta Claude Code.

Antes de começar

Instalar o Claude Code

O instalador nativo é o método recomendado pela Anthropic; ele se atualiza sozinho em segundo plano.

macOS, Linux e WSL:

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

Windows PowerShell:

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

Windows CMD:

curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

O instalador não mostra progresso durante o download. Depois, abra um terminal novo. Existem duas alternativas, sem atualizações automáticas por padrão:

brew install --cask claude-code
winget install Anthropic.ClaudeCode

O cask claude-code do Homebrew segue o canal estável (cerca de uma semana atrás, pulando versões com regressões graves); o claude-code@latest recebe cada versão assim que ela é lançada. Também há repositórios apt, dnf e apk assinados para Debian, Fedora, RHEL e Alpine.

Com npm: o pacote exige Node.js 22 ou superior e instala o mesmo binário nativo. A Anthropic desaconselha sudo npm install -g (problemas de permissão e riscos de segurança).

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

Observações sobre o Windows

O Claude Code funciona nativamente no Windows ou dentro do WSL. A instalação nativa não exige direitos de administrador. O Git for Windows é opcional: quando está presente, o Claude Code usa o Git Bash para sua ferramenta Bash; caso contrário, usa o PowerShell. O sandboxing (execução isolada de comandos) só é compatível com o WSL 2. No WSL, instale e execute claude a partir do terminal do Linux, não do PowerShell.

Verificar a instalação

claude --version

O comando exibe um número de versão seguido de "(Claude Code)". Se o seu shell disser que não encontra o claude, o diretório de instalação ainda não está no seu PATH. Para uma verificação mais completa, sem iniciar uma sessão:

claude doctor

Sua primeira sessão

Entre em um projeto e inicie o agente:

cd /caminho/para/seu/projeto
claude

No primeiro uso, o Claude Code abre seu navegador para fazer login; as credenciais são então armazenadas. Se a variável de ambiente ANTHROPIC_API_KEY estiver definida e você a aprovar, a etapa de login é ignorada. Com uma conta do Console, um workspace "Claude Code" é criado automaticamente para o acompanhamento de custos.

Comece com perguntas simples, por exemplo:

what does this project do?

Depois, uma pequena alteração. O Claude Code mostra a edição e pede aprovação conforme o modo de permissão da sessão; Shift+Tab alterna entre os modos.

add a hello world function to the main file

Comandos essenciais, do guia de início rápido da Anthropic:

Custo e planos

O Claude Code está incluído nos planos pagos do Claude (Anthropic, verificado em 20 de outubro de 2026):

Com uma conta do Console, o uso é cobrado por token. A Anthropic afirma que, em suas implantações corporativas, o custo médio gira em torno de US$ 13 por desenvolvedor por dia ativo e 150-US$ 250 por desenvolvedor por mês, ficando abaixo de US$ 30 por dia ativo para 90% dos usuários (Anthropic). O comando /usage mostra o consumo da sessão; para assinantes do Pro e do Max, o uso está incluído no plano. Para comparar esses planos com os de outros agentes, veja nosso guia Como escolher um agente de programação pelo orçamento.

Integrar o Claude Code à sua IDE

VS Code e Cursor: a extensão oficial exige o VS Code 1.94.0 ou superior e uma conta paga do Claude ou do Console, sem necessidade de chave de API (Anthropic). Abra a visualização de extensões (Cmd+Shift+X no Mac, Ctrl+Shift+X no Windows e no Linux), procure por "Claude Code" e instale. A extensão inclui sua própria cópia da CLI; para executar claude no terminal integrado, instale também a CLI. Outros forks do VS Code (Devin Desktop, Kiro) usam o registro Open VSX.

JetBrains (IntelliJ IDEA, PyCharm, Android Studio, WebStorm, PhpStorm, GoLand): o plugin não inclui a CLI. Instale primeiro a CLI, depois o plugin Claude Code pelo JetBrains Marketplace e reinicie a IDE (Anthropic). Execute claude no terminal integrado ou digite /ide em uma sessão iniciada a partir de um terminal externo. Cmd+Esc (Mac) ou Ctrl+Esc (Windows e Linux) abre o Claude Code a partir do editor.

Atualizar e desinstalar

As instalações nativas se atualizam sozinhas. Para atualizar imediatamente:

claude update

Com o Homebrew: brew upgrade claude-code; com o WinGet: winget upgrade Anthropic.ClaudeCode. Para remover uma instalação nativa no macOS, Linux ou WSL:

rm -f ~/.local/bin/claude
rm -rf ~/.local/share/claude

Para ir além

Fontes

Conclusão: o Claude Code se instala com um único comando no macOS, Linux e Windows, mas exige um plano pago do Claude ou uma conta do Console; a extensão do VS Code inclui a CLI, o plugin da JetBrains não.

Encontrou um erro neste artigo? Avise-nos · Nossa política de correções

Ícone do Rekha: uma casa desenhada em um único traço

Do mesmo autor Autopromoção

Um caminho euleriano, desenhado com o dedo

Rekha, o jogo para iPhone do autor da OrigoTech: conecte todos os pontos em um único traço, sem percorrer duas vezes o mesma ligação, ao longo de 500 desenhos que têm solução.

Ver na App Store → Por que é um problema de grafos

A newsletter da OrigoTech

Um resumo semanal, com fontes, das novidades das ferramentas de IA.

Continue lendo