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.
📋 Pré-requisitos: Capítulo 3 - Configuração de API e Seleção de Modelo
1. O Que Você Vai Aprender
- Iniciando o Claude Code em um projeto
- Formas de dar instruções de tarefas
- Confirmação de operações e aprovação de permissões
- Visualização e reversão de alterações
- Melhores práticas para o primeiro uso
2. Iniciando Sua Primeira Sessão
(1) Preparação
# 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
╭─────────────────────────────────────────╮
│ Claude Code │
│ Model: claude-sonnet-4-20250514 │
│ Project: my-first-claude │
╰─────────────────────────────────────────╯
> █ (digite sua instrução)
▶ Exemplo 1: Primeira Conversa
> 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:
- Added goodbye() function in index.js
- Created index.test.js with 2 test cases
- All tests passing
---
## 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
> 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
# 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
# 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
> 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
# 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
# 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 diffpara 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~1reverte 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
- Execute
claudeno diretório do projeto para iniciar; recomenda-se usar git para gerenciamento do projeto - Modificações de arquivos e execução de comandos precisam de confirmação; escolha
apara aprovação automática - Use
/diffegit diffpara ver alterações,git checkout .para reverter - Descrições de tarefas devem ser específicas: o quê + restrições + resultado esperado
- Pratique em projetos simples primeiro, construa hábitos seguros
📝 Exercícios
- Básico (⭐): Crie um projeto vazio, use o Claude Code para gerar um app Hello World, confirme que funciona.
- Intermediário (⭐⭐): Faça o Claude Code adicionar uma funcionalidade, depois use
/diffpara ver alterações, reverta manualmente a modificação de um arquivo. - 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.