Claude Code: Primeiro Uso do Claude Code

Última atualização: 2026-08-31

Usar o Claude Code pela primeira vez é como contratar um assistente poderoso — você precisa saber como dar instruções, confirmar operações e corrigir o rumo.

💡 Dica: Para o primeiro uso, pratique em um projeto simples. O Claude Code modifica arquivos; embora as alterações possam ser revertidas, construir hábitos seguros é importante.

📋 Pré-requisitos: Capítulo 3 - Configuração de API e Seleção de Modelo

1. O Que Você Vai Aprender


2. Iniciando Sua Primeira Sessão

(1) Preparação

BASH
# 1. Criar um projeto de prática
mkdir my-first-claude && cd my-first-claude
git init

# 2. Criar um arquivo simples
echo 'function hello() { return "Hello"; }' > index.js

# 3. Iniciar Claude Code
claude

(2) Interface Interativa

TEXT 📖 Somente leitura
╭─────────────────────────────────────────╮
│  Claude Code                             │
│  Model: claude-sonnet-4-20250514         │
│  Project: my-first-claude                │
╰─────────────────────────────────────────╯

> █ (digite sua instrução)

▶ Exemplo 1: Primeira Conversa

TEXT 📖 Somente leitura
> Hello, please look at this project

Claude: Let me check the project structure and file contents...

  📁 Project structure:
  - index.js

  📄 index.js:
  ```javascript
  function hello() { return "Hello"; }

This is a simple JavaScript project with just one hello function.

Add a goodbye function and unit tests

Claude: I'll add a goodbye function and test file.

→ Reading index.js → Modifying index.js (adding goodbye function) → Creating index.test.js → Running: npm test ✅ 2 tests passed

Done:


---

## 3. Mecanismo de Confirmação de Operações

### (1) Fluxo de Aprovação de Permissões

O Claude Code solicita confirmação para operações sensíveis:

| Tipo de Operação | Comportamento Padrão | Exemplo |
|:----------------|:--------------------|:--------|
| **Ler arquivo** | Executar automaticamente | Ler index.js |
| **Criar arquivo** | Solicitar confirmação | Criar novo arquivo test.js |
| **Modificar arquivo** | Solicitar confirmação | Modificar arquivo existente |
| **Executar comando** | Solicitar confirmação | Executar npm test |
| **Deletar arquivo** | Solicitar confirmação | Deletar arquivo antigo |

### (2) Opções de Confirmação

```text
Claude wants to edit index.js:
  - Add goodbye() function after hello()
  - Add module.exports

  Allow? (y/n/a/e)
  y = yes (desta vez)
  n = no
  a = always allow edits to this file
  e = edit the change before applying

▶ Exemplo 2: Lidando com Confirmações de Permissão

TEXT 📖 Somente leitura
> Refactor project to TypeScript

Claude: I'll perform the following:
  1. Create tsconfig.json
  2. Convert index.js to index.ts
  3. Add type definitions
  4. Update package.json

  Allow creating tsconfig.json? [y/n/a/e] y
  ✅ Created tsconfig.json

  Allow editing index.js → index.ts? [y/n/a/e] a
  ✅ Always allowing edits to index.ts

  Allow running: npm install typescript --save-dev? [y/n/a/e] y
  ✅ Installed typescript

  All changes applied successfully!

4. Visualizando e Revertendo Alterações

(1) Visualizar Alterações

BASH
# Ver alterações de arquivos da sessão atual
claude /diff

# Ver git diff
git diff

# Ver alterações de arquivo específico
git diff index.js

(2) Reverter Operações

BASH
# Reverter todas as alterações (baseado em git)
git checkout .
git clean -fd

# Reverter arquivo único
git checkout -- index.js

# Ver histórico de alterações
git log --oneline -5

▶ Exemplo 3: Revertendo Operações Erradas

TEXT 📖 Somente leitura
> Rename all functions

Claude: Renaming functions...
  → hello → greet
  → goodbye → farewell
  → Modified 3 files

# Alice percebe que a renomeação não corresponde às expectativas
# Usa git para reverter

