Source: https://aiprimetech.io/pt/claude-code/tutorial/

[Início](/pt/) › [Claude Code](/pt/claude-code/) › Tutorial

[Visão geral](/pt/claude-code/)[Instalação](/pt/claude-code/install/)[referência da CLI](/pt/claude-code/cli/)[Preços e limites](/pt/claude-code/pricing/)[Agent SDK](/pt/claude-code/sdk/)[Skills e plugins](/pt/claude-code/skills/)[GitHub](/pt/claude-code/github/)[Web, desktop e IDE](/pt/claude-code/web-and-desktop/)[Modelos](/pt/claude-code/models/)[Erros](/pt/claude-code/errors/)[Código aberto?](/pt/claude-code/open-source/)[Tutorial](/pt/claude-code/tutorial/)[Para estudantes](/pt/claude-code/for-students/)[Automação de QA](/pt/claude-code/qa-automation/)[vs Cursor](/pt/claude-code/vs-cursor/)[vs Codex e OpenCode](/pt/claude-code/vs-codex/)[Subagentes](/pt/claude-code/subagents/)[Hooks](/pt/claude-code/hooks/)[MCP](/pt/claude-code/mcp/)[Ecossistema](/pt/claude-code/ecosystem/)[VS Code](/pt/claude-code/vscode/)[OpenRouter](/pt/claude-code/openrouter/)[Limites de requisições](/pt/claude-code/rate-limits/)[Guia em chinês](/claude-code/zh/)

Última atualização: 11 de outubro de 2026

# Tutorial do Claude Code: sua primeira sessão real

Esta é a sessão que você deve realizar uma vez, com atenção, para que todas as sessões seguintes sejam rápidas. Trinta minutos, um repositório real, e você terá os hábitos que distinguem quem adora o Claude Code de quem o considera caro e imprevisível.

## TLDR
- Comece com /init — um bom CLAUDE.md é o arquivo de maior impacto no repositório.
- Planeje antes de editar: peça um plano, aprove-o e então deixe o agente executá-lo.
- Mantenha as permissões restritas, compacte com frequência e use o modelo mais barato que dê conta da tarefa.

## 1. Abra o projeto e escreva o arquivo de memória 

```
cd your-project
claude
/init
```

/init inspeciona o repositório e cria um rascunho de CLAUDE.md: como compilar, como testar, convenções e o que não deve ser alterado. Edite-o. Todas as sessões futuras o leem primeiro, e é por isso que ele se paga em um dia — o agente deixa de redescobrir seu projeto a cada vez. 

## 2. Modo de planejamento: peça um plano, não uma alteração 

O Claude Code tem um modo de planejamento integrado: pressione Shift+Tab para alternar o modo de permissão até aparecer plan, ou inicie com claude --permission-mode plan, e o agente poderá ler e pensar, mas não editar nem executar nada até você voltar ao modo anterior. É a maneira mais segura de explorar uma base de código desconhecida e a mais econômica de iniciar uma grande alteração. 

```
> Plan how to add rate limiting to the /api/upload route. Don't edit anything yet.
```

Leia o plano. Corrija-o em linguagem simples. Depois: go ahead. Planejar e depois executar produz alterações melhores e sessões mais econômicas do que deixar o agente explorar fazendo edições. 

## 3. Deixe o agente executar os testes 

Diga como executar os testes (ou deixe que CLAUDE.md explique) e peça que o agente os execute após a alteração. O ciclo — editar, testar, ler a falha, corrigir — é onde o agente se destaca. Observe as solicitações de permissão: cada uma é uma oportunidade de delimitar o que ele pode fazer. 

## 4. Permissões 

```
/permissions
```

Permita leitura e edição livremente, autorize comandos seguros específicos (Bash(npm test), Bash(git diff *)) e mantenha qualquer ação destrutiva condicionada à confirmação. Em scripts, configure o mesmo conjunto com --allowedTools. 

## 5. Compacte quando o assunto mudar 

```
/compact focus on the rate limiter; drop the earlier exploration
```

Contexto é custo. Cada turno reenvia tudo o que veio antes. Compacte a cada mudança de direção e /clear entre tarefas sem relação entre si — esse único hábito reduz pela metade a conta da maioria das pessoas. 

## 6. Escolha o modelo para cada etapa 

Use a categoria Sonnet por padrão. Para aquela decisão realmente difícil, /model para Opus, tome a decisão e volte ao modelo anterior. O guia de modelos explica as categorias e como fixá-las. 

## 7. Faça o commit e revise 

```
> Commit this as a single change with a message that explains the rate limit values.
```

Peça que o agente faça o commit e depois leia o diff por conta própria. O agente é um engenheiro júnior rápido e incansável, com uma excelente memória do seu CLAUDE.md — revise o resultado dele como revisaria o trabalho de um profissional desse nível. 

