Como Instalar e Configurar o Claude Code: Guia Completo (2026)

O Claude Code é o agente de programação com IA baseado em terminal da Anthropic. Lê a sua base de código, edita ficheiros reais, executa comandos shell e gere o git — tudo a partir da linha de comandos. Sem abas de browser, 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 após a instalação para transformar o Claude Code de assistente de programação num agente multimodal completo com geração de imagens, vídeo, pesquisa na web e armazenamento na nuvem.

Pré-requisitos

Antes de instalar, confirme que tem:

• Sistema operativo: 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
• Ligação à internet: Todo o processamento de IA é executado na infraestrutura cloud da Anthropic — sem ligaçã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. Consulte a 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

Não é necessária qualquer GPU. A sua máquina executa um cliente CLI leve; todo o processamento de IA ocorre do lado do servidor.

Passo 1: Instalar o Node.js (apenas para o método npm)

Se planeia utilizar o instalador nativo — que é agora o caminho recomendado pela Anthropic — ignore este passo por completo. O instalador nativo não tem dependências.

Para utilizadores de npm, verifique a sua versão do Node:

node --version

Se a saída mostrar v18.0.0 ou superior, avance para o Passo 2. Caso contrário, instale via nvm (Node Version Manager) para evitar problemas de permissões:

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.

Passo 2: Instalar o Claude Code

Três métodos de instalação disponíveis. 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 início ao fim.

Opção B: Homebrew (macOS / Linux)

brew install --cask claude-code

Uma nota: 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 utilize sudo. Se receber erros de permissão EACCES, a solução é o nvm — não executar o npm como root. Diretórios npm pertencentes ao 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

Passo 3: Autenticar

claude

No primeiro arranque, o Claude Code abre o seu browser para autenticação OAuth. Inicie sessão na sua conta Anthropic, autorize a CLI e estará ligado.

Opções de autenticação

OAuth pelo browser (predefinição): Ideal para máquinas pessoais. Funciona com contas Pro, Max, Teams e Enterprise. Um token de sessão é guardado localmente após a autorização.

Chave de API (CI/CD e sem interface gráfica): Para servidores, contentores ou pipelines onde não está disponível um browser:

export ANTHROPIC_API_KEY=sk-ant-your-key-here
claude

Gere a sua chave em console.anthropic.com. A utilização da API é cobrada por token às tarifas padrão da Anthropic. Para uma análise completa entre subscrição e faturação por API, consulte o nosso guia de preços do Claude Code.

Que modelo de faturação escolher? As subscrições (Pro/Max) são mais simples para uso diário e incluem o Claude Code no plano mensal. A faturação por API oferece controlo granular para cargas de trabalho variáveis ou automatizadas.

Passo 4: A 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 num REPL interativo. Comece com algo de baixo risco:

> Explain the architecture of this project

Analisa os seus ficheiros, identifica a stack e fornece um resumo estrutural. De seguida, experimente algo com consequências reais:

> Add input validation to the user registration form

O Claude Code identifica os ficheiros relevantes, propõe as alterações e aguarda a sua confirmação. Revê cada alteração numa vista de diff antes de aceitar — não sobrescreve ficheiros de forma cega.

Para tarefas únicas sem entrar no modo interativo, utilize o flag -p (print):

claude -p "Write unit tests for the auth module"

Executa a tarefa, apresenta o resultado e termina. Ótimo para scripts e pipelines de CI/CD.

Passo 5: Configurar o Claude Code

Seleção de modelo

O Claude Code utiliza por predefinição o modelo mais recente disponível. Para substituir:

# Definir modelo predefinido
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 escrever ficheiros ou executar comandos. Se confiar nele num determinado projeto:

claude config set permissions.auto-accept-edits true

Útil para aumentar a velocidade. 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, consulte o nosso guia de funcionalidades avançadas do Claude Code.

Definições ao nível do projeto

Crie .claude/settings.json na raiz do seu projeto para configuração partilhada com a equipa (faça commit deste ficheiro):

{
  "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 incluídas no commit, utilize .claude/settings.local.json.

CLAUDE.md

A configuração de maior impacto. Crie um ficheiro 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 — aponte para 50–100 linhas. Para cada linha, pergunte: "Remover isto faria o Claude cometer um erro?" Se não, elimine.

Instruções por plataforma

macOS

Tanto Apple Silicon (M1–M4) como 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, utilize 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

Em 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: Definiçõ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 termina. O Claude Code está instalado, autenticado, a funcionar — mas limitado ao que a CLI básica oferece: edição de ficheiros, comandos shell, operações git.

O que o Claude Code não consegue fazer por predefinição:

• Gerar imagens ou editar fotografias
• Criar ou analisar vídeos
• Pesquisar na web em tempo real
• Armazenar e recuperar ficheiros em armazenamento na nuvem
• Publicar conteúdo na web

Estas capacidades requerem servidores MCP (Model Context Protocol). O MCP é o padrão aberto que permite aos agentes de IA ligar-se a ferramentas externas. O Claude Code suporta MCP nativamente — configura os servidores e o Claude pode invocá-los diretamente. Para o guia completo, consulte o 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 a um, 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

Isto instala o runtime de capacidades de agente da AnyCap, dando ao Claude Code acesso a:

Uma CLI. Um fluxo de autenticação. Todas as capacidades. Não precisa de gerir chaves de API separadas para geração de imagens, vídeo, pesquisa e armazenamento — a AnyCap trata de tudo isso com uma única instalação. Para uma análise aprofundada da integração MCP, incluindo opções de configuração manual de servidor, consulte o 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 de forma interativa:

claude mcp add github -- npx -y @modelcontextprotocol/server-github
claude mcp list
claude mcp get github

Resolução de problemas

Execute claude doctor antes de gastar tempo em depuração manual — deteta automaticamente a maioria dos problemas de configuração.

Manter o Claude Code atualizado

Instalador nativo: As atualizações acontecem automaticamente. Nenhuma ação necessária. Verifique a 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:

1. Gere um CLAUDE.md — Execute /init dentro do Claude Code para lhe dar contexto persistente do projeto.
2. Adicione capacidades de agente — Instale a AnyCap para dar ao Claude Code geração de imagens, vídeo, pesquisa e armazenamento. Consulte o nosso guia de capacidades MCP.
3. Experimente uma tarefa real — Escolha algo que normalmente demoraria 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.
• Funcionalidades avançadas do Claude Code: Subagentes, Auto-Aprovar & Modo Bash — Domine subagentes para processamento paralelo, aprovação automática 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, pesquisa na web e armazenamento na 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 faturação 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 forma mais rápida de integrar IA no seu fluxo de trabalho de desenvolvimento sem mudar de ferramentas. Uma vez configurado, a diferença é imediata.