Tutorial do Claude Code: sua primeira sessão real

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.

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

Perguntas frequentes

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.