Claude Code: Instalação e Uso do Claude Code

Q: P: Como desinstalar?

R: npm uninstall -g @anthropic-ai/claude-code remove completamente.

Q: P: Como atualizar?

R: npm update -g @anthropic-ai/claude-code atualiza para a versão mais recente.

Última atualização: 2026-08-31

Instalar o Claude Code exige apenas um comando npm, mas seu ambiente precisa estar preparado primeiro. Este capítulo orienta você desde os requisitos de sistema até a instalação e primeira execução.

💡 Dica: O Claude Code instala globalmente via npm, exigindo Node.js 18+. Após a instalação, inicie com o comando claude.

📋 Pré-requisitos: Capítulo 1 - Introdução ao Claude Code e Como Funciona

1. O Que Você Vai Aprender

Requisitos de sistema e pré-requisitos
Instalação global via npm do Claude Code
Primeira execução e configuração de autenticação
Fluxo básico de uso
Solução de problemas comuns de instalação

2. Requisitos de Sistema

(1) Requisitos de Hardware e Software

Requisito	Mínimo	Recomendado
SO	macOS 12+ / Ubuntu 20.04+ / Windows 10+	macOS 14+ / Ubuntu 22.04+
Node.js	18.x	20.x+
npm	9.x	10.x+
Memória	4 GB	8 GB+
Rede	HTTPS outbound	Baixa latência estável

(2) Verificar Ambiente Existente

BASH

# Verificar versão do Node.js
node --version
# Necessário v18+

# Verificar versão do npm
npm --version
# Necessário 9+

# Se não tiver Node.js, instale com nvm
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
nvm install 20
nvm use 20

3. Instalando o Claude Code

(1) Instalação Global via npm

BASH

# Instalar Claude Code globalmente
npm install -g @anthropic-ai/claude-code

# Verificar instalação
claude --version
# Saída similar a: claude-code/1.0.x

(2) Métodos Alternativos de Instalação

BASH

# Executar diretamente com npx (sem instalação global)
npx @anthropic-ai/claude-code

# Compilar do código-fonte
git clone https://github.com/anthropics/claude-code.git
cd claude-code
npm install
npm run build
npm link

▶ Exemplo 1: Processo Completo de Instalação

BASH

# Processo completo de instalação da Alice
node --version        # v20.11.0 ✓
npm --version         # 10.2.4 ✓

# Instalar Claude Code
npm install -g @anthropic-ai/claude-code

# Verificar
claude --version      # claude-code/1.0.12 ✓

# Primeira execução (irá guiar a autenticação)
claude
# → Opening browser for authentication...
# → Authentication successful!

4. Primeira Execução e Autenticação

(1) Métodos de Autenticação

O Claude Code suporta três métodos de autenticação:

Método	Caso de Uso	Comando
Conta Anthropic	Usuários pessoais	`claude` (guiado automaticamente)
API Key	Empresas/Equipes	Definir variável de ambiente
OAuth	SSO empresarial	`claude auth`

(2) Configuração da API Key

BASH

# Método 1: Variável de ambiente (recomendado)
export ANTHROPIC_API_KEY="sk-ant-api03-xxxxx"

# Método 2: Escrever no arquivo de configuração do shell
echo 'export ANTHROPIC_API_KEY="sk-ant-api03-xxxxx"' >> ~/.bashrc
source ~/.bashrc

# Método 3: Arquivo .env
echo 'ANTHROPIC_API_KEY=sk-ant-api03-xxxxx' > .env

▶ Exemplo 2: Primeiro Lançamento

BASH

$ claude

╭─────────────────────────────────────╮
│  Welcome to Claude Code!            │
│                                     │
│  Let's get you set up.              │
╰─────────────────────────────────────╯

? How would you like to authenticate?
  ❯ Anthropic Account (browser login)
    API Key
    OAuth (Enterprise)

# Após selecionar Anthropic Account:
# → Browser opens automatically
# → Login and authorize
# → "Authentication successful!"

5. Fluxo Básico de Uso

(1) Iniciar em um Projeto

BASH

# Navegue até o diretório do seu projeto
cd ~/my-project

# Iniciar Claude Code
claude

# Ou inicie com uma tarefa diretamente
claude "Help me add a user registration feature"

(2) Modo Interativo

TEXT 📖 Somente leitura

