Alexandre Caramaschi

doi:10.2139/ssrn.6460680

Claude Code CLI: Programação com IA · Capítulo 5 de 23 · 17 min

Instalação e primeiro acesso, sem depender do TI

Instale o Claude Code na sua máquina, verifique a instalação e configure a chave de acesso.

Este capítulo faz parte do curso gratuito Claude Code CLI: Programação com IA. Para marcar como concluído e salvar o progresso, abra este capítulo na página do curso.

O Claude Code é distribuído como um instalador nativo oficial: um binário próprio para o seu sistema, que não depende de Node.js. Esse é o caminho recomendado pela Anthropic hoje. O instalador baixa o binário, coloca o Claude Code no PATH do sistema e configura a atualização automática em segundo plano (por padrão no canal latest, que recebe as novidades assim que saem; um canal estável, cerca de uma semana atrás, pode ser escolhido em /config).

Passo 1 -- Rode o instalador nativo do seu sistema operacional. Escolha apenas o comando correspondente

bash

# macOS, Linux ou WSL:
curl -fsSL https://claude.ai/install.sh | bash

powershell

# Windows (PowerShell):
irm https://claude.ai/install.ps1 | iex

batch

# Windows (Prompt de Comando / CMD):
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

Passo 2 -- Verifique se a instalação foi bem-sucedida

bash

# Verifique a versão instalada:
claude --version

# Saída esperada (exemplo):
# 2.1.x   (a série atual em agosto de 2026)

# Para atualizar manualmente a qualquer momento:
claude update

Passo 3 -- Faça login na primeira vez que abrir o Claude Code

bash

# Dentro de uma pasta qualquer, rode:
claude

# Na primeira execução, o Claude Code abre o navegador para você
# entrar com sua conta Claude.ai. Depois de autorizar, volte ao terminal.

# Para trocar de conta mais tarde, use /login dentro da sessão.

Existe ainda o método antigo por npm (npm install -g @anthropic-ai/claude-code). Ele continua funcionando, mas hoje é legado e exige o Node.js 22 ou superior instalado. Só compensa se você já mantém um ambiente Node e prefere gerenciar o Claude Code como um pacote npm. Se for esse o seu caso, o guia de Setup na seção Educação mostra como instalar o Node.js; para o instalador nativo, você não precisa dele.

Existem duas formas de pagar pelo uso do Claude Code

Assinatura Claude.ai: o Plano Pro (US$ 20/mês, ou US$ 17/mês no plano anual) para uso moderado ou o Plano Max (a partir de US$ 100/mês, em dois níveis) para uso intenso usam a cota da sua conta. Valores de agosto de 2026; confira em claude.com/pricing.
Chave de API (API Key): pagamento por uso, ideal para quem prefere pagar apenas pelo que consome.

Se você optar pela chave de API

bash

# Acesse o console da Anthropic:
https://console.anthropic.com/

# Vá em "API Keys" e crie uma nova chave.
# Copie a chave gerada.

# Configure a variável de ambiente:
# Windows (PowerShell):
$env:ANTHROPIC_API_KEY="sk-ant-sua-chave-aqui"

# Mac/Linux:
export ANTHROPIC_API_KEY="sk-ant-sua-chave-aqui"

Regra inviolável

Nunca compartilhe sua API Key. Ela é como a senha do seu acesso à IA: quem tiver sua chave pode gastar seu crédito. Não cole em prints, mensagens, repositórios públicos nem em código versionado.

Decisão

Para quem está começando, o Plano Pro (US$ 20/mês) costuma ser a escolha mais simples: você faz login uma vez e o Claude Code funciona automaticamente, sem precisar gerenciar chaves. A API por consumo compensa quando você quer pagar exatamente pelo que usa.

Com o login feito, vale um primeiro teste que já entrega algo útil: pedir ao Claude Code um inventário de uma pasta sua de trabalho. Serve para confirmar que ele enxerga seus arquivos e, de quebra, para você ver a ferramenta em ação sem risco, porque é uma tarefa só de leitura.

PromptPrimeiro teste pós-instalação: inventário de uma pasta

