Skip to main content
Você pode usar Claude Code mesmo que nunca tenha usado um terminal antes. Este guia o orienta na abertura de um terminal, instalação do Claude Code e suas primeiras interações.
Não quer usar o terminal? O aplicativo desktop Claude Code permite que você ignore o terminal completamente. Baixe-o para macOS ou Windows, depois consulte o Guia de início rápido do Desktop para começar. No Linux, instale o aplicativo com apt seguindo as instruções de instalação do Linux.

​
macOS e Linux

Siga estas etapas para instalar e iniciar Claude Code a partir de um terminal macOS ou Linux. Claude Code requer macOS 13.0 ou posterior. Consulte os requisitos do sistema para distribuições Linux suportadas.
1

Abra um terminal

macOS: Pressione Cmd + Space para abrir a Busca Spotlight, digite Terminal e pressione Enter.Linux: Abra seu aplicativo de terminal. Na maioria das distribuições, pressione Ctrl + Alt + T ou procure por “Terminal” no menu de aplicativos.Uma janela aparecerá com um cursor piscante. Este é seu terminal, onde você digita comandos.
2

Instale Claude Code

Copie esta linha, cole-a em seu terminal (Cmd + V no macOS, Ctrl + Shift + V no Linux) e pressione Enter:
Isso baixa e executa o instalador Claude Code de claude.ai. Você verá texto rolando enquanto funciona. Quando terminar, você verá “Claude Code successfully installed!” Se você vir um erro em vez disso, verifique a seção de solução de problemas abaixo.
3

Inicie Claude Code

Digite claude e pressione Enter:
Se você vir command not found: claude, o diretório de instalação ainda não está no seu PATH. Siga a correção ‘command not found: claude’ abaixo, depois abra uma nova janela de terminal e tente novamente.Você será solicitado a fazer login com sua conta Claude. Siga as instruções na tela. Uma janela do navegador será aberta para você fazer login.
4

Comece a usar Claude Code

Depois de fazer login, você pode começar a fazer perguntas ao Claude sobre seu código ou qualquer outra coisa. Claude Code funciona inteiramente em texto. Você digita mensagens e pressiona Enter para enviá-las. Algumas coisas a saber:
  • Você não pode clicar em coisas no terminal. Use as setas para se mover.
  • Pressione Esc para interromper Claude se estiver em execução.
  • Digite exit ou pressione Ctrl + D duas vezes em um prompt vazio para sair do Claude Code.
  • Digite /help para ver os comandos disponíveis.

​
Windows

Siga estas etapas para instalar opcionalmente Git para Windows, configurar PowerShell e iniciar Claude Code no Windows. Claude Code requer Windows 10 versão 1809 ou posterior. Consulte os requisitos do sistema para detalhes completos.
1

Instale Git para Windows (opcional)

Git para Windows fornece Git Bash, que habilita a ferramenta Bash. Sem ele, Claude Code usa PowerShell em vez disso. Você não precisará aprender Git por conta própria.Se você ainda não o tiver:
  1. Vá para git-scm.com/downloads/win e baixe o instalador
  2. Execute o instalador. Clique em Próximo em cada tela para aceitar os padrões. O instalador tem muitas telas, mas você não precisa alterar nada.
  3. Se ele pedir para você escolher um editor, mantenha o padrão e clique em Próximo.
  4. Quando você vir “Adjusting your PATH environment,” mantenha a opção recomendada selecionada.
Já tem Git? Você pode pular esta etapa. Se não tiver certeza, instale mesmo assim. Reinstalar não causará problemas.
2

Abra PowerShell

PowerShell é o terminal integrado do Windows para digitar comandos. Ele vem pré-instalado em todos os computadores Windows.Pressione Win + X e selecione Windows PowerShell (ou Terminal) no menu. Uma janela com um cursor piscante aparecerá. É aqui que você digitará comandos.
Windows tem dois programas de linha de comando: PowerShell e CMD. Eles parecem semelhantes, mas usam comandos diferentes. Certifique-se de estar no PowerShell para a próxima etapa.Como saber em qual você está:
  • PowerShell: mostra PS C:\Users\YourName> no início de cada linha
  • CMD: mostra C:\Users\YourName> sem o PS
3

Instale Claude Code

Copie esta linha, cole-a no PowerShell com Ctrl + V ou clique com o botão direito e pressione Enter:
Isso baixa e executa o instalador Claude Code. irm busca o arquivo e iex o executa. Você verá texto rolando enquanto funciona. Quando terminar, você verá “Claude Code successfully installed!” Se você vir um erro em vez disso, verifique a seção de solução de problemas abaixo.
Se você estiver em CMD em vez de PowerShell, use este comando:
4

Inicie Claude Code

Execute claude. Se PowerShell disser 'claude' is not recognized, o diretório de instalação ainda não está no seu PATH. Siga a correção ‘claude is not recognized’ abaixo, depois abra uma nova janela PowerShell e tente novamente.
Você será solicitado a fazer login com sua conta Claude. Siga as instruções na tela. Uma janela do navegador será aberta para você fazer login.
5

Comece a usar Claude Code