$ git diff --stat
  index.js       | 6 +++---
  index.test.js  | 8 ++++----
  utils.js       | 4 ++--

$ git checkout .
# All changes reverted ✓

5. Melhores Práticas para o Primeiro Uso

(1) Checklist de Hábitos Seguros

Hábito Motivo Prática
git init primeiro Fácil reverter Gerencie todo projeto com git
Commits pequenos Reduzir perda na reversão Commit após cada funcionalidade
Ler confirmações Evitar erros Não aperte y cegamente
Usar /diff Entender alterações Verificar após operações grandes
Evitar produção Reduzir risco Praticar em projetos de teste primeiro

(2) Dicas para Descrição de Tarefas

TEXT 📖 Somente leitura
# Descrição ruim
> Help me change some code

# Boa descrição
> In src/auth/jwt.ts, add token refresh logic,
> set expiry to 7 days, write corresponding unit tests

# Descrição melhor (com restrições)
> Refactor UserService query methods:
> 1. Use Repository pattern instead of direct SQL
> 2. Add pagination support (default 20 per page)
> 3. Write integration tests
> 4. Don't modify the interface signatures

6. Exemplo Completo: Primeira Experiência Completa

BASH
# Primeira experiência da Alice com Claude Code

# 1. Preparar projeto
mkdir todo-app && cd todo-app
git init
npm init -y

# 2. Iniciar Claude Code
claude "Create a simple Node.js TODO app:
1. Support add, delete, list tasks
2. Store data in JSON file
3. Include complete unit tests
4. Use ES Module syntax"

# Processo de trabalho do Claude Code:
# → Reading package.json
# → Creating src/todo.js (core TODO logic)
# → Creating src/storage.js (JSON file storage)
# → Creating src/index.js (CLI entry)
# → Creating tests/todo.test.js (unit tests)
# → Running: npm test → 8/8 passed ✓
# → Creating README.md

# 3. Verificar resultados
git add -A && git commit -m "feat: initial todo app by Claude Code"

# 4. Adicionar mais requisitos
claude "Add task priority feature (high/medium/low), update tests"

# Claude Code continua iterando...

❓ Perguntas Frequentes

P: Primeiro lançamento é lento, o que fazer? R: O primeiro lançamento carrega contexto do projeto; projetos grandes podem levar 10-30 segundos. Interações subsequentes são mais rápidas.

P: Apertei confirmação errada, e agora? R: Imediatamente use git checkout . para reverter, ou diga ao Claude Code "revert the last change".

P: O Claude Code quebrou meu código, o que fazer? R: Para isso serve o git. git diff para ver alterações, git checkout . para reverter. Sempre use sob gerenciamento do git.

P: Toda confirmação é chato, pode ser automático? R: Sim. Escolha a (always allow) para arquivos específicos, ou configure políticas de permissão no CLAUDE.md.

P: Posso desfazer as alterações de uma sessão inteira? R: Sim. Se você tinha um git commit antes da sessão, git reset --soft HEAD~1 reverte ao estado pré-sessão.

P: Como fazer o Claude Code mais obediente? R: Seja específico com as instruções. Declare claramente o que fazer, o que não fazer e restrições. Instruções vagas geram resultados vagos.


📖 Resumo


📝 Exercícios

  1. Básico (⭐): Crie um projeto vazio, use o Claude Code para gerar um app Hello World, confirme que funciona.
  2. Intermediário (⭐⭐): Faça o Claude Code adicionar uma funcionalidade, depois use /diff para ver alterações, reverta manualmente a modificação de um arquivo.
  3. Avançado (⭐⭐⭐): Dê ao Claude Code uma instrução vaga e uma precisa, compare diferenças nos resultados, resuma melhores práticas para descrição de tarefas.
Web-Tutorial.com

Equipe Técnica Web-Tutorial

Uma plataforma de tutoriais mantida por diversos desenvolvedores. Cada tutorial é escrito e revisado por profissionais da área correspondente. Trabalhamos para manter nosso conteúdo preciso e confiável — se encontrar algum problema, avise-nos.

100%