PAPEL E CONTEXTO
Você é o Claude Code recém-instalado na minha máquina. Este é o meu primeiro teste: quero confirmar que você lê meus arquivos e devolve algo organizado, sem alterar nada.

DADOS DE ENTRADA
A pasta de trabalho é [caminho da pasta que você quer inventariar]. Não modifique, mova nem apague qualquer arquivo; a tarefa é só de leitura.

TAREFA
1. Liste todos os arquivos e subpastas, com nome, tipo, tamanho e data da última modificação.
2. Agrupe por tipo de arquivo e diga quantos há de cada.
3. Aponte os cinco arquivos mais recentes e os cinco maiores.
4. Sinalize o que parecer duplicado, temporário ou fora do lugar.

FORMATO DE SAÍDA
Uma tabela com os arquivos (nome, tipo, tamanho, data) e, abaixo, um resumo de três linhas: total de arquivos, tipos predominantes e observações.

CRITÉRIOS
- Tarefa somente de leitura: não crie, mova nem exclua nada.
- Se a pasta tiver muitos arquivos, mostre os principais e diga quantos ficaram de fora do detalhamento.
- Liste o que você assumiu caso algum arquivo não tenha data ou tipo reconhecível.

Checkpoint

Execute 'claude --version' no terminal e veja a versão instalada. Em seguida, execute 'claude' e confirme que a interface interativa abre sem erros.

Perguntas frequentes deste capítulo

Preciso instalar o Node.js antes do Claude Code?

Não, com o método recomendado. O instalador nativo dispensa o Node.js: no macOS ou Linux rode 'curl -fsSL https://claude.ai/install.sh | bash' e no Windows, dentro do PowerShell, 'irm https://claude.ai/install.ps1 | iex'. O pacote antigo via npm (@anthropic-ai/claude-code) ainda existe, porém é legado e exige Node.js 22 ou superior, então prefira o nativo.

Como sei se a instalação deu certo no Windows?

Feche e reabra o PowerShell e digite 'claude --version'. Se aparecer um número da série 2.1.x, por exemplo 2.1.214, está instalado. Em seguida digite apenas 'claude' e pressione Enter: na primeira execução ele abre o navegador para você entrar com a sua conta Claude.ai.

Ao instalar e usar o Claude Code, meus arquivos vão todos para a nuvem?

A instalação em si não envia nada, e o Claude não varre seu disco por conta própria. Quando você pede uma tarefa sobre um arquivo, ele manda para a nuvem apenas o trecho necessário para processar a resposta, sempre a partir de algo que você solicitou. Trabalhe em pastas de projeto específicas, em vez da raiz do disco, e evite apontar o assistente para material sigiloso que não deveria sair da máquina.

Pro, Max ou API key: qual escolher para um uso moderado?

Para começar e para uso moderado, o plano Pro a US$20 por mês costuma bastar; se você usar o Claude Code de forma intensa no dia a dia, o Max a US$100 ou US$200 amplia os limites. A API key, criada em console.anthropic.com, cobra por consumo e faz sentido para uso muito esporádico ou automações pontuais. Confira os valores atuais em claude.com/pricing e nunca compartilhe sua API key, porque ela dá acesso cobrado à sua conta.

Claude Code CLI: Programação com IA · Capítulo 5 de 23 · 17 min

Instalação e primeiro acesso, sem depender do TI

Instale o Claude Code na sua máquina, verifique a instalação e configure a chave de acesso.

Este capítulo faz parte do curso gratuito Claude Code CLI: Programação com IA. Para marcar como concluído e salvar o progresso, abra este capítulo na página do curso.

Passo 1 -- Rode o instalador nativo do seu sistema operacional. Escolha apenas o comando correspondente

bash

# macOS, Linux ou WSL:
curl -fsSL https://claude.ai/install.sh | bash

powershell

# Windows (PowerShell):
irm https://claude.ai/install.ps1 | iex

batch

# Windows (Prompt de Comando / CMD):
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

Passo 2 -- Verifique se a instalação foi bem-sucedida

bash

# Verifique a versão instalada:
claude --version