Depois de fazer login, você pode começar a fazer perguntas ao Claude sobre seu código ou qualquer outra coisa. Claude Code funciona inteiramente em texto. Você digita mensagens e pressiona Enter para enviá-las. Algumas coisas a saber:
  • Você não pode clicar em coisas no terminal. Use as setas para se mover.
  • Pressione Esc para interromper Claude se estiver em execução.
  • Digite exit ou pressione Ctrl + D duas vezes em um prompt vazio para sair do Claude Code.
  • Digite /help para ver os comandos disponíveis.

​
O que vem a seguir?

Depois de ver a tela de boas-vindas do Claude Code, você está pronto para começar. Você não precisa saber como codificar. Descreva o que deseja em inglês simples e Claude escreve o código para você.

​
Construa algo

Claude pode criar projetos a partir de uma descrição:
Se Claude pedir sua permissão antes de criar ou alterar arquivos, pressione Enter para escolher Sim e aprovar. Depois que Claude criar os arquivos, clique duas vezes no arquivo HTML para abri-lo em seu navegador.

​
Trabalhe com arquivos em seu computador

Claude pode ler e organizar arquivos que você já tem:

​
Faça perguntas

Claude pode explicar coisas, ajudá-lo a aprender ou planejar um projeto:
Se você ainda não tem um projeto, tudo bem. Claude pode ajudá-lo a iniciar um novo.

​
Outras maneiras de usar Claude Code

Você não precisa usar o terminal. Claude Code também está disponível em:

​
Saiba mais

​
Solução de problemas

​
Solução de problemas do macOS e Linux

Se você encontrar problemas ao instalar no macOS ou Linux, verifique estes problemas comuns:
Se você vir command not found: claude após instalar, a pasta onde o instalador colocou claude não está em seu PATH. O instalador imprime a correção exata em Setup notes no final da instalação, então execute esse comando, ou use o abaixo para seu shell.Para Zsh, o shell padrão do macOS:
Para Bash no Linux:
Para Bash no macOS, siga a etapa macOS Bash em corrigir seu PATH em vez disso.Depois abra um novo terminal e tente claude novamente. Se ainda não for encontrado, verifique se o arquivo ~/.local/bin/claude existe. Se não existir, a instalação não foi concluída. Para mais detalhes, consulte corrigir seu PATH.
Se você vir bash: line 1: syntax error near unexpected token '<' ou código HTML como <!DOCTYPE html> em seu terminal, a URL de instalação retornou uma página da web em vez do script do instalador.Se a página disser “App unavailable in region,” Claude Code não está disponível em seu país. Consulte países suportados.Caso contrário, tente executar o comando novamente. Se continuar acontecendo, instale com Homebrew em vez disso:
Quando terminar, abra uma nova janela de terminal, digite claude --version e pressione Enter: o comando imprime um número de versão como 2.1.211 (Claude Code) quando a instalação funcionou.
Se você vir dyld: cannot load, dyld: Symbol not found, ou built for Mac OS X 13.0, sua versão do macOS provavelmente é mais antiga do que Claude Code suporta.Abra o menu Apple e selecione About This Mac para verificar sua versão. Se for mais antiga que 13.0, atualize o macOS através de Software Update. Consulte o guia de solução de problemas do macOS para mais detalhes.
Para outros erros, consulte o guia completo de solução de problemas de instalação.

​
Solução de problemas do Windows

Se você encontrar problemas ao instalar no Windows, verifique estes problemas comuns:
Você está em CMD, não em PowerShell. Feche esta janela e abra PowerShell em vez disso (Win + X e depois selecione Windows PowerShell).Alternativamente, use o comando de instalação do CMD:
Isso geralmente acontece em sistemas Windows 10 mais antigos. Execute esta linha primeiro e depois tente novamente a instalação:
Nem PowerShell nem Git Bash foi encontrado. Claude Code precisa de pelo menos um shell.
  1. Certifique-se de que powershell.exe está em seu PATH. Seu local padrão é C:\Windows\System32\WindowsPowerShell\v1.0\. Alternativamente, instale PowerShell 7, que fornece pwsh.
  2. Se você preferir usar Git Bash, instale Git for Windows de acordo com a primeira etapa na seção Windows.
  3. Se Git está instalado mas Claude Code não consegue encontrá-lo, diga a ele onde procurar:
    Depois execute claude novamente. Se seu Git está instalado em outro lugar, encontre o caminho executando:
    Procure pela pasta Git\bin nesse caminho e use-a em vez disso.
Para tornar isso permanente para que você não tenha que configurar a cada vez, consulte configurar caminho do Git Bash.
Este erro significa que o diretório de instalação não está em seu PATH. Execute estes comandos em PowerShell para adicioná-lo:
Feche PowerShell, abra uma nova janela e tente claude novamente. Você deve ver a tela de boas-vindas do Claude Code. Consulte verificar seu PATH para mais detalhes.
Em uma máquina de 64 bits, este erro significa que você abriu Windows PowerShell (x86) em vez de Windows PowerShell. A entrada x86 é executada como um processo de 32 bits. Feche-a, abra a entrada do menu Iniciar sem (x86) em seu nome e execute o comando de instalação novamente. Se você não tiver certeza se sua máquina é de 64 bits, ou se o erro persistir, consulte a explicação completa.
Para outros erros, consulte o guia completo de solução de problemas de instalação.