Source: https://claudetutorial.com/guides/pt-br/claude-code-para-iniciantes-instale-entre-e-faca-sua-primeira-tarefa

[Voltar para Guias](https://claudetutorial.com/guides/pt-br)

Builders

# Claude Code para iniciantes: instale, entre e faça sua primeira tarefa

27 de outubro de 2026 15 min de leitura

---

A maioria das pessoas conhece o Claude Code como conhece qualquer ferramenta nova: abre um terminal, se sente perdida e volta a colar código numa janela de chat. Funciona, mas joga fora justamente o que torna o Claude Code diferente. Ele não precisa que você cole nada.

> No chat, você leva o seu projeto até o Claude. No Claude Code, o Claude entra no seu projeto.

Este guia leva você de nada instalado até uma primeira tarefa concluída. Você vai instalar, entrar na conta, fazer perguntas sobre um projeto de verdade, fazer uma pequena mudança e aprender os poucos comandos que cobrem a maior parte da sua primeira semana.

## O que o Claude Code realmente é

O Claude Code é um assistente que roda no seu terminal, dentro da pasta do seu projeto. Quando você dá uma tarefa, ele trabalha em um ciclo de três fases: reúne contexto, age e verifica o resultado. Repete o ciclo até a tarefa terminar, e você pode interrompê-lo a qualquer momento.

O Claude escolhe a próxima fase conforme o que o último passo revelou. Você pode intervir a qualquer momento.

A diferença para o chat está nas ferramentas. Um chat só responde com texto. O Claude Code pode ler seus arquivos, editá-los, pesquisar no projeto, rodar comandos como a sua suíte de testes e usar o git. Cada resultado alimenta a decisão seguinte.

Digamos que você peça para consertar os testes que estão falhando. Em geral ele roda os testes para ver o que falha, lê a saída de erro, procura os arquivos envolvidos, lê esses arquivos, edita e roda os testes de novo. Você escreveu uma frase. Ele fez seis passos.

Não é só para código de programador

Tudo o que você consegue fazer pela linha de comando o Claude Code pode ajudar a fazer: escrever documentação, rodar builds, pesquisar arquivos, estudar um assunto. O código é onde ele é mais forte, mas a pasta em que ele trabalha pode guardar qualquer projeto.

Se você ainda está decidindo se o Claude Code é a ferramenta certa para o que está fazendo, leia primeiro [Claude Code, Projetos ou Chat](https://claudetutorial.com/guides/pt-br/claude-code-projetos-ou-chat-qual-usar). Este guia parte do princípio de que você já decidiu.

## Antes de começar

Você precisa de três coisas, e nenhuma é difícil de conseguir.

- Um terminal. No Mac é o app Terminal, no Windows é o PowerShell ou o CMD, no Linux é o que você já usa.
- Uma pasta com um projeto dentro. Qualquer coisa serve na primeira sessão: um site, um script, uma pasta de documentos. Um projeto real ensina mais do que um vazio.
- Um jeito de entrar: uma assinatura Claude Pro, Max, Team ou Enterprise, uma conta do Claude Console (acesso à API com créditos pré-pagos) ou acesso por um provedor de nuvem compatível.

O Claude Code não faz parte do plano gratuito do Claude, então uma dessas contas é necessária. Se você nunca abriu um terminal, o guia oficial do terminal mostra como abrir um e colar um comando. Leva uns dois minutos.

## Passo 1: instale o Claude Code

Há várias formas de instalar. O instalador nativo é o recomendado, porque se atualiza sozinho em segundo plano.

| Seu sistema | Comando | Atualiza sozinho? |
| --- | --- | --- |
| macOS, Linux, WSL | `curl -fsSL https://claude.ai/install.sh \| bash` | Sim |
| Windows PowerShell | `irm https://claude.ai/install.ps1 \| iex` | Sim |
| Windows CMD | `curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd` | Sim |
| Homebrew (Mac) | `brew install --cask claude-code` | Não, rode `brew upgrade claude-code` |
| WinGet (Windows) | `winget install Anthropic.ClaudeCode` | Não, rode `winget upgrade Anthropic.ClaudeCode` |

Escolha a linha que corresponde ao seu sistema, cole no terminal e aperte Enter. O instalador não mostra progresso durante o download, então não ache que travou.

PowerShell e CMD não são a mesma coisa

Se o seu prompt começa com `PS C:\`, você está no PowerShell. Se mostra `C:\` sem o `PS`, está no CMD. Colar o comando do CMD no PowerShell gera o erro `The token '&&' is not a valid statement separator`. Colar o comando do PowerShell no CMD gera `'irm' is not recognized as an internal or external command`. Qualquer um dos dois erros só significa que você escolheu a linha errada.

No Linux você também pode instalar com apt, dnf ou apk no Debian, Fedora, RHEL e Alpine. No Windows nativo, o Git for Windows é recomendado para que o Claude Code possa usar a ferramenta Bash. Sem ele, o Claude Code usa o PowerShell. Se você usa o WSL, não precisa do Git for Windows.

### Confira se funcionou

Quando o instalador terminar, abra uma nova janela de terminal. Isso importa: a janela antiga ainda não conhece o programa novo. Depois rode o comando de versão.

Terminal

```
$ claude --version2.1.283 (Claude Code)
```

Qualquer número de versão seguido de (Claude Code) significa que a instalação funcionou. O seu número será diferente.

Se o seu shell disser que `claude` não foi encontrado ou não é reconhecido, a pasta de instalação ainda não está no seu PATH. Fechar e reabrir o terminal resolve na maioria das vezes. Se não resolver, a página oficial de solução de problemas de instalação liga cada mensagem de erro a uma correção.

## Passo 2: comece sua primeira sessão

Vá até a pasta do seu projeto e digite o nome do programa.

Terminal

```
$ cd ~/projects/my-website$ claude
```

Troque o caminho pela pasta do seu próprio projeto.

Na primeira vez, o Claude Code pede que você entre na conta. Com uma assinatura do Claude ou uma conta do Console, ele abre o navegador, você aprova o acesso lá e volta ao terminal. Suas credenciais ficam guardadas, então você não fará isso de novo.

Você pode entrar de qualquer um destes jeitos:

- Uma conta Claude Pro, Max, Team ou Enterprise, que é o caminho recomendado.
- Uma conta do Claude Console. Na primeira vez, um workspace "Claude Code" é criado automaticamente para você acompanhar quanto ele custa.
- Amazon Bedrock, Google Cloud ou Microsoft Foundry, para quem tem acesso fornecido pela empresa dessa forma.

Se a variável de ambiente `ANTHROPIC_API_KEY` estiver definida e você aprovar a chave quando for perguntado, o Claude Code pula a etapa de login.

Depois de entrar, você vê um prompt com a versão, o modelo atual e a pasta em que está trabalhando. Digite `/help` para listar os comandos, `/resume` para continuar uma conversa antiga ou `/login` mais tarde, se precisar trocar de conta.

Comece sempre na pasta do projeto

O Claude Code trata a pasta em que você o abriu como seu diretório de trabalho. Abra-o dentro do seu projeto, não na sua pasta pessoal, ou ele não terá nada relevante para ler.

## Passo 3: faça perguntas antes de mudar qualquer coisa

Seus primeiros prompts não devem mudar nada. Perguntas são o jeito mais seguro de ver como o Claude Code lê o seu projeto, e ensinam o que ele já sabe.

Prompt

> o que este projeto faz?

O Claude lê os arquivos de que precisa e responde. Você não adiciona arquivos à mão, ele os encontra. Continue com perguntas mais específicas, uma de cada vez:

Prompt

> quais tecnologias este projeto usa?

Prompt

> onde fica o ponto de entrada principal?

Prompt

> explique a estrutura de pastas

my-website

```
> o que este projeto faz?Lendo package.json, README.md, src/ ...É um site de marketing estático feito com Next.js. As páginas ficam em src/app, os componentes compartilhados em src/components e o conteúdo na pasta content/.
```

Um esboço de sessão. As palavras exatas e os arquivos lidos serão diferentes no seu projeto.

Você também pode perguntar ao Claude Code sobre ele mesmo. Perguntas como "o que o Claude Code consegue fazer?" ou "como criar habilidades personalizadas no Claude Code?" recebem respostas de verdade, porque ele conhece a própria documentação.

Dentro do Claude Tutorial

Perguntar antes de agir é um hábito que vale construir

Fazer o assistente explicar o que ele enxerga antes de você pedir mudanças é a mesma disciplina que o app ensina para qualquer tipo de trabalho, não só para código.

Em breve

[DISPONÍVEL NO Google Play](https://play.google.com/store/apps/details?id=com.claudetutorial.mobile)

## Passo 4: faça sua primeira mudança

Agora peça algo pequeno e fácil de desfazer.

Prompt

> adicione uma função hello world ao arquivo principal

O Claude Code encontra o arquivo certo e mostra a mudança que quer fazer. Dependendo das suas configurações, ele pode pedir sua aprovação antes. Se pedir, leia o que ele propõe e escolha **Yes**.

Esse pedido é minúsculo de propósito. O objetivo deste passo não é a função. É ver o ciclo completo uma vez: você pede, o Claude encontra o arquivo, mostra a edição, você aprova e o arquivo muda.

O que o Claude Code pode fazer sem perguntar é controlado pelo **modo de permissão** da sessão. Aperte `Shift+Tab` a qualquer momento para alternar entre os modos. As versões mais novas iniciam as sessões interativas de terminal no modo automático (auto), em que uma verificação em segundo plano bloqueia ações arriscadas em vez de perguntar sobre cada uma, e versões mais antigas ou outras configurações perguntam com mais frequência. Olhe a linha de status para ver em que modo você está. O próximo guia, [Modos de permissão e modo plan do Claude Code, explicados](https://claudetutorial.com/guides/pt-br/modos-de-permissao-e-modo-plan-do-claude-code-explicados), cobre todos os modos e quando usar cada um.

Você pode desfazer edições de arquivos

Antes de o Claude editar um arquivo, ele salva um instantâneo. Se algo der errado, aperte `Esc` duas vezes para voltar atrás, ou simplesmente peça ao Claude que desfaça a mudança. Os instantâneos cobrem só arquivos, não coisas como bancos de dados ou deploys, e funcionam junto com o git, sem substituí-lo.

## Passo 5: use o git conversando com ele

Se o seu projeto usa git, você pode operá-lo por conversa. Tudo isto funciona como está escrito.

1. Veja onde você está

   Pergunte `what files have I changed?` para receber um resumo simples do seu diretório de trabalho.
2. Salve seu trabalho

   Peça `commit my changes with a descriptive message`. O Claude lê o diff e escreve a mensagem.
3. Crie uma ramificação

   Peça `create a new branch called feature/quickstart` antes de começar algo maior, para a branch principal continuar limpa.
4. Consulte o histórico

   Peça `show me the last 5 commits` quando precisar lembrar o que aconteceu recentemente.

Mesmo quando você confia nele, leia a mensagem do commit e o diff antes de aceitar. Quem revisa tudo o que o Claude Code produz é você.

## Passo 6: corrija um bug ou adicione uma funcionalidade

Tarefas reais funcionam melhor com detalhes reais. Compare estas duas formas de pedir a mesma correção.

| Em vez de | Tente |
| --- | --- |
| `fix the bug` | `fix the login bug where users see a blank screen after entering wrong credentials` |
| `add validation` | `add input validation to the user registration form, and show an error under the field that failed` |
| `make it faster` | `the product list takes 4 seconds to load. Find out why and tell me before you change anything` |

As versões melhores dizem o sintoma, o lugar e como é o "pronto". O Claude Code encontra arquivos sozinho, então você não precisa listá-los, mas ele não adivinha qual problema você tem em mente.

Para trabalhos maiores, divida o serviço em etapas numa lista numerada.

Prompt

> 1. crie uma nova tabela no banco de dados para perfis de usuário 2. crie um endpoint de API para ler e atualizar perfis de usuário 3. monte uma página em que o usuário possa ver e editar o próprio perfil

E quando você ainda não conhece o código, deixe o Claude explorar primeiro: peça que analise o esquema do banco de dados, ou como funciona o checkout, antes de pedir que mude qualquer um dos dois. Alguns minutos de leitura costumam evitar uma mudança errada.

## Os comandos que você vai usar todo dia

Alguns comandos você roda no seu shell, antes de o Claude Code iniciar, e outros dentro de uma sessão.

| No seu shell | O que faz |
| --- | --- |
| `claude` | Inicia uma sessão interativa |
| `claude "fix the build error"` | Inicia uma sessão com um primeiro prompt já digitado |
| `claude -p "explain this function"` | Responde uma pergunta e sai |
| `claude -c` | Continua sua conversa mais recente nesta pasta |
| `claude -r` | Deixa você escolher uma conversa anterior para retomar |

| Dentro de uma sessão | O que faz |
| --- | --- |
| `/help` | Lista os comandos disponíveis |
| `/clear` | Limpa o histórico da conversa, um começo limpo para uma nova tarefa |
| `/resume` | Continua uma conversa anterior |
| `/exit` ou `Ctrl+D` duas vezes | Sai do Claude Code |

Algumas teclas economizam muito tempo. Digite `/` para ver todos os comandos e habilidades que você tem. Aperte `Tab` para completar um comando, `↑` para trazer prompts anteriores e `Shift+Tab` para alternar o modo de permissão. Aperte `Esc` para parar o Claude imediatamente se ele for na direção errada.

## Quando o primeiro dia dá errado

Estes são os problemas mais comuns e o que cada um significa.

| O que você vê | O que significa e o que fazer |
| --- | --- |
| `claude: command not found` | A pasta de instalação ainda não está no seu PATH. Abra antes uma nova janela de terminal. Se ainda falhar, veja a página oficial de solução de problemas do seu sistema. |
| `syntax error near unexpected token '<'` ou um `403` durante a instalação | O download foi bloqueado ou redirecionado, em geral por uma rede ou proxy. A página de solução de problemas lista outros métodos de instalação, como Homebrew ou WinGet. |
| Ele pede para entrar na conta toda vez | Você só deveria entrar uma vez. Rode `/login` dentro da sessão e refaça a etapa do navegador, usando sempre o mesmo tipo de conta. |
| Ele responde sobre o projeto errado | Você o abriu na pasta errada. Saia com `/exit`, vá até o seu projeto com `cd` e inicie `claude` de novo. |

Quando nada disso servir, pergunte ao próprio Claude Code. Digite algo como "como corrijo este erro?" com a mensagem colada. O comando `/doctor` também faz uma checagem da configuração e diagnostica problemas de instalação e de ajustes.

## Você não precisa usar o terminal

O terminal é a casa original do Claude Code, e tudo o que está acima vale lá. O mesmo assistente também está disponível como app de desktop, dentro do VS Code e dos editores JetBrains, na web em claude.ai/code, no Slack e em pipelines automatizados com GitHub Actions e GitLab. A interface muda como você o vê e conversa com ele. O ciclo de reunir contexto, agir e verificar é o mesmo em todo lugar.

## Perguntas frequentes

### O Claude Code é gratuito?

Não. Ele exige uma assinatura Claude Pro, Max, Team ou Enterprise, uma conta do Claude Console com créditos de API, ou acesso por um provedor de nuvem compatível. O plano gratuito do Claude não o inclui.

### Preciso saber programar para usar o Claude Code?

Você precisa de um projeto para apontá-lo, e quanto mais entender o projeto, melhor poderá julgar o trabalho dele. Não precisa escrever o código você mesmo. Quem está começando aproveita mais o hábito de perguntar primeiro do Passo 3: peça ao Claude que explique antes de pedir que mude.

### É seguro deixá-lo editar meus arquivos?

Você controla o que ele pode fazer sem perguntar pelo modo de permissão, e as edições de arquivos podem ser desfeitas com `Esc` duas vezes. Trate o resultado como o pull request de um colega: leia o diff antes de fazer o commit. Mantenha o projeto no git para que toda mudança seja fácil de revisar ou reverter.

### Qual é a diferença entre o Claude Code e o Claude no chat?

Um chat responde com texto sobre o que você cola. O Claude Code trabalha dentro do seu projeto: lê os arquivos sozinho, edita, roda comandos e confere o próprio trabalho. Use o chat para pensar, use o Claude Code para fazer.

### O Claude Code lembra do meu projeto entre as sessões?

Cada sessão começa com um contexto novo. Para levar conhecimento de uma sessão a outra, você o escreve num arquivo chamado CLAUDE.md, e o Claude Code também guarda anotações próprias sobre as suas preferências. O guia seguinte ao próximo, [CLAUDE.md explicado](https://claudetutorial.com/guides/pt-br/claude-md-explicado-ensine-seu-projeto-ao-claude-code-uma-vez), mostra como.

## Seu checklist do primeiro dia

- `claude --version` mostra um número numa janela de terminal nova
- Você abriu o `claude` de dentro da pasta do seu projeto e entrou na conta
- Você fez pelo menos três perguntas sobre o projeto antes de mudar qualquer coisa
- Você aprovou uma pequena mudança, leu a edição e sabe que `Esc` duas vezes desfaz mudanças em arquivos
- Você sabe onde a linha de status mostra o modo de permissão e como alternar com `Shift+Tab`

## Continue lendo

- [Modos de permissão e modo plan do Claude Code, explicados](https://claudetutorial.com/guides/pt-br/modos-de-permissao-e-modo-plan-do-claude-code-explicados) para decidir quanto o Claude Code pode fazer sem perguntar.
- [CLAUDE.md explicado: ensine o seu projeto ao Claude Code uma vez só](https://claudetutorial.com/guides/pt-br/claude-md-explicado-ensine-seu-projeto-ao-claude-code-uma-vez) para parar de repetir as mesmas instruções a cada sessão.
- [Boas práticas do Claude Code: hábitos que dão melhores resultados](https://claudetutorial.com/guides/pt-br/boas-praticas-do-claude-code-habitos-que-dao-melhores-resultados) para prompts, verificações e gestão de contexto.
- [Como fazer mudanças em vários arquivos com o Claude Code](https://claudetutorial.com/guides/pt-br/como-fazer-mudancas-em-varios-arquivos-com-o-claude-code) para a sua primeira mudança que toca muitos arquivos.
- [Conectando o Claude aos seus próprios dados e ferramentas com o MCP](https://claudetutorial.com/guides/pt-br/como-conectar-o-claude-aos-seus-dados-com-mcp) para ir além da sua própria pasta.