TutorialFeb 22, 2026·Code Velocity Academy

Como Instalar o Claude Code e Rodar Sua Primeira Tarefa com IA

Instale o Claude Code em qualquer plataforma e rode sua primeira tarefa de codificação autônoma em menos de 10 minutos. Cobre instalação, configuração e seus primeiros prompts reais.

O Claude Code é a ferramenta de codificação agentiva da Anthropic. Roda no seu terminal, lê todo o projeto, edita arquivos, executa comandos e itera nos resultados. Este guia te leva do zero à primeira sessão produtiva em menos de 10 minutos.

Como instalar o Claude Code?

O Claude Code se instala com um único comando no macOS, Linux ou WSL. No Windows, use o PowerShell.

macOS / Linux / WSL

bash

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

Windows PowerShell

powershell

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

Métodos alternativos

Método	Comando
Homebrew (macOS)	brew install claude-code
npm (qualquer plataforma)	npm install -g @anthropic-ai/claude-code
Extensão VS Code	Busque "Claude Code" no marketplace do VS Code
Plugin JetBrains	Busque "Claude Code" no marketplace JetBrains

Verifique a instalação:

bash

claude --version
# Claude Code 2.x.x

Como iniciar sua primeira sessão?

Navegue até qualquer diretório de projeto e digite `claude`. O Claude Code lê a estrutura do projeto e constrói contexto automaticamente. Não precisa configurar nada para começar.

bash

cd seu-projeto
claude

Você verá um prompt onde pode digitar instruções em linguagem natural. O Claude Code entende seu projeto porque lê seus arquivos, não porque você os explica.

Quais são bons primeiros prompts?

Comece com tarefas que te ajudem a entender o que o Claude Code pode fazer. Esses prompts funcionam bem para uma primeira sessão:

bash

# Entender o projeto
> "O que esse projeto faz? Me dê uma visão geral."

# Encontrar problemas
> "Há bugs óbvios ou code smells nessa codebase?"

# Agir
> "Escreva testes para o módulo de auth, execute-os e corrija as falhas"

# Tarefa de múltiplos passos
> "Adicione validação de input no formulário de cadastro,
   escreva testes unitários e commite com mensagem descritiva"

DICA

O último exemplo mostra o real poder do Claude Code: ele escreve código, roda testes, lê a saída, corrige falhas e commita. Tudo em um prompt. Essa é a diferença entre uma ferramenta de chat e um agente.

O que torna o Claude Code diferente de outras ferramentas?

Capacidade	Claude Code	Ferramentas baseadas em chat
Acesso a arquivos	Lê qualquer arquivo do projeto	Apenas o que você cola
Execução	Roda comandos no terminal	Sem execução
Iteração	Corrige seus próprios erros	Você copia e cola correções
Git	Cria commits, branches, PRs	Sem integração git
Memória	CLAUDE.md persiste entre sessões	Sem memória

Como configurar o CLAUDE.md para melhores resultados?

Crie um arquivo CLAUDE.md na raiz do seu projeto. O Claude Code o lê no início de cada sessão. Ele diz ao agente sobre as convenções, stack técnica e regras do seu projeto.

bash

# Criar CLAUDE.md automaticamente
claude /init

# Ou escreva manualmente
cat > CLAUDE.md << 'EOF'
# Contexto do Projeto
App Next.js 14 com TypeScript e Tailwind CSS.

## Comandos
- npm run dev — iniciar servidor de dev
- npm run test — rodar testes

## Convenções
- Use server components por padrão
- Nunca use `any` no TypeScript
EOF

Confira nosso guia detalhado de boas práticas do CLAUDE.md para configuração avançada.

Perguntas frequentes

Preciso de assinatura do Claude para usar o Claude Code?+

Você precisa de uma conta Claude. O tier gratuito dá mensagens diárias limitadas. O Claude Pro ($20/mês) oferece limites muito maiores e é recomendado para uso regular. Também é possível usar a API com preço por token.

O Claude Code funciona com qualquer linguagem de programação?+

Sim. O Claude Code lê arquivos-fonte independente da linguagem e pode rodar qualquer comando disponível no seu terminal. Funciona com Python, JavaScript, TypeScript, Go, Rust, Java, C++, Ruby, PHP e mais.

É seguro usar o Claude Code em codebases de produção?+

Sim. O Claude Code tem um sistema de permissões que permite controlar o que ele pode fazer. Você pode restringir acesso a arquivos, exigir aprovação para comandos destrutivos e usar o Plan Mode para revisar alterações antes que aconteçam.

Posso usar o Claude Code dentro do VS Code?+

Sim. Instale a extensão Claude Code do VS Code pelo marketplace. Ela dá a mesma experiência de agente no terminal integrada diretamente ao seu editor.