# Saída esperada (exemplo):
# 2.1.x   (a série atual em agosto de 2026)

# Para atualizar manualmente a qualquer momento:
claude update

Passo 3 -- Faça login na primeira vez que abrir o Claude Code

bash

# Dentro de uma pasta qualquer, rode:
claude

# Na primeira execução, o Claude Code abre o navegador para você
# entrar com sua conta Claude.ai. Depois de autorizar, volte ao terminal.

# Para trocar de conta mais tarde, use /login dentro da sessão.

Existem duas formas de pagar pelo uso do Claude Code

Assinatura Claude.ai: o Plano Pro (US$ 20/mês, ou US$ 17/mês no plano anual) para uso moderado ou o Plano Max (a partir de US$ 100/mês, em dois níveis) para uso intenso usam a cota da sua conta. Valores de agosto de 2026; confira em claude.com/pricing.
Chave de API (API Key): pagamento por uso, ideal para quem prefere pagar apenas pelo que consome.

Se você optar pela chave de API

bash

# Acesse o console da Anthropic:
https://console.anthropic.com/

# Vá em "API Keys" e crie uma nova chave.
# Copie a chave gerada.

# Configure a variável de ambiente:
# Windows (PowerShell):
$env:ANTHROPIC_API_KEY="sk-ant-sua-chave-aqui"

# Mac/Linux:
export ANTHROPIC_API_KEY="sk-ant-sua-chave-aqui"

Regra inviolável

Decisão

PromptPrimeiro teste pós-instalação: inventário de uma pasta

PAPEL E CONTEXTO
Você é o Claude Code recém-instalado na minha máquina. Este é o meu primeiro teste: quero confirmar que você lê meus arquivos e devolve algo organizado, sem alterar nada.

DADOS DE ENTRADA
A pasta de trabalho é [caminho da pasta que você quer inventariar]. Não modifique, mova nem apague qualquer arquivo; a tarefa é só de leitura.

TAREFA
1. Liste todos os arquivos e subpastas, com nome, tipo, tamanho e data da última modificação.
2. Agrupe por tipo de arquivo e diga quantos há de cada.
3. Aponte os cinco arquivos mais recentes e os cinco maiores.
4. Sinalize o que parecer duplicado, temporário ou fora do lugar.

FORMATO DE SAÍDA
Uma tabela com os arquivos (nome, tipo, tamanho, data) e, abaixo, um resumo de três linhas: total de arquivos, tipos predominantes e observações.

CRITÉRIOS
- Tarefa somente de leitura: não crie, mova nem exclua nada.
- Se a pasta tiver muitos arquivos, mostre os principais e diga quantos ficaram de fora do detalhamento.
- Liste o que você assumiu caso algum arquivo não tenha data ou tipo reconhecível.

Checkpoint

Execute 'claude --version' no terminal e veja a versão instalada. Em seguida, execute 'claude' e confirme que a interface interativa abre sem erros.

Perguntas frequentes deste capítulo

Preciso instalar o Node.js antes do Claude Code?

Como sei se a instalação deu certo no Windows?

Ao instalar e usar o Claude Code, meus arquivos vão todos para a nuvem?

Pro, Max ou API key: qual escolher para um uso moderado?

Instalação e primeiro acesso, sem depender do TI

Passo 1 -- Rode o instalador nativo do seu sistema operacional. Escolha apenas o comando correspondente

Passo 2 -- Verifique se a instalação foi bem-sucedida

Passo 3 -- Faça login na primeira vez que abrir o Claude Code

Existem duas formas de pagar pelo uso do Claude Code

Se você optar pela chave de API

Perguntas frequentes deste capítulo

Privacidade e cookies

Instalação e primeiro acesso, sem depender do TI

Passo 1 -- Rode o instalador nativo do seu sistema operacional. Escolha apenas o comando correspondente

Passo 2 -- Verifique se a instalação foi bem-sucedida

Passo 3 -- Faça login na primeira vez que abrir o Claude Code

Existem duas formas de pagar pelo uso do Claude Code

Se você optar pela chave de API

Perguntas frequentes deste capítulo

Privacidade e cookies