O Claude Code é o agente de programação com IA baseado em terminal da Anthropic. Ele lê sua base de código, edita arquivos reais, executa comandos shell e gerencia o git — tudo pela linha de comando. Sem abas de navegador, sem copiar e colar.
Este guia cobre todos os métodos de instalação (nativo, npm, Homebrew), autenticação, configuração e — o mais importante — o que fazer depois da instalação para transformar o Claude Code de assistente de programação em um agente multimodal completo com geração de imagens, vídeo, busca na web e armazenamento em nuvem.
Pré-requisitos
Antes de instalar, confirme que você tem:
- Sistema operacional: macOS 13+ (Ventura), Ubuntu 20.04+ / Debian 10+ ou Windows 10 (1809+) com WSL
- RAM: 4 GB no mínimo, 8 GB recomendado para bases de código maiores
- Conexão com a internet: Todo o processamento de IA é executado na infraestrutura em nuvem da Anthropic — sem conexão, sem Claude Code
- Conta Anthropic: Claude Pro ($20/mês), Max ($100–200/mês), Teams, Enterprise ou conta Console (API). O plano gratuito Claude.ai não inclui o Claude Code. Veja nossa comparação de planos do Claude Code para ajuda na escolha.
- Terminal: Bash, Zsh ou PowerShell
- Node.js 18+: Necessário apenas para o método de instalação via npm
Nenhuma GPU é necessária. Sua máquina executa um cliente CLI leve; todo o processamento de IA acontece no lado do servidor.
Etapa 1: Instalar o Node.js (apenas para o método npm)
Se você planeja usar o instalador nativo — que agora é o caminho recomendado pela Anthropic — pule esta etapa completamente. O instalador nativo não tem dependências.
Para usuários de npm, verifique sua versão do Node:
node --version
Se a saída mostrar v18.0.0 ou superior, vá para a Etapa 2. Caso contrário, instale via nvm (Node Version Manager) para evitar problemas de permissão:
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.1/install.sh | bash
Feche e reabra o terminal, depois:
nvm install 22
nvm use 22
node --version # Should show v22.x.x
O Node.js 22 é o lançamento LTS atual e funciona perfeitamente com o Claude Code.
Etapa 2: Instalar o Claude Code
Três métodos de instalação. Escolha um.
Opção A: Instalador nativo (recomendado)
Zero dependências. Atualizações automáticas em segundo plano. É o que a Anthropic testa e suporta principalmente.
macOS e Linux:
curl -fsSL https://claude.ai/install.sh | bash
Windows (PowerShell, executar como Administrador):
irm https://claude.ai/install.ps1 | iex
O instalador coloca o binário claude no seu PATH e configura atualizações automáticas. Menos de um minuto, do começo ao fim.
Opção B: Homebrew (macOS / Linux)
brew install --cask claude-code
Uma observação: as instalações via Homebrew não se atualizam automaticamente. Execute brew upgrade claude-code periodicamente.
Opção C: npm
npm install -g @anthropic-ai/claude-code
Não use sudo. Se você receber erros de permissão EACCES, a solução é o nvm — não executar o npm como root. Diretórios npm de propriedade do root criam problemas de permissão em cascata.
Verificar
Confirme que a instalação funcionou:
claude --version
Para um diagnóstico completo do ambiente:
claude doctor
Etapa 3: Autenticar
claude
No primeiro lançamento, o Claude Code abre seu navegador para autenticação OAuth. Entre na sua conta Anthropic, autorize a CLI e você estará conectado.
Opções de autenticação
OAuth pelo navegador (padrão): Ideal para máquinas pessoais. Funciona com contas Pro, Max, Teams e Enterprise. Um token de sessão é armazenado localmente após a autorização.
Chave de API (CI/CD e sem interface gráfica): Para servidores, contêineres ou pipelines onde um navegador não está disponível:
export ANTHROPIC_API_KEY=sk-ant-your-key-here
claude
Gere sua chave em console.anthropic.com. O uso da API é cobrado por token nas tarifas padrão da Anthropic. Para um detalhamento completo entre assinatura e cobrança por API, veja nosso guia de preços do Claude Code.
Qual modelo de cobrança escolher? As assinaturas (Pro/Max) são mais simples para uso diário e incluem o Claude Code no seu plano mensal. A cobrança por API oferece controle granular para cargas de trabalho variáveis ou automatizadas.
Etapa 4: Sua primeira sessão no Claude Code
Navegue até qualquer diretório de projeto:
cd ~/my-project
claude
O Claude Code lê a estrutura do seu projeto e entra em um REPL interativo. Comece com algo de baixo risco:
> Explain the architecture of this project
Ele escaneia seus arquivos, identifica a stack e fornece um resumo estrutural. Em seguida, tente algo com consequências reais:
> Add input validation to the user registration form
O Claude Code identifica os arquivos relevantes, propõe as mudanças e aguarda sua confirmação. Você revisa cada alteração em uma visualização de diff antes de aceitar — ele não sobrescreve arquivos cegamente.
Para tarefas únicas sem entrar no modo interativo, use o flag -p (print):
claude -p "Write unit tests for the auth module"
Executa a tarefa, exibe o resultado e encerra. Ótimo para scripts e pipelines de CI/CD.
Etapa 5: Configurar o Claude Code
Seleção de modelo
O Claude Code usa o modelo mais recente disponível por padrão. Para substituir:
# Definir modelo padrão
claude config set model claude-opus-4-7
# Ou para uma sessão específica
claude --model claude-sonnet-4-6
Permissões
O Claude Code pede confirmação antes de gravar arquivos ou executar comandos. Se você confia nele em um determinado projeto:
claude config set permissions.auto-accept-edits true
Útil para agilizar o trabalho. Menos útil ao trabalhar com código de produção. Para uma análise detalhada de todos os modos de permissão, subagentes e hooks, veja nosso guia de recursos avançados do Claude Code.
Configurações no nível do projeto
Crie .claude/settings.json na raiz do seu projeto para configuração compartilhada com a equipe (faça commit deste arquivo):
{
"permissions": {
"allow": ["read", "write", "shell"],
"deny": ["shell:rm -rf *"]
},
"model": "claude-sonnet-4-6",
"environment": {
"NODE_ENV": "development"
}
}
Para substituições pessoais que não devem ser commitadas, use .claude/settings.local.json.
CLAUDE.md
A configuração de maior impacto. Crie um arquivo CLAUDE.md na raiz do seu projeto para dar ao Claude contexto persistente: comandos de build, convenções de código, decisões de arquitetura. Execute /init dentro do Claude Code para gerar um automaticamente e depois personalize-o.
Um bom CLAUDE.md é conciso — mire em 50–100 linhas. Para cada linha, pergunte: "Remover isso faria o Claude cometer um erro?" Se não, corte.
Instruções por plataforma
macOS
Tanto Apple Silicon (M1–M4) quanto Macs Intel são suportados. O instalador nativo é o caminho mais limpo:
curl -fsSL https://claude.ai/install.sh | bash
Linux
Funciona no Ubuntu 20.04+, Debian 10+ e na maioria das distribuições modernas. O mesmo instalador nativo do macOS. Em distribuições mais antigas, use npm com nvm.
Windows
Opção 1: Instalador nativo do PowerShell
irm https://claude.ai/install.ps1 | iex
Opção 2: WSL (recomendado para compatibilidade total com Linux)
wsl --install
# Reinicie e, no terminal WSL:
curl -fsSL https://claude.ai/install.sh | bash
Docker
FROM node:22-alpine
RUN npm install -g @anthropic-ai/claude-code
No tempo de execução, passe a chave de API como variável de ambiente — não a incorpore na imagem.
CI/CD (exemplo com GitHub Actions)
- name: AI Code Review
run: |
npx @anthropic-ai/claude-code -p "Review this PR for bugs" --output-format json
env:
ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY }}
Integração com IDE
O Claude Code é focado no terminal, mas plugins de IDE oferecem visualização nativa de diff.
VS Code: Instale "Claude Code" pelo painel de Extensões ou:
code --install-extension anthropic.claude-code
JetBrains: Configurações → Plugins → Marketplace → pesquise "Claude Code" → Instalar. As alterações aparecem no visualizador de diff nativo da IDE.
Além da instalação: Dê ao Claude Code capacidades de agente
É aqui que a maioria dos guias de instalação para. O Claude Code está instalado, autenticado, funcionando — mas limitado ao que a CLI básica oferece: edição de arquivos, comandos shell, operações git.
O que o Claude Code não consegue fazer por padrão:
- Gerar imagens ou editar fotos
- Criar ou analisar vídeos
- Buscar na web em tempo real
- Armazenar e recuperar arquivos em armazenamento em nuvem
- Publicar conteúdo na web
Essas capacidades exigem servidores MCP (Model Context Protocol). O MCP é o padrão aberto que permite aos agentes de IA se conectar a ferramentas externas. O Claude Code suporta MCP nativamente — você configura os servidores e o Claude pode chamá-los diretamente. Para o guia completo, veja nosso guia para adicionar capacidades ao Claude Code com MCP.
O caminho rápido: AnyCap Agent CLI
Em vez de configurar servidores MCP individuais um por um, você pode dar ao Claude Code um conjunto completo de capacidades de agente com uma única CLI:
npx -y skills add anycap-ai/anycap -a claude-code
Isso instala o runtime de capacidades de agente da AnyCap, dando ao Claude Code acesso a:
| Capacidade | O que faz | Exemplo |
|---|---|---|
| Geração de imagens | Criar e editar imagens a partir de prompts de texto | "Gere uma imagem hero para a landing page" |
| Geração de vídeo | Produzir vídeos a partir de texto ou imagens | "Crie um walkthrough de demonstração do produto" |
| Busca na web | Pesquisar e rastrear a internet em tempo real | "Pesquise as últimas mudanças na API" |
| Armazenamento em nuvem | Fazer upload, compartilhar e recuperar arquivos | "Armazene os assets do projeto e gere links de compartilhamento" |
| Publicação na web | Implantar conteúdo na web | "Publique o changelog como uma página web" |
Uma CLI. Um fluxo de autenticação. Todas as capacidades. Você não precisa gerenciar chaves de API separadas para geração de imagens, vídeo, busca e armazenamento — a AnyCap cuida de tudo isso com uma única instalação. Para uma análise detalhada da integração MCP, incluindo opções de configuração manual de servidor, veja nosso guia de capacidades MCP.
Configuração manual de MCP
Se preferir configurar servidores MCP individualmente, adicione-os ao .mcp.json na raiz do seu projeto:
{
"mcpServers": {
"github": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-github"]
},
"postgres": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-postgres"]
}
}
}
Ou adicione-os interativamente:
claude mcp add github -- npx -y @modelcontextprotocol/server-github
claude mcp list
claude mcp get github
Solução de problemas
| Problema | Solução |
|---|---|
| "command not found: claude" | Abra uma nova janela do terminal. Se não funcionar, execute o instalador novamente ou verifique seu PATH. |
| Node.js muito antigo | nvm install 22 && nvm use 22 |
| Erros de permissão npm EACCES | Nunca use sudo. Use nvm em vez disso. |
| Navegador não abre para autenticação | Use a chave de API: export ANTHROPIC_API_KEY=sk-ant-... |
| Erros de rede durante a instalação | Verifique as configurações de proxy. Defina o registro npm: npm config set registry https://registry.npmjs.org/ |
| Claude Code roda lentamente | Latência de rede para a API da Anthropic. Verifique status.anthropic.com. Desconecte a VPN se estiver ativa. |
Execute claude doctor antes de gastar tempo em depuração manual — ele detecta automaticamente a maioria dos problemas de configuração.
Mantendo o Claude Code atualizado
Instalador nativo: As atualizações acontecem automaticamente. Nenhuma ação necessária. Verifique sua versão com claude --version.
npm: npm update -g @anthropic-ai/claude-code
Homebrew: brew upgrade claude-code
Próximos passos
O Claude Code está instalado. Por onde continuar:
- Gere um CLAUDE.md — Execute
/initdentro do Claude Code para dar a ele contexto persistente do projeto. - Adicione capacidades de agente — Instale a AnyCap para dar ao Claude Code geração de imagens, vídeo, busca e armazenamento. Veja nosso guia de capacidades MCP.
- Tente uma tarefa real — Escolha algo que normalmente levaria 20 minutos e veja como o Claude lida com isso.
Artigos relacionados
- Claude Code vs Cursor: Qual agente de programação com IA vence em 2026? — Agente nativo de terminal vs fork de IDE. Compare autonomia, tratamento de contexto, preços, tarefas reais e quando usar cada um.
- Recursos avançados do Claude Code: Subagentes, Auto-Aprovar & Modo Bash — Domine subagentes para processamento paralelo, auto-aprovação para fluxos de trabalho mais rápidos e execução bash para acesso completo ao shell.
- Como adicionar capacidades de agente ao Claude Code com MCP — Guia de configuração MCP passo a passo, mais o caminho rápido de um único comando da AnyCap para geração de imagens, vídeo, busca na web e armazenamento em nuvem.
- Preços e planos do Claude Code comparados — Análise completa do Pro ($20/mês), Max ($100–200/mês), Teams, Enterprise e cobrança por API.
- Limites de taxa e de tokens do Claude Code explicados — Estratégias práticas para manter a produtividade e evitar atingir limites de taxa e de sessão.
O Claude Code é a maneira mais rápida de trazer IA para seu fluxo de trabalho de desenvolvimento sem mudar de ferramentas. Uma vez configurado, a diferença é imediata.