> ## 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.

# Guia de terminal para novos usuários

> Um guia passo a passo para instalar Claude Code para usuários de terminal iniciantes no macOS e Windows.

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.

* [macOS e Linux](#macos-and-linux)
* [Windows](#windows)

<Note>
  Não quer usar o terminal? O aplicativo desktop Claude Code permite que você ignore o terminal completamente. Baixe-o para [macOS](https://claude.ai/api/desktop/darwin/universal/dmg/latest/redirect?utm_source=claude_code\&utm_medium=docs), [Windows](https://claude.com/download?utm_source=claude_code\&utm_medium=docs) ou [Linux](https://claude.com/download?utm_source=claude_code\&utm_medium=docs), depois consulte o [Guia de início rápido do Desktop](/pt/desktop-quickstart) para começar.
</Note>

<h2 id="macos-and-linux">
  macOS e Linux
</h2>

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](/pt/setup#system-requirements) para distribuições Linux suportadas.

<Steps>
  <Step title="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.
  </Step>

  <Step title="Instale Claude Code">
    Copie esta linha, cole-a em seu terminal (`Cmd + V` no macOS, `Ctrl + Shift + V` no Linux) e pressione `Enter`:

    ```bash theme={null}
    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](#macos-and-linux-troubleshooting) abaixo.
  </Step>

  <Step title="Inicie Claude Code">
    Digite `claude` e pressione `Enter`:

    ```bash theme={null}
    claude
    ```

    Você será solicitado a [fazer login](/pt/authentication) com sua conta Claude. Siga as instruções na tela. Uma janela do navegador será aberta para você fazer login.
  </Step>

  <Step title="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.
  </Step>
</Steps>

***

<h2 id="windows">
  Windows
</h2>

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](/pt/setup#system-requirements) para detalhes completos.

<Steps>
  <Step title="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](https://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.

    <Note>
      Já tem Git? Você pode pular esta etapa. Se não tiver certeza, instale mesmo assim. Reinstalar não causará problemas.
    </Note>
  </Step>

  <Step title="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.

    <Note>
      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`
    </Note>
  </Step>

  <Step title="Instale Claude Code">
    Copie esta linha, cole-a no PowerShell com `Ctrl + V` ou clique com o botão direito e pressione `Enter`:

    ```powershell theme={null}
    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](#windows-troubleshooting) abaixo.

    <Note>
      Se você estiver em CMD em vez de PowerShell, use este comando:

      ```batch theme={null}
      curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd
      ```
    </Note>
  </Step>

  <Step title="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'](#windows-troubleshooting) abaixo, depois abra uma nova janela PowerShell e tente novamente.

    ```powershell theme={null}
    claude
    ```

    Você será solicitado a [fazer login](/pt/authentication) com sua conta Claude. Siga as instruções na tela. Uma janela do navegador será aberta para você fazer login.
  </Step>

  <Step title="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.
  </Step>
</Steps>

***

<h2 id="what’s-next">
  O que vem a seguir?
</h2>

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ê.

<h3 id="build-something">
  Construa algo
</h3>

Claude pode criar projetos a partir de uma descrição:

```text theme={null}
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.

<h3 id="work-with-files-on-your-computer">
  Trabalhe com arquivos em seu computador
</h3>

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

```text theme={null}
look at the screenshots on my Desktop and rename them based on what's in each image
```

<h3 id="ask-questions">
  Faça perguntas
</h3>

Claude pode explicar coisas, ajudá-lo a aprender ou planejar um projeto:

```text theme={null}
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.

<h3 id="other-ways-to-use-claude-code">
  Outras maneiras de usar Claude Code
</h3>

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

* [VS Code](/pt/vs-code) e [IDEs JetBrains](/pt/jetbrains) como extensões de editor
* O [aplicativo desktop](/pt/desktop-quickstart), sem terminal necessário
* A [web](/pt/claude-code-on-the-web) em claude.ai/code para sessões remotas
* [GitHub Actions](/pt/github-actions) e [GitLab CI/CD](/pt/gitlab-ci-cd) para automação

<h3 id="learn-more">
  Saiba mais
</h3>

* [Guia de início rápido](/pt/quickstart): um passo a passo guiado de seu primeiro projeto com Claude Code
* [Como Claude Code funciona](/pt/how-claude-code-works): entenda como Claude lê seus arquivos, executa comandos e faz edições
* [Melhores práticas](/pt/best-practices): obtenha melhores resultados com prompts eficazes e configuração de projeto
* [Fluxos de trabalho comuns](/pt/common-workflows): guias passo a passo para depuração, testes, refatoração e muito mais
* [Configuração de terminal](/pt/terminal-config): personalize seu terminal para a melhor experiência com Claude Code

***

<h2 id="troubleshooting">
  Solução de problemas
</h2>

<h3 id="macos-and-linux-troubleshooting">
  Solução de problemas do macOS e Linux
</h3>

Se você encontrar problemas ao instalar no macOS ou Linux, verifique estes problemas comuns:

<Accordion title="'command not found: claude'">
  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:

  ```bash theme={null}
  echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc
  source ~/.zshrc
  ```

  Para Bash, o shell padrão do Linux:

  ```bash theme={null}
  echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc
  source ~/.bashrc
  ```

  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](/pt/troubleshoot-install#verify-your-path).
</Accordion>

<Accordion title="Erro com código HTML ou 'syntax error near unexpected token'">
  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](https://www.anthropic.com/supported-countries).

  Caso contrário, tente executar o comando novamente. Se continuar acontecendo, instale com [Homebrew](https://brew.sh) em vez disso:

  ```bash theme={null}
  brew install --cask claude-code
  ```
</Accordion>

<Accordion title="Erro 'dyld' ou 'built for Mac OS X 13.0'">
  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](/pt/troubleshoot-install#dyld-cannot-load-on-macos) para mais detalhes.
</Accordion>

Para outros erros, consulte o [guia completo de solução de problemas de instalação](/pt/troubleshoot-install).

<h3 id="windows-troubleshooting">
  Solução de problemas do Windows
</h3>

Se você encontrar problemas ao instalar no Windows, verifique estes problemas comuns:

<Accordion title="'irm is not recognized'">
  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:

  ```batch theme={null}
  curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd
  ```
</Accordion>

<Accordion title="Erro SSL/TLS ou 'Could not create SSL/TLS secure channel'">
  Isso geralmente acontece em sistemas Windows 10 mais antigos. Execute esta linha primeiro e depois tente novamente a instalação:

  ```powershell theme={null}
  [Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12
  irm https://claude.ai/install.ps1 | iex
  ```
</Accordion>

<Accordion title="'Claude Code on Windows requires either Git for Windows (for bash) or PowerShell'">
  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](https://aka.ms/powershell), que fornece `pwsh`.
  2. Se você preferir usar Git Bash, instale [Git for Windows](https://git-scm.com/downloads/win) de acordo com a [primeira etapa na seção Windows](#windows).
  3. Se Git está instalado mas Claude Code não consegue encontrá-lo, diga a ele onde procurar:
     ```powershell theme={null}
     $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:
     ```powershell theme={null}
     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](/pt/troubleshoot-install#claude-code-on-windows-requires-either-git-for-windows-for-bash-or-powershell).
</Accordion>

<Accordion title="'claude is not recognized'">
  Este erro significa que o diretório de instalação não está em seu PATH. Execute estes comandos em PowerShell para adicioná-lo:

  ```powershell theme={null}
  $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](/pt/troubleshoot-install#verify-your-path) para mais detalhes.
</Accordion>

Para outros erros, consulte o [guia completo de solução de problemas de instalação](/pt/troubleshoot-install).