## Próximos passos 
- Habilidades — ensine os procedimentos da sua equipe uma única vez.
- Subagentes (/agents) — divida tarefas grandes entre agentes especializados.
- Servidores MCP (/mcp) — dê ao agente acesso ao seu banco de dados, navegador e sistema de acompanhamento de tickets.
- A GitHub Action — o mesmo ciclo em cada pull request.
- Preços — e como deixar de acompanhar o medidor de uso com um plano de preço fixo.

## Experimente gratuitamente primeiro

Novas contas recebem $5 em crédito gratuito para a API com o código CLAUDECODE — suficiente para uma noite de Claude Code com Sonnet — e depois créditos com 7.69231× o valor nominal.

```
export ANTHROPIC_BASE_URL=https://aiprimetech.io
export ANTHROPIC_API_KEY=your_key
```

[Crie uma conta com o código CLAUDECODE](/register?promo=CLAUDECODE)

## Perguntas frequentes

O que é CLAUDE.md?

O arquivo de memória do projeto que o Claude Code lê no início de cada sessão: comandos de compilação e teste, convenções e limites. /init cria o rascunho; você o mantém atualizado.O que é o modo de planejamento no Claude Code?

Pedir um plano sem edições, aprová-lo e depois executá-lo. Isso produz alterações melhores e sessões mais curtas e econômicas do que editar de forma exploratória.Como faço o Claude Code parar de pedir permissão toda vez?

Use /permissions para aprovar previamente ferramentas e comandos seguros, ou --allowedTools em scripts. Mantenha comandos destrutivos condicionados à confirmação.

## Execute o Claude Code no gateway

Os mesmos modelos, duas variáveis de ambiente, créditos com 7.69231× o valor nominal — ou um plano ilimitado com preço fixo. Novas contas: $5 em crédito gratuito para a API com o código CLAUDECODE.[Obter uma chave de API](/register?promo=CLAUDECODE) [Ver planos ilimitados](/pt/plans/)

A AI Prime Tech é um gateway de API independente e não é afiliada, endossada nem patrocinada pela Anthropic. “Claude” e “Claude Code” são marcas comerciais da Anthropic. Os recursos do Claude Code descritos aqui seguem a documentação pública da Anthropic no momento da redação e mudam com frequência; os preços e as listas de modelos nesta página são obtidos das configurações atuais deste gateway.

## Mais guias do Claude Code

[Claude Code: o guia completo](/pt/claude-code/)[Como instalar o Claude Code](/pt/claude-code/install/)[Documentação da CLI do Claude Code: comandos e flags](/pt/claude-code/cli/)[Preços e limites do Claude Code, explicados](/pt/claude-code/pricing/)[O SDK do Claude Code, agora Claude Agent SDK](/pt/claude-code/sdk/)[Skills e plugins do Claude Code](/pt/claude-code/skills/)[Claude Code no GitHub: o App, a Action e @claude](/pt/claude-code/github/)[O Claude Code tem uma interface web? Entenda as versões web, desktop e para IDE](/pt/claude-code/web-and-desktop/)[Qual modelo o Claude Code usa e como alterá-lo](/pt/claude-code/models/)[Erros do Claude Code e como corrigi-los](/pt/claude-code/errors/)[O Claude Code é de código aberto?](/pt/claude-code/open-source/)[Claude para estudantes: Claude Code, a API e o que você realmente ganha na área de educação](/pt/claude-code/for-students/)[Como usar o Claude Code para automação de QA](/pt/claude-code/qa-automation/)[Claude Code vs Cursor: qual usar, quando — e como usar ambos](/pt/claude-code/vs-cursor/)[Claude Code vs Codex vs OpenCode: comparação dos agentes de terminal](/pt/claude-code/vs-codex/)[Subagentes do Claude Code: como funcionam, como defini-los e equipes de agentes](/pt/claude-code/subagents/)[Hooks do Claude Code: controle determinístico sobre o que o agente faz](/pt/claude-code/hooks/)[MCP no Claude Code: conexão de servidores, escopos, MCP remoto e exemplos reais](/pt/claude-code/mcp/)[O ecossistema do Claude Code: roteadores, frameworks, plugins e as listas que os acompanham](/pt/claude-code/ecosystem/)[Claude Code no VS Code: a extensão, o uso pelo terminal e os erros](/pt/claude-code/vscode/)[Como usar o OpenRouter no Claude Code (e quando não usar)](/pt/claude-code/openrouter/)[Erro de limite de taxa do Claude: o que significa "Erro de API: limite de taxa atingido" e como corrigir](/pt/claude-code/rate-limits/)[Como usar o Claude Code: da instalação ao uso diário](/claude-code/zh/)