Verificamos o comando de instalação do Claude Code e as condições de conta de acordo com o sistema operacional e iniciamos a primeira sessão em uma pasta fictícia de prática. Em vez de gerar código imediatamente, fazemos apenas três perguntas para ler a pasta e o CSV no modo plan e depois encerramos a sessão com segurança.
Para quem éUsuários de Windows, macOS, Linux ou WSL que estão instalando o Claude Code pela primeira vez e querem praticar leitura e perguntas antes de modificar arquivos
O Claude Code não deve ser explicado supondo que seu uso seja gratuito. A documentação oficial usada como referência para este artigo apresenta como caminhos de conta uma assinatura Claude Pro, Max, Team ou Enterprise, créditos pré-pagos de API no Claude Console ou um provedor de nuvem compatível. Antes de instalar, verifique na documentação oficial e na tela real da conta qual dessas opções se aplica. Este artigo não inventa preços nem números de versão específicos.
| Item de preparação | O que verificar | Escolha neste artigo |
|---|---|---|
| Conta | O caminho aplicável entre assinatura Claude compatível, Console ou provedor de nuvem | Não presumir que seja gratuito |
| Pasta de prática | Separada da pasta de trabalho real | Usar vibe-expenses |
| Dados | Arquivo fictício sem dados pessoais | Usar expenses.csv |
| Permissões | No início, priorizar leitura e planejamento em vez de modificação | Recomenda-se o modo plan |
No Windows nativo, recomenda-se instalar Git for Windows. Se ele não estiver instalado, o Claude Code pode usar PowerShell como ferramenta de shell. O uso do Git será abordado no artigo 6, então aqui nos concentramos apenas no ambiente de instalação e na primeira sessão.
O comando recomendado de instalação nativa varia conforme o sistema operacional. Antes de copiar os comandos abaixo, verifique qual shell e qual sistema operacional você usa. A documentação oficial informa que a instalação nativa usa atualizações automáticas em segundo plano, enquanto as instalações via Homebrew e WinGet não são atualizadas automaticamente.
# macOS · Linux · WSL
curl -fsSL https://claude.ai/install.sh | bash# Windows PowerShell
irm https://claude.ai/install.ps1 | iexWindows CMD:
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd
Homebrew:
brew install --cask claude-code
WinGet:
winget install Anthropic.ClaudeCodeÉ melhor usar os comandos de instalação exatamente como aparecem na documentação oficial e não misturá-los com scripts modificados arbitrariamente encontrados na internet. Antes de executar, verifique novamente na documentação oficial se os requisitos atuais ou os ambientes compatíveis de cada método de instalação mudaram.
Depois da instalação, abra um novo terminal e verifique com `claude --version`. Segundo a documentação oficial, são exibidos o número da versão e “(Claude Code)”. Como o número da versão pode mudar com o tempo, este artigo não fixa um número específico.
claude --versionSe aparecer uma mensagem dizendo que o comando não foi encontrado, em vez de adivinhar um caminho, revise novamente a etapa de instalação e a orientação de solução de problemas da documentação oficial. Como este texto não executou o Claude Code de fato, não afirma ter reproduzido uma tela específica de erro ou sucesso.
É mais seguro não fazer a primeira execução diretamente em uma pasta de pesquisa ou em um repositório de trabalho, mas criar uma pasta de prática vazia. Aqui usamos apenas uma pasta chamada vibe-expenses e o expenses.csv fictício. Depois de criar a pasta, salve o conteúdo CSV definido no artigo anterior.
mkdir vibe-expenses
cd vibe-expensesdate,category,amount
2026-09-01,food,12000
2026-09-03,transport,1450
2026-09-03,food,8500
2026-09-10,supplies,3200
2026-09-15,transport,1450
2026-10-02,food,9800Salve o arquivo em UTF-8. Nesta etapa, não criamos summarize.py. O objetivo da primeira sessão não é “fazer a IA programar imediatamente”, mas praticar a leitura e a explicação da pasta atual antes de o usuário decidir o que será alterado.
O Claude Code pode ser iniciado com `claude` dentro da pasta do projeto e, na primeira execução, pode abrir o login no navegador. Para iniciantes, porém, recomendamos começar no modo plan em vez de iniciar diretamente em um fluxo que permita modificar arquivos. O modo plan é um modo de permissões voltado à leitura para revisar análises e planos e pode ser iniciado pela linha de comando da seguinte forma.
claude --permission-mode planNa primeira execução, pode aparecer o processo de login pelo navegador. Se precisar trocar de conta, você pode usar `/login` dentro da sessão. O modo de permissões padrão pode variar conforme a conta e o ambiente, por isso este artigo não afirma que “é sempre Manual”. Segundo a documentação oficial consultada em 2026-09-22, o modo inicial padrão do terminal interativo nos planos Pro, Max e Team é auto, enquanto nos outros planos é Manual.
[Exemplo editorial · não é uma resposta real]
Na primeira execução, podem aparecer orientações sobre login no navegador ou permissões. O texto e a ordem reais da tela podem variar conforme o momento da instalação e a conta, então confira a tela atual e a documentação oficial.Quando a sessão começar, não peça imediatamente “crie o programa”. Primeiro, verifique até que ponto a ferramenta entende corretamente a pasta atual. O Claude Code pode ler sozinho os arquivos de que precisa e pode solicitar aprovação antes de modificar arquivos ou executar comandos. Nesta prática, não pedimos nenhuma modificação; fazemos apenas perguntas.
Diga quais arquivos existem nesta pasta. Não modifique nenhum arquivo.
Explique os nomes das colunas de expenses.csv e o que cada uma parece significar. Não modifique nenhum arquivo.
Se você fosse criar uma ferramenta para calcular o total mensal de amount com este CSV, resuma em três pontos o que deveria ser verificado antes da implementação. Ainda não escreva código.Na resposta, verifique pelo menos se o nome do arquivo atual e as colunas do CSV não foram interpretados incorretamente. Se a IA mencionar um arquivo que não existe ou sugerir uma modificação ou instalação não solicitada, pergunte primeiro o motivo. Como a redação da resposta real do Claude Code pode variar conforme o modelo e o momento, este artigo não inventa um diálogo correto para apresentá-lo como saída real.
| Pergunta | Ponto principal a verificar | Se houver problema |
|---|---|---|
| O que há na pasta? | Reconhece expenses.csv como um arquivo real | Se mencionar arquivo inexistente, pedir novamente a base da listagem |
| Quais são as colunas do CSV? | Lê corretamente date, category, amount | Se adivinhar nomes de colunas, comparar com o original |
| O que verificar antes de implementar? | Confirma primeiro entrada, saída e restrições | Se tentar modificar logo, pedir apenas o plano |
Se o objetivo da primeira sessão foi alcançado, encerre sem criar código. Na sessão, você pode usar `/exit` e também encerrar pressionando Ctrl+D duas vezes. `/help` mostra a lista de comandos; há também comandos como `/clear`, `/resume`, `/compact` e `/rewind`, mas neste artigo apenas confirmamos os nomes das funções e não ampliamos o trabalho.
/exitNo próximo artigo, usaremos os requisitos definidos e esta pasta de prática para criar summarize.py de fato. Nesse momento, colocaremos em uma única solicitação o exemplo de entrada, a saída esperada e a restrição de usar apenas a biblioteca padrão, e executaremos separadamente o código Python gerado para verificar o resultado.
Redigido com base na documentação oficial do Claude Code (consultada em 2026-09-22) · Claude Code não foi executado de fato · Não há código Python para executar
Neste artigo, o Claude Code não foi instalado nem executado de fato. Os comandos de instalação e as descrições de recursos seguem a documentação oficial do Claude Code consultada em 2026-09-22; no momento da instalação real, os ambientes compatíveis, as condições da conta e os textos da interface devem ser verificados novamente na documentação oficial.