Skip to main content

Documentation Index

Fetch the complete documentation index at: https://code.claude.com/docs/llms.txt

Use this file to discover all available pages before exploring further.

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.

​
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:
curl -fsSL https://claude.ai/install.sh | bash
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:
claude
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 para sair do Claude Code.
  • Digite /help para ver os comandos disponíveis.

​
Windows

Siga estas etapas para instalar Git, 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

Git é uma ferramenta que Claude Code usa internamente para rastrear alterações em seu código. 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:
irm https://claude.ai/install.ps1 | iex
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:
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd
4

Inicie Claude Code

Feche PowerShell e abra uma nova janela PowerShell para que ele reconheça o comando claude recém-instalado. Depois digite:
claude
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 para sair do Claude Code.
  • Digite /help para ver os comandos disponíveis.

​
Próximos passos

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: 
make me a simple webpage that says hello world
Claude cria os arquivos para você. 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: 
look at the screenshots on my Desktop and rename them based on what's in each image

​
Faça perguntas

Claude pode explicar coisas, ajudá-lo a aprender ou planejar um projeto: 
I want to build a personal budget tracker. What would I need?
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, seu terminal precisa recarregar suas configurações. Feche a janela do Terminal e abra uma nova, depois tente claude novamente.Se ainda não funcionar, adicione o diretório de instalação ao seu PATH. Execute o comando para seu shell:
# Zsh (padrão do macOS)
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

# Bash (padrão do Linux)
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc
Depois tente claude novamente. 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:
brew install --cask claude-code
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:
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd
Isso geralmente acontece em sistemas Windows 10 mais antigos. Execute esta linha primeiro e depois tente novamente a instalação:
[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12
irm https://claude.ai/install.ps1 | iex
Nem Git para Windows nem PowerShell foi encontrado. Claude Code precisa de pelo menos um shell. Se apenas PowerShell for encontrado, Claude Code usa a ferramenta PowerShell em vez de Bash.
  1. Se você ainda não instalou Git, volte para a primeira etapa na seção Windows. Alternativamente, instale PowerShell 7.
  2. Se Git está instalado mas Claude Code não consegue encontrá-lo, diga a ele onde procurar: 
    $env:CLAUDE_CODE_GIT_BASH_PATH="C:\Program Files\Git\bin\bash.exe"
    Depois execute claude novamente. Se seu Git está instalado em outro lugar, encontre o caminho executando: 
    Get-Command git | Select-Object Source
    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.
Reinicie seu computador e tente novamente. Isso geralmente resolve o problema.Se reiniciar não ajudou, execute estes comandos para adicionar Claude Code ao seu PATH:
$currentPath = [Environment]::GetEnvironmentVariable('PATH', 'User')
[Environment]::SetEnvironmentVariable('PATH', "$currentPath;$env:USERPROFILE\.local\bin", 'User')
Feche PowerShell, abra uma nova janela e tente claude novamente. Consulte verificar seu PATH para mais detalhes.
Para outros erros, consulte o guia completo de solução de problemas de instalação.