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

# Início rápido

> Instale o Claude Code no seu terminal, faça login e use a CLI para explorar sua base de código e fazer sua primeira alteração de código.

Este guia de início rápido aborda o Claude Code no seu terminal: como instalar a CLI, fazer login a partir da sua primeira sessão e usá-lo para tarefas comuns de desenvolvimento no seu próprio projeto.

<h2 id="before-you-begin">
  Antes de começar
</h2>

Certifique-se de que você tem:

* Um terminal ou prompt de comando aberto
* Um projeto de código para trabalhar
* Uma [assinatura Claude](https://claude.com/pricing?utm_source=claude_code\&utm_medium=docs\&utm_content=quickstart_prereq) (Pro, Max, Team ou Enterprise), conta do [Claude Console](https://platform.claude.com/), ou acesso através de um [provedor de nuvem suportado](/docs/pt/third-party-integrations)

<Note>
  Estes casos são abordados em outras páginas:

  * **Nunca usou um terminal antes**: comece com o [guia de terminal](/docs/pt/terminal-guide)
  * **Quer usar o Claude Code em outro lugar que não seja o terminal**: Claude Code também está disponível na [web](https://claude.ai/code), como um [aplicativo de desktop](/docs/pt/desktop), em [VS Code](/docs/pt/vs-code) e [IDEs JetBrains](/docs/pt/jetbrains), no [Slack](/docs/pt/slack), e em CI/CD com [GitHub Actions](/docs/pt/github-actions) e [GitLab](/docs/pt/gitlab-ci-cd). Veja [todas as interfaces](/docs/pt/overview#use-claude-code-everywhere).
</Note>

<h2 id="step-1-install-claude-code">
  Passo 1: Instale Claude Code
</h2>

Para instalar Claude Code, abra um terminal e execute o comando para seu sistema. Se você nunca usou um terminal antes, o [guia de terminal](/docs/pt/terminal-guide) mostra como abrir um e colar o comando.

<Tabs>
  <Tab title="Instalação Nativa (Recomendado)">
    **macOS, Linux, WSL:**

    ```bash theme={null}
    curl -fsSL https://claude.ai/install.sh | bash
    ```

    No Windows, seu prompt mostra `PS C:\` quando você está no PowerShell e `C:\` sem o `PS` quando você está no CMD.

    **Windows PowerShell:**

    ```powershell theme={null}
    irm https://claude.ai/install.ps1 | iex
    ```

    **Windows CMD:**

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

    O comando de instalação não mostra nenhum progresso enquanto baixa o Claude Code. Quando o instalador terminar, abra uma nova janela de terminal e execute `claude --version`. Uma instalação funcionando imprime um número de versão. Se seu shell disser que `claude` não foi encontrado ou não é reconhecido, o diretório de instalação ainda não está em seu PATH: consulte [Corrija seu PATH](/docs/pt/troubleshoot-install#command-not-found-claude-after-installation).

    Se você vir `The token '&&' is not a valid statement separator`, você está no PowerShell, não no CMD. Se você vir `'irm' is not recognized as an internal or external command`, você está no CMD, não no PowerShell.

    Se o comando de instalação falhar com `syntax error near unexpected token '<'`, um `403`, ou qualquer outro erro, consulte [Solucionar problemas de instalação](/docs/pt/troubleshoot-install#find-your-error) para corresponder o erro a uma correção e para métodos alternativos de instalação.

    [Git for Windows](https://git-scm.com/downloads/win) é recomendado no Windows nativo para que Claude Code possa usar a ferramenta Bash. Se Git for Windows não estiver instalado, Claude Code usa PowerShell como ferramenta de shell. Configurações WSL não precisam de Git for Windows.

    <Info>
      As instalações nativas são atualizadas automaticamente em segundo plano para mantê-lo na versão mais recente.
    </Info>
  </Tab>

  <Tab title="Homebrew">
    ```bash theme={null}
    brew install --cask claude-code
    ```

    Homebrew oferece dois casks. `claude-code` rastreia o canal de versão estável, que normalmente fica cerca de uma semana atrás e pula versões com regressões importantes. `claude-code@latest` rastreia o canal mais recente e recebe novas versões assim que são lançadas.

    <Info>
      As instalações do Homebrew não são atualizadas automaticamente. Execute `brew upgrade claude-code` ou `brew upgrade claude-code@latest`, dependendo de qual cask você instalou, para obter os recursos mais recentes e correções de segurança.
    </Info>
  </Tab>

  <Tab title="WinGet">
    ```powershell theme={null}
    winget install Anthropic.ClaudeCode
    ```

    <Info>
      As instalações do WinGet não são atualizadas automaticamente. Execute `winget upgrade Anthropic.ClaudeCode` periodicamente para obter os recursos mais recentes e correções de segurança.
    </Info>
  </Tab>
</Tabs>

Você também pode instalar com [apt, dnf, ou apk](/docs/pt/setup#install-with-linux-package-managers) no Debian, Fedora, RHEL e Alpine.

Para confirmar que a instalação funcionou, execute:

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

O comando imprime um número de versão seguido por `(Claude Code)`.

<h2 id="step-2-start-your-first-session">
  Passo 2: Inicie sua primeira sessão
</h2>

Abra seu terminal em qualquer diretório de projeto e inicie o Claude Code:

```bash theme={null}
cd /path/to/your/project
claude
```

Substitua `/path/to/your/project` pelo caminho do projeto em que você deseja trabalhar.

O Claude Code solicita que você faça login no primeiro uso. Para contas de assinatura do Claude ou do Console, siga as instruções para concluir a autenticação no seu navegador. Se você definiu a variável de ambiente `ANTHROPIC_API_KEY` e aprovar a chave quando o Claude Code perguntar se deve usá-la, o Claude Code pula o prompt de login.

Você pode fazer login usando qualquer um destes tipos de conta:

* [Claude Pro, Max, Team ou Enterprise](https://claude.com/pricing?utm_source=claude_code\&utm_medium=docs\&utm_content=quickstart_login) (recomendado)
* [Claude Console](https://platform.claude.com/) (acesso à API com créditos pré-pagos). No primeiro login, um workspace "Claude Code" é criado automaticamente no Console para rastreamento centralizado de custos.
* [Amazon Bedrock, Google Cloud's Agent Platform ou Microsoft Foundry](/docs/pt/third-party-integrations) (provedores de nuvem empresariais)
* Um [gateway de apps do Claude](/docs/pt/claude-apps-gateway) auto-hospedado, se sua organização executar um: seu administrador pré-configura a URL do gateway, e `/login` abre diretamente na tela **Cloud gateway** para que você entre com o SSO corporativo

Depois de fazer login, suas credenciais são armazenadas e você não precisará fazer login novamente. Saiba mais em [Gerenciamento de credenciais](/docs/pt/authentication#credential-management).

O prompt do Claude Code aparece com a versão, o modelo atual e o diretório de trabalho exibidos acima dele. Digite `/help` para ver os comandos disponíveis ou `/resume` para continuar uma conversa anterior. Para trocar de conta mais tarde ou autenticar novamente, digite `/login` dentro da sessão em execução.

<h2 id="step-3-ask-your-first-question">
  Passo 3: Faça sua primeira pergunta
</h2>

Experimente um destes comandos:

```text wrap theme={null}
what does this project do?
```

Claude analisará seus arquivos e fornecerá um resumo. Você também pode fazer perguntas mais específicas:

```text wrap theme={null}
what technologies does this project use?
```

```text wrap theme={null}
where is the main entry point?
```

```text wrap theme={null}
explain the folder structure
```

Você também pode perguntar ao Claude sobre suas próprias capacidades:

```text wrap theme={null}
what can Claude Code do?
```

```text wrap theme={null}
how do I create custom skills in Claude Code?
```

```text wrap theme={null}
can Claude Code work with Docker?
```

<Note>
  O Claude Code lê os arquivos do seu projeto conforme necessário. Você não precisa adicionar contexto manualmente.
</Note>

<h2 id="step-4-make-your-first-code-change">
  Passo 4: Faça sua primeira alteração de código
</h2>

Experimente uma tarefa pequena:

```text wrap theme={null}
add a hello world function to the main file
```

O Claude Code encontra o arquivo apropriado e mostra a alteração para você. Se ele perguntar antes de fazer a alteração, selecione **Yes** para aprovar.

O [modo de permissão](/docs/pt/permission-modes) da sessão define quais ações o Claude pode realizar sem perguntar a você primeiro. Pressione `Shift+Tab` a qualquer momento para alternar o modo de permissão da sessão em que você está.

<h2 id="step-5-use-git-with-claude-code">
  Passo 5: Use o Git com o Claude Code
</h2>

O Claude Code torna as operações do Git conversacionais:

```text wrap theme={null}
what files have I changed?
```

```text wrap theme={null}
commit my changes with a descriptive message
```

Você também pode solicitar operações do Git mais complexas:

```text wrap theme={null}
create a new branch called feature/quickstart
```

```text wrap theme={null}
show me the last 5 commits
```

```text wrap theme={null}
help me resolve merge conflicts
```

<h2 id="step-6-fix-a-bug-or-add-a-feature">
  Passo 6: Corrija um bug ou adicione um recurso
</h2>

Descreva o que você deseja em linguagem natural:

```text wrap theme={null}
add input validation to the user registration form
```

Ou corrija problemas existentes:

```text wrap theme={null}
there's a bug where users can submit empty forms - fix it
```

<h2 id="step-7-test-out-other-common-workflows">
  Passo 7: Teste outros fluxos de trabalho comuns
</h2>

Experimente mais alguns prompts. Você pode pedir ao Claude para refatorar código, escrever testes, atualizar a documentação ou revisar suas alterações:

```text wrap theme={null}
refactor the authentication module to use async/await instead of callbacks
```

```text wrap theme={null}
write unit tests for the calculator functions
```

```text wrap theme={null}
update the README with installation instructions
```

```text wrap theme={null}
review my changes and suggest improvements
```

<Tip>
  Converse com o Claude como você faria com um colega prestativo. Descreva o que você deseja alcançar, e ele ajudará você a chegar lá.
</Tip>

<h2 id="essential-commands">
  Comandos essenciais
</h2>

Aqui estão os comandos mais importantes para uso diário, agrupados por onde você os executa.

<h3 id="shell-commands">
  Comandos shell
</h3>

Execute estes a partir do seu terminal para iniciar ou retomar Claude Code.

| Comando | O que faz | Exemplo |
| - | - | - |
| `claude` | Iniciar modo interativo | `claude` |
| `claude "task"` | Iniciar modo interativo com um prompt inicial | `claude "fix the build error"` |
| `claude -p "query"` | Executar consulta única, depois sair | `claude -p "explain this function"` |
| `claude -c` | Continuar conversa mais recente no diretório atual | `claude -c` |
| `claude -r` | Retomar uma conversa anterior | `claude -r` |

Veja a [referência CLI](/docs/pt/cli-reference) para a lista completa de comandos shell.

<h3 id="session-commands">
  Comandos de sessão
</h3>

Execute estes dentro do Claude Code após ele iniciar.

| Comando | O que faz | Exemplo |
| - | - | - |
| `/clear` | Limpar histórico de conversa | `/clear` |
| `/help` | Mostrar comandos disponíveis | `/help` |
| `/exit` ou Ctrl+D duas vezes | Sair do Claude Code | `/exit` |

Veja a [referência de comandos](/docs/pt/commands) para a lista completa de comandos de sessão.

<h2 id="pro-tips-for-beginners">
  Dicas profissionais para iniciantes
</h2>

Para mais, veja [melhores práticas](/docs/pt/best-practices) e [fluxos de trabalho comuns](/docs/pt/common-workflows).

<AccordionGroup>
  <Accordion title="Seja específico com seus pedidos">
    Em vez de: "corrigir o bug"

    Tente: "corrigir o bug de login onde os usuários veem uma tela em branco após inserir credenciais incorretas"
  </Accordion>

  <Accordion title="Use instruções passo a passo">
    Divida tarefas complexas em etapas:

    ```text wrap theme={null}
    1. criar uma nova tabela de banco de dados para perfis de usuário
    2. criar um endpoint de API para obter e atualizar perfis de usuário
    3. construir uma página da web que permite aos usuários ver e editar suas informações
    ```
  </Accordion>

  <Accordion title="Deixe Claude explorar primeiro">
    Antes de fazer alterações, deixe Claude entender seu código:

    ```text wrap theme={null}
    analisar o esquema do banco de dados
    ```

    ```text wrap theme={null}
    construir um painel mostrando produtos que são devolvidos com mais frequência por nossos clientes do Reino Unido
    ```
  </Accordion>

  <Accordion title="Economize tempo com atalhos">
    * Digite `/` para ver todos os comandos e skills disponíveis para você
    * Use Tab para conclusão de comando
    * Pressione ↑ para histórico de comando
    * Pressione `Shift+Tab` para alternar modos de permissão
  </Accordion>
</AccordionGroup>

<h2 id="what’s-next">
  Próximos passos
</h2>

Agora que você aprendeu o básico, explore recursos mais avançados:

* [Como Claude Code funciona](/docs/pt/how-claude-code-works): entenda o loop agêntico, ferramentas integradas e como Claude Code interage com seu projeto
* [Boas práticas](/docs/pt/best-practices): obtenha melhores resultados com prompting eficaz e configuração de projeto
* [Fluxos de trabalho comuns](/docs/pt/common-workflows): guias passo a passo para tarefas comuns
* [Estenda Claude Code](/docs/pt/features-overview): personalize com CLAUDE.md, skills, hooks, MCP e muito mais

Consulte a [configuração avançada](/docs/pt/setup) para opções de instalação, atualizações manuais ou instruções de desinstalação.

<h2 id="getting-help">
  Obtendo ajuda
</h2>

* **Em Claude Code**: digite `/help` ou faça uma pergunta do tipo "como faço para"
* **Documentação**: navegue pelos outros guias neste site
* **Cursos**: Faça [Claude Code 101](https://academy.claude.com/courses/claude-code-101) e outros cursos gratuitos no seu próprio ritmo em [Claude Academy](https://academy.claude.com/)
* **Comunidade**: Junte-se ao [servidor do Discord](https://www.anthropic.com/discord) para dicas e suporte