$ claude
╭─ Claude Code ─────────────────────────╮
│  Project: my-project                  │
│  Model: claude-sonnet-4-20250514      │
╰───────────────────────────────────────╯

> Show me the project structure

Claude: Let me read the project structure...
  - src/
    - index.ts
    - routes/
    - utils/
  - package.json
  - tsconfig.json

> Modify index.ts, add a health check endpoint

Claude: I'll add a health check endpoint...
  → Reading src/index.ts
  → Modifying src/index.ts
  → Running: npm run build ✓

6. Solução de Problemas Comuns de Instalação

▶ Exemplo 3: Checklist de Solução de Problemas

BASH

# Problema 1: Erro de permissão no npm install
npm install -g @anthropic-ai/claude-code
# EACCES: permission denied
# Solução:
npm config set prefix ~/.npm-global
export PATH=~/.npm-global/bin:$PATH

# Problema 2: Versão do Node.js muito antiga
node --version  # v16.x
# Solução:
nvm install 20
nvm use 20

# Problema 3: Timeout de rede
npm install -g @anthropic-ai/claude-code --registry=https://registry.npmmirror.com

# Problema 4: Problemas de caminho no Windows
# Garanta que o caminho de instalação do Node.js está no PATH
where node
where claude

Problema	Causa	Solução
`command not found: claude`	PATH não configurado	Verificar caminho de instalação global do npm
`EACCES`	Permissões insuficientes	Usar `nvm` ou modificar prefixo do npm
`ETIMEDOUT`	Problemas de rede	Trocar fonte mirror
Erro em `node_modules`	Versão do Node antiga	Atualizar para Node 18+
Falha na autenticação	API Key inválida	Verificar formato da Key e cota

7. Exemplo Completo: Do Zero à Execução

BASH

# Fluxo completo de instalação até primeiro uso

# 1. Confirmar ambiente
node --version && npm --version

# 2. Instalar
npm install -g @anthropic-ai/claude-code

# 3. Autenticar
export ANTHROPIC_API_KEY="sk-ant-api03-your-key"

# 4. Criar projeto de teste
mkdir hello-claude && cd hello-claude
git init

# 5. Primeira execução
claude "Create an Express.js Hello World project"

# Saída do Claude Code:
# → Initializing project...
# → Creating package.json
# → Installing express
# → Creating index.js
# → Creating .gitignore
# → Running: node index.js
# → Server started on port 3000 ✓

❓ Perguntas Frequentes

P: Posso usar o Claude Code no Windows? R: Sim. Via WSL2 ou instalação nativa do Node.js. WSL2 é recomendado para melhor compatibilidade.

P: Preciso de VPN para instalar? R: A instalação do pacote npm geralmente não, mas a conexão com a API da Anthropic sim. O endpoint da API é exterior; proxy necessário se a rede estiver bloqueada.

P: Onde consigo uma API Key? R: Acesse console.anthropic.com, crie uma na página API Keys. Novas contas têm créditos gratuitos.

P: Posso instalar offline? R: A instalação requer rede, e a execução também requer rede (chamada à API). Ainda não há solução totalmente offline.

P: Como desinstalar? R: npm uninstall -g @anthropic-ai/claude-code remove completamente.

P: Como atualizar? R: npm update -g @anthropic-ai/claude-code atualiza para a versão mais recente.

📖 Resumo

Node.js 18+ é pré-requisito; recomenda-se usar nvm para gerenciamento de versões
npm install -g @anthropic-ai/claude-code para instalação com um comando
Três métodos de autenticação: Conta Anthropic, API Key, OAuth
Execute claude no diretório do seu projeto para iniciar
Problemas comuns geralmente relacionados a permissões, versões e rede

📝 Exercícios

Básico (⭐): Instale o Claude Code na sua máquina e execute claude --version, capture a tela para confirmar o sucesso.
Intermediário (⭐⭐): Configure a variável de ambiente da API Key, execute claude em um diretório vazio, e faça com que ele crie um projeto simples.
Avançado (⭐⭐⭐): Instale o Claude Code no WSL2, compare a experiência de uso entre Windows nativo e WSL2.

Equipe Técnica Web-Tutorial

Uma plataforma de tutoriais mantida por diversos desenvolvedores. Cada tutorial é escrito e revisado por profissionais da área correspondente. Trabalhamos para manter nosso conteúdo preciso e confiável — se encontrar algum problema, avise-nos.

Sobre Nós