Para usar o Claude Code do jeito oficial, você precisa de três passos: um plano pago, porque o plano gratuito não o inclui, sendo o mais barato o Pro, por 20 dólares por mês ou 17 dólares com cobrança anual; depois, o comando de instalação oficial do claude.ai para o seu sistema; e, por fim, o login pelo navegador na primeira execução. A Arábia Saudita está na lista de regiões suportadas da Anthropic, então você não precisa de intermediários nem de conta emprestada. Depois disso, instale o plugin Claude Code Setup a partir do marketplace oficial para que ele leia o seu projeto e recomende a configuração certa para ele, sem alterar um único arquivo.

Por que justamente o jeito oficial?

A Política de Regiões Suportadas da Anthropic diz que seus produtos, incluindo os aplicativos web, o Claude Code e a API, estão disponíveis apenas nos países listados, e a Arábia Saudita consta da lista junto com os Emirados Árabes Unidos, o Kuwait, o Catar, o Bahrein e Omã. A mesma política considera não suportado o uso a partir de um país que não está na lista, mesmo quando a conta pertence a uma entidade suportada. Se você está no Reino e usa a sua própria conta, está no caminho certo, e não há motivo para recorrer a atalhos que podem levar à suspensão da conta.

Há um segundo motivo: o instalador oficial atualiza a ferramenta automaticamente em segundo plano, de modo que as correções de segurança chegam até você assim que são lançadas. Os plugins, por outro lado, podem executar comandos automáticos e servidores de conexão externos na sua máquina, por isso a documentação oficial recomenda ler os detalhes de um plugin antes de instalá-lo, e o lugar mais seguro para começar é o marketplace oficial da Anthropic.

O que você precisa antes de instalar?

Segundo a página oficial de instalação, estes são os requisitos:

RequisitoDetalhes
Sistema operacionalmacOS 13.0 ou posterior, Windows 10 versão 1809 ou posterior, Windows Server 2019, ou Ubuntu 20.04, Debian 10 ou Alpine 3.19 e posteriores
HardwarePelo menos 4 GB de RAM e um processador x64 ou ARM64
RedeUma conexão de internet funcionando
ShellBash, Zsh, PowerShell ou CMD
ContaPro, Max, Team, Enterprise ou uma conta do Console

Quanto custa o Claude Code?

A ferramenta em si é gratuita para baixar, mas para usá-la é preciso uma conta paga. Estes são os planos conforme aparecem na página oficial de preços:

PlanoPreçoInclui o Claude Code?
FreeGratuitoNão
Pro20 dólares por mês, ou 17 dólares por mês com cobrança anual (200 dólares adiantados)Sim
MaxA partir de 100 dólares por mês, com cinco ou vinte vezes o uso do ProSim
Team e EnterprisePor usuário, com administração e cobrança centralizadasSim

Para uma pessoa física, o Pro basta para começar. Para uma empresa, o guia de autenticação recomenda o Team ou o Enterprise, porque reúne a cobrança e as permissões em um único painel e permite aplicar as mesmas configurações a todos os desenvolvedores.

Como instalar o Claude Code passo a passo?

Abra um terminal e cole o comando do seu sistema. Os comandos abaixo foram copiados literalmente da documentação oficial, e nenhum deles exige direitos de administrador.

No Mac, no Linux ou no WSL

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

No Windows

No PowerShell, que você reconhece pelo PS antes do caminho:

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

E no CMD:

curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

A documentação recomenda instalar o Git for Windows para que a ferramenta possa executar comandos Bash; sem ele, ela funciona pelo PowerShell.

Com Homebrew ou WinGet

Você também pode instalar com brew install --cask claude-code no Mac, ou winget install Anthropic.ClaudeCode no Windows. Observe que esses dois métodos não atualizam a ferramenta automaticamente, então você mesmo executa o comando de atualização, e que a versão estável do Homebrew costuma ficar cerca de uma semana atrás da versão mais recente.

O instalador não mostra barra de progresso durante o download, então não se preocupe se parecer travado. Quando terminar, abra uma nova janela do terminal antes do próximo passo.

Como fazer login com a sua conta?

  1. Vá até a pasta do seu projeto no terminal e digite claude.
  2. A ferramenta abre uma janela do navegador para você entrar com a sua conta do claude.ai. Se ela não abrir, pressione c para copiar o link e cole-o no navegador.
  3. Se o navegador mostrar um código em vez de redirecionar de volta, cole-o no terminal na linha Paste code here if prompted. Isso costuma acontecer dentro do WSL2, em sessões SSH ou em contêineres.
  4. Quando aparecer Login successful, pressione Enter e comece a trabalhar.

Para sair, digite /logout dentro da sessão. Se você tem uma conta de trabalho e uma pessoal, o jeito oficial é dar a cada conta a sua própria pasta de configurações por meio da variável CLAUDE_CONFIG_DIR, como neste alias:

alias claude-work='CLAUDE_CONFIG_DIR=~/.claude-work claude'

Como verificar se a instalação está correta?

claude --version
claude doctor

O primeiro comando exibe o número da versão, como 2.1.211, e o segundo verifica a instalação e os arquivos de configuração sem iniciar uma sessão, mostrando qualquer aviso com a respectiva correção.

O que é o plugin Claude Code Setup?

O Claude Code Setup é um plugin oficial da Anthropic no marketplace de plugins que analisa o seu projeto e recomenda as automações adequadas a ele. Ele lê arquivos como o package.json, a estrutura de pastas e a linguagem de programação e, em seguida, mostra as uma ou duas melhores sugestões em cada uma de cinco categorias, como explica o seu repositório oficial:

CategoriaO que fazExemplo do plugin
Servidores MCPConectam a ferramenta a serviços externoscontext7 para documentação, Playwright para testes de frontend
SkillsConhecimento especializado empacotado, carregado quando necessárioAs skills de planejamento e de design de frontend
HooksAções automáticas a cada ediçãoFormatar o código automaticamente, bloquear arquivos sensíveis
SubagentesRevisores especializadosRevisão de segurança, desempenho e acessibilidade
Comandos de barraAtalhos para tarefas repetidas/test, /pr-review e /explain

O mais importante é que ele é somente leitura: sugere e não altera nada nos seus arquivos, então a decisão continua sendo sua. Se você perguntar especificamente sobre uma categoria, ele amplia para três a cinco opções.

Como instalar e usar o plugin Claude Code Setup?

  1. Execute claude dentro do seu projeto e depois digite:
/plugin install claude-code-setup@claude-plugins-official
  1. Abre-se o painel de detalhes do plugin: o que ele vai adicionar, quando foi atualizado pela última vez e quanto contexto ele usa. Leia-o antes de concordar.
  2. Escolha o escopo da instalação: para você em todos os seus projetos, para todos que trabalham neste repositório, ou só para você neste repositório.
  3. Depois de instalar, digite um pedido como: recomende automações para este projeto, ou pergunte: que hooks devo usar?

A página oficial de plugins explica que o plugin pode precisar ser recarregado com /reload-plugins se o resumo da instalação pedir isso.

Quais são os erros de instalação mais comuns e suas soluções?

  • claude not found: a pasta de instalação ainda não está no seu PATH. Abra uma nova janela do terminal e, se o problema persistir, consulte a seção sobre como corrigir o PATH na documentação.
  • The token '&&' is not a valid statement separator: você está no PowerShell usando o comando do CMD, então use o comando do PowerShell.
  • 'irm' is not recognized: o contrário, você está no CMD usando o comando do PowerShell.
  • Plano gratuito: entrar com uma conta gratuita não basta, porque o Claude Code não está incluído nela.
  • Versão antiga: se você instalou com Homebrew ou WinGet, atualize manualmente com brew upgrade claude-code ou winget upgrade Anthropic.ClaudeCode.

E se você não gosta nada da linha de comando, o aplicativo oficial para desktop oferece o Claude Code com interface gráfica no Mac, no Windows e no Linux. Falamos das novidades mais recentes da ferramenta em Novidades do Claude Code, agosto de 2026.

Fontes