Fluxos de trabalho comuns - Claude Code Docs

Esta página aborda fluxos de trabalho práticos para desenvolvimento cotidiano: explorar código desconhecido, depuração, refatoração, escrita de testes, criação de PRs e gerenciamento de sessões. Cada seção inclui exemplos de prompts que você pode adaptar aos seus próprios projetos. Para padrões e dicas de nível superior, consulte Melhores práticas.

Entender novas bases de código

Obter uma visão geral rápida da base de código

Suponha que você acabou de ingressar em um novo projeto e precisa entender sua estrutura rapidamente.

Navegue até o diretório raiz do projeto

cd /path/to/project

Inicie Claude Code

claude

Peça uma visão geral de alto nível

give me an overview of this codebase

Aprofunde-se em componentes específicos

explain the main architecture patterns used here

what are the key data models?

how is authentication handled?

Dicas:

Comece com perguntas amplas e depois estreite para áreas específicas
Pergunte sobre convenções de codificação e padrões usados no projeto
Solicite um glossário de termos específicos do projeto

Encontrar código relevante

Suponha que você precise localizar código relacionado a um recurso ou funcionalidade específica.

Peça ao Claude para encontrar arquivos relevantes

find the files that handle user authentication

Obtenha contexto sobre como os componentes interagem

how do these authentication files work together?

Entenda o fluxo de execução

trace the login process from front-end to database

Dicas:

Seja específico sobre o que você está procurando
Use linguagem de domínio do projeto
Instale um plugin de inteligência de código para sua linguagem para dar ao Claude navegação precisa de “ir para definição” e “encontrar referências”

Corrigir bugs com eficiência

Suponha que você tenha encontrado uma mensagem de erro e precise encontrar e corrigir sua origem.

Compartilhe o erro com Claude

I'm seeing an error when I run npm test

Peça recomendações de correção

suggest a few ways to fix the @ts-ignore in user.ts

Aplique a correção

update user.ts to add the null check you suggested

Dicas:

Diga ao Claude o comando para reproduzir o problema e obtenha um rastreamento de pilha
Mencione quaisquer etapas para reproduzir o erro
Deixe Claude saber se o erro é intermitente ou consistente

Refatorar código

Suponha que você precise atualizar código antigo para usar padrões e práticas modernas.

Identifique código legado para refatoração

find deprecated API usage in our codebase

Obtenha recomendações de refatoração

suggest how to refactor utils.js to use modern JavaScript features

Aplique as alterações com segurança

refactor utils.js to use ES2024 features while maintaining the same behavior

Verifique a refatoração

run tests for the refactored code

Dicas:

Peça ao Claude para explicar os benefícios da abordagem moderna
Solicite que as alterações mantenham compatibilidade com versões anteriores quando necessário
Faça refatoração em pequenos incrementos testáveis

Usar subagents especializados

Suponha que você queira usar subagents de IA especializados para lidar com tarefas específicas de forma mais eficaz.

Visualize subagents disponíveis

/agents

Isso mostra todos os subagents disponíveis e permite que você crie novos.

Use subagents automaticamente

Claude Code delega automaticamente tarefas apropriadas para subagents especializados:

review my recent code changes for security issues

run all tests and fix any failures

Solicite explicitamente subagents específicos

use the code-reviewer subagent to check the auth module

have the debugger subagent investigate why users can't log in

Crie subagents personalizados para seu fluxo de trabalho

/agents

Em seguida, selecione “Create New subagent” e siga os prompts para definir:

Um identificador único que descreve o propósito do subagent (por exemplo, code-reviewer, api-designer).
Quando Claude deve usar este agente
Quais ferramentas ele pode acessar
Um prompt do sistema descrevendo o papel e comportamento do agente

Dicas:

Crie subagents específicos do projeto em .claude/agents/ para compartilhamento em equipe
Use campos description descritivos para permitir delegação automática
Limite o acesso a ferramentas ao que cada subagent realmente precisa
Consulte a documentação de subagents para exemplos detalhados

Usar Plan Mode para análise segura de código

Plan Mode instrui Claude a criar um plano analisando a base de código com operações somente leitura, perfeito para explorar bases de código, planejar alterações complexas ou revisar código com segurança. Em Plan Mode, Claude usa AskUserQuestion para reunir requisitos e esclarecer seus objetivos antes de propor um plano.

Quando usar Plan Mode

Implementação multi-etapa: Quando seu recurso requer fazer edições em muitos arquivos
Exploração de código: Quando você quer pesquisar a base de código completamente antes de alterar qualquer coisa
Desenvolvimento interativo: Quando você quer iterar na direção com Claude

Como usar Plan Mode

Ative Plan Mode durante uma sessão Você pode mudar para Plan Mode durante uma sessão usando Shift+Tab para percorrer os modos de permissão. Se você estiver em Normal Mode, Shift+Tab primeiro muda para Auto-Accept Mode, indicado por ⏵⏵ accept edits on na parte inferior do terminal. Um Shift+Tab subsequente mudará para Plan Mode, indicado por ⏸ plan mode on. Inicie uma nova sessão em Plan Mode Para iniciar uma nova sessão em Plan Mode, use a flag --permission-mode plan:

claude --permission-mode plan

Execute consultas “headless” em Plan Mode Você também pode executar uma consulta em Plan Mode diretamente com -p (ou seja, em “modo headless”):

claude --permission-mode plan -p "Analyze the authentication system and suggest improvements"

Exemplo: Planejando uma refatoração complexa

claude --permission-mode plan

I need to refactor our authentication system to use OAuth2. Create a detailed migration plan.

Claude analisa a implementação atual e cria um plano abrangente. Refine com acompanhamentos:

What about backward compatibility?

How should we handle database migration?

Pressione Ctrl+G para abrir o plano em seu editor de texto padrão, onde você pode editá-lo diretamente antes de Claude prosseguir.

Configure Plan Mode como padrão

// .claude/settings.json
{
  "permissions": {
    "defaultMode": "plan"
  }
}

Consulte a documentação de configurações para mais opções de configuração.

Trabalhar com testes

Suponha que você precise adicionar testes para código não coberto.

Identifique código não testado

find functions in NotificationsService.swift that are not covered by tests

Gere scaffolding de teste

add tests for the notification service

Adicione casos de teste significativos

add test cases for edge conditions in the notification service

Execute e verifique os testes

run the new tests and fix any failures

Claude pode gerar testes que seguem os padrões e convenções existentes do seu projeto. Ao solicitar testes, seja específico sobre qual comportamento você quer verificar. Claude examina seus arquivos de teste existentes para corresponder ao estilo, frameworks e padrões de asserção já em uso. Para cobertura abrangente, peça ao Claude para identificar casos extremos que você pode ter perdido. Claude pode analisar seus caminhos de código e sugerir testes para condições de erro, valores de limite e entradas inesperadas que são fáceis de negligenciar.

Criar pull requests

Você pode criar pull requests pedindo ao Claude diretamente (“create a pr for my changes”), ou guiar Claude através disso passo a passo:

Resuma suas alterações

summarize the changes I've made to the authentication module

Gere uma pull request

create a pr

Revise e refine

enhance the PR description with more context about the security improvements

Quando você cria uma PR usando gh pr create, a sessão é automaticamente vinculada a essa PR. Você pode retomá-la mais tarde com claude --from-pr <number>.

Revise a PR gerada por Claude antes de enviar e peça ao Claude para destacar riscos ou considerações potenciais.

Lidar com documentação

Suponha que você precise adicionar ou atualizar documentação para seu código.

Identifique código não documentado

find functions without proper JSDoc comments in the auth module

Gere documentação

add JSDoc comments to the undocumented functions in auth.js

Revise e melhore

improve the generated documentation with more context and examples

Verifique a documentação

check if the documentation follows our project standards

Dicas:

Especifique o estilo de documentação que você deseja (JSDoc, docstrings, etc.)
Peça por exemplos na documentação
Solicite documentação para APIs públicas, interfaces e lógica complexa

Trabalhar com imagens

Suponha que você precise trabalhar com imagens em sua base de código e queira ajuda do Claude para analisar o conteúdo da imagem.

Adicione uma imagem à conversa

Você pode usar qualquer um destes métodos:

Arraste e solte uma imagem na janela do Claude Code
Copie uma imagem e cole-a no CLI com ctrl+v (Não use cmd+v)
Forneça um caminho de imagem ao Claude. Por exemplo, “Analyze this image: /path/to/your/image.png”

Peça ao Claude para analisar a imagem

What does this image show?

Describe the UI elements in this screenshot

Are there any problematic elements in this diagram?

Use imagens para contexto

Here's a screenshot of the error. What's causing it?

This is our current database schema. How should we modify it for the new feature?

Obtenha sugestões de código do conteúdo visual

Generate CSS to match this design mockup

What HTML structure would recreate this component?

Dicas:

Use imagens quando descrições de texto seriam pouco claras ou complicadas
Inclua capturas de tela de erros, designs de UI ou diagramas para melhor contexto
Você pode trabalhar com múltiplas imagens em uma conversa
A análise de imagem funciona com diagramas, capturas de tela, mockups e muito mais
Quando Claude referencia imagens (por exemplo, [Image #1]), Cmd+Click (Mac) ou Ctrl+Click (Windows/Linux) o link para abrir a imagem em seu visualizador padrão

Referenciar arquivos e diretórios

Use @ para incluir rapidamente arquivos ou diretórios sem esperar que Claude os leia.

Referencie um único arquivo

Explain the logic in @src/utils/auth.js

Isso inclui o conteúdo completo do arquivo na conversa.

Referencie um diretório

What's the structure of @src/components?

Isso fornece uma listagem de diretório com informações de arquivo.

Referencie recursos MCP

Show me the data from @github:repos/owner/repo/issues

Isso busca dados de servidores MCP conectados usando o formato @server:resource. Consulte recursos MCP para detalhes.

Dicas:

Os caminhos de arquivo podem ser relativos ou absolutos
Referências de arquivo @ adicionam CLAUDE.md no diretório do arquivo e diretórios pai ao contexto
Referências de diretório mostram listagens de arquivo, não conteúdos
Você pode referenciar múltiplos arquivos em uma única mensagem (por exemplo, “@file1.js and @file2.js”)

Usar pensamento estendido (thinking mode)

Pensamento estendido é ativado por padrão, dando ao Claude espaço para raciocinar através de problemas complexos passo a passo antes de responder. Este raciocínio é visível em modo verboso, que você pode ativar com Ctrl+O. Além disso, Opus 4.6 e Sonnet 4.6 suportam raciocínio adaptativo: em vez de um orçamento de token de pensamento fixo, o modelo aloca dinamicamente pensamento com base em sua configuração de nível de esforço. Pensamento estendido e raciocínio adaptativo trabalham juntos para lhe dar controle sobre o quão profundamente Claude raciocina antes de responder. Pensamento estendido é particularmente valioso para decisões arquitetônicas complexas, bugs desafiadores, planejamento de implementação multi-etapa e avaliação de compensações entre diferentes abordagens.

Frases como “think”, “think hard” e “think more” são interpretadas como instruções de prompt regulares e não alocam tokens de pensamento.

Configurar thinking mode

Pensamento é ativado por padrão, mas você pode ajustá-lo ou desativá-lo.

Escopo	Como configurar	Detalhes
Nível de esforço	Execute `/effort`, ajuste em `/model`, ou defina `CLAUDE_CODE_EFFORT_LEVEL`	Controle a profundidade de pensamento para Opus 4.6 e Sonnet 4.6. Consulte Ajustar nível de esforço
Palavra-chave `ultrathink`	Inclua “ultrathink” em qualquer lugar em seu prompt	Define esforço para alto para esse turno em Opus 4.6 e Sonnet 4.6. Útil para tarefas únicas que requerem raciocínio profundo sem alterar permanentemente sua configuração de esforço
Atalho de alternância	Pressione `Option+T` (macOS) ou `Alt+T` (Windows/Linux)	Alterne pensamento ligado/desligado para a sessão atual (todos os modelos). Pode exigir configuração de terminal para ativar atalhos de tecla Option
Padrão global	Use `/config` para alternar thinking mode	Define seu padrão em todos os projetos (todos os modelos). Salvo como `alwaysThinkingEnabled` em `~/.claude/settings.json`
Limitar orçamento de token	Defina a variável de ambiente `MAX_THINKING_TOKENS`	Limite o orçamento de pensamento para um número específico de tokens (ignorado em Opus 4.6 e Sonnet 4.6 a menos que definido como 0). Exemplo: `export MAX_THINKING_TOKENS=10000`

Para visualizar o processo de pensamento do Claude, pressione Ctrl+O para alternar o modo verboso e veja o raciocínio interno exibido como texto em itálico cinzento.

Como funciona o pensamento estendido

Pensamento estendido controla quanto raciocínio interno Claude realiza antes de responder. Mais pensamento fornece mais espaço para explorar soluções, analisar casos extremos e autocorrigir erros. Com Opus 4.6 e Sonnet 4.6, pensamento usa raciocínio adaptativo: o modelo aloca dinamicamente tokens de pensamento com base no nível de esforço que você seleciona. Esta é a forma recomendada de ajustar a compensação entre velocidade e profundidade de raciocínio. Com modelos mais antigos, pensamento usa um orçamento fixo de até 31.999 tokens do seu orçamento de saída. Você pode limitar isso com a variável de ambiente MAX_THINKING_TOKENS, ou desativar pensamento inteiramente via /config ou a alternância Option+T/Alt+T. MAX_THINKING_TOKENS é ignorado em Opus 4.6 e Sonnet 4.6, já que raciocínio adaptativo controla a profundidade de pensamento. A única exceção: definir MAX_THINKING_TOKENS=0 ainda desativa pensamento inteiramente em qualquer modelo. Para desativar pensamento adaptativo e reverter para o orçamento de pensamento fixo, defina CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING=1. Consulte variáveis de ambiente.

Você é cobrado por todos os tokens de pensamento usados, mesmo que modelos Claude 4 mostrem pensamento resumido

Retomar conversas anteriores

Ao iniciar Claude Code, você pode retomar uma sessão anterior:

claude --continue continua a conversa mais recente no diretório atual
claude --resume abre um seletor de conversa ou retoma por nome
claude --from-pr 123 retoma sessões vinculadas a uma pull request específica

De dentro de uma sessão ativa, use /resume para mudar para uma conversa diferente. As sessões são armazenadas por diretório de projeto. O seletor /resume mostra sessões do mesmo repositório git, incluindo worktrees.

Nomeie suas sessões

Dê nomes descritivos às sessões para encontrá-las mais tarde. Esta é uma prática recomendada ao trabalhar em múltiplas tarefas ou recursos.

Nomeie a sessão

Nomeie uma sessão na inicialização com -n:

claude -n auth-refactor

Ou use /rename durante uma sessão, que também mostra o nome na barra de prompt:

/rename auth-refactor

Você também pode renomear qualquer sessão do seletor: execute /resume, navegue até uma sessão e pressione R.

Retome por nome mais tarde

Da linha de comando:

claude --resume auth-refactor

Ou de dentro de uma sessão ativa:

/resume auth-refactor

Use o seletor de sessão

O comando /resume (ou claude --resume sem argumentos) abre um seletor de sessão interativo com estes recursos: Atalhos de teclado no seletor:

Atalho	Ação
`↑` / `↓`	Navegue entre sessões
`→` / `←`	Expanda ou recolha sessões agrupadas
`Enter`	Selecione e retome a sessão destacada
`P`	Visualize o conteúdo da sessão
`R`	Renomeie a sessão destacada
`/`	Pesquise para filtrar sessões
`A`	Alterne entre diretório atual e todos os projetos
`B`	Filtre para sessões do seu branch git atual
`Esc`	Saia do seletor ou modo de pesquisa

Organização de sessão: O seletor exibe sessões com metadados úteis:

Nome da sessão ou prompt inicial
Tempo decorrido desde a última atividade
Contagem de mensagens
Branch git (se aplicável)

Sessões bifurcadas (criadas com /rewind ou --fork-session) são agrupadas sob sua sessão raiz, facilitando encontrar conversas relacionadas.

Dicas:

Nomeie sessões cedo: Use /rename ao iniciar trabalho em uma tarefa distinta—é muito mais fácil encontrar “payment-integration” do que “explain this function” mais tarde
Use --continue para acesso rápido à sua conversa mais recente no diretório atual
Use --resume session-name quando você sabe qual sessão precisa
Use --resume (sem um nome) quando você precisa navegar e selecionar
Para scripts, use claude --continue --print "prompt" para retomar em modo não interativo
Pressione P no seletor para visualizar uma sessão antes de retomá-la
A conversa retomada começa com o mesmo modelo e configuração do original

Como funciona:

Armazenamento de Conversa: Todas as conversas são automaticamente salvas localmente com seu histórico de mensagens completo
Desserialização de Mensagem: Ao retomar, todo o histórico de mensagens é restaurado para manter contexto
Estado de Ferramenta: O uso de ferramenta e resultados da conversa anterior são preservados
Restauração de Contexto: A conversa retoma com todo o contexto anterior intacto

Executar sessões paralelas de Claude Code com Git worktrees

Ao trabalhar em múltiplas tarefas ao mesmo tempo, você precisa que cada sessão do Claude tenha sua própria cópia da base de código para que as alterações não colidam. Git worktrees resolvem isso criando diretórios de trabalho separados que cada um tem seus próprios arquivos e branch, enquanto compartilham o mesmo histórico de repositório e conexões remotas. Isso significa que você pode ter Claude trabalhando em um recurso em um worktree enquanto corrige um bug em outro, sem que nenhuma sessão interfira com a outra. Use a flag --worktree (-w) para criar um worktree isolado e iniciar Claude nele. O valor que você passa se torna o nome do diretório worktree e nome do branch:

# Inicie Claude em um worktree nomeado "feature-auth"
# Cria .claude/worktrees/feature-auth/ com um novo branch
claude --worktree feature-auth

# Inicie outra sessão em um worktree separado
claude --worktree bugfix-123

Se você omitir o nome, Claude gera um automaticamente:

# Auto-gera um nome como "bright-running-fox"
claude --worktree

Worktrees são criados em <repo>/.claude/worktrees/<name> e fazem branch a partir do branch remoto padrão. O branch worktree é nomeado worktree-<name>. Você também pode pedir ao Claude para “work in a worktree” ou “start a worktree” durante uma sessão, e ele criará um automaticamente.

Worktrees de subagent

Subagents também podem usar isolamento de worktree para trabalhar em paralelo sem conflitos. Peça ao Claude para “use worktrees for your agents” ou configure em um subagent personalizado adicionando isolation: worktree ao frontmatter do agente. Cada subagent obtém seu próprio worktree que é automaticamente limpo quando o subagent termina sem alterações.

Limpeza de worktree

Quando você sai de uma sessão de worktree, Claude lida com limpeza com base em se você fez alterações:

Sem alterações: o worktree e seu branch são removidos automaticamente
Alterações ou commits existem: Claude o solicita para manter ou remover o worktree. Manter preserva o diretório e branch para que você possa retornar mais tarde. Remover exclui o diretório worktree e seu branch, descartando todas as alterações não confirmadas e commits

Para limpar worktrees fora de uma sessão do Claude, use gerenciamento manual de worktree.

Adicione .claude/worktrees/ ao seu .gitignore para evitar que o conteúdo do worktree apareça como arquivos não rastreados em seu repositório principal.

Gerenciar worktrees manualmente

Para mais controle sobre localização de worktree e configuração de branch, crie worktrees com Git diretamente. Isso é útil quando você precisa fazer checkout de um branch existente específico ou colocar o worktree fora do repositório.

# Crie um worktree com um novo branch
git worktree add ../project-feature-a -b feature-a

# Crie um worktree com um branch existente
git worktree add ../project-bugfix bugfix-123

# Inicie Claude no worktree
cd ../project-feature-a && claude

# Limpe quando terminar
git worktree list
git worktree remove ../project-feature-a

Saiba mais na documentação oficial de Git worktree.

Lembre-se de inicializar seu ambiente de desenvolvimento em cada novo worktree de acordo com seu projeto. Dependendo de sua stack, isso pode incluir executar instalação de dependência (npm install, yarn), configurar ambientes virtuais ou seguir o processo de configuração padrão do seu projeto.

Controle de versão não-git

Isolamento de worktree funciona com git por padrão. Para outros sistemas de controle de versão como SVN, Perforce ou Mercurial, configure hooks WorktreeCreate e WorktreeRemove para fornecer lógica personalizada de criação e limpeza de worktree. Quando configurados, esses hooks substituem o comportamento padrão do git quando você usa --worktree. Para coordenação automatizada de sessões paralelas com tarefas compartilhadas e mensagens, consulte equipes de agentes.

Obtenha notificações quando Claude precisa de sua atenção

Quando você inicia uma tarefa de longa duração e muda para outra janela, você pode configurar notificações de desktop para saber quando Claude termina ou precisa de sua entrada. Isso usa o evento de hook Notification hook event, que dispara sempre que Claude está esperando permissão, ocioso e pronto para um novo prompt, ou completando autenticação.

Adicione o hook às suas configurações

Abra ~/.claude/settings.json e adicione um hook Notification que chama o comando de notificação nativa da sua plataforma:

macOS
Linux
Windows

{
  "hooks": {
    "Notification": [
      {
        "matcher": "",
        "hooks": [
          {
            "type": "command",
            "command": "osascript -e 'display notification \"Claude Code needs your attention\" with title \"Claude Code\"'"
          }
        ]
      }
    ]
  }
}

{
  "hooks": {
    "Notification": [
      {
        "matcher": "",
        "hooks": [
          {
            "type": "command",
            "command": "notify-send 'Claude Code' 'Claude Code needs your attention'"
          }
        ]
      }
    ]
  }
}

{
  "hooks": {
    "Notification": [
      {
        "matcher": "",
        "hooks": [
          {
            "type": "command",
            "command": "powershell.exe -Command \"[System.Reflection.Assembly]::LoadWithPartialName('System.Windows.Forms'); [System.Windows.Forms.MessageBox]::Show('Claude Code needs your attention', 'Claude Code')\""
          }
        ]
      }
    ]
  }
}

Se seu arquivo de configurações já tiver uma chave hooks, mescle a entrada Notification nela em vez de sobrescrever. Você também pode pedir ao Claude para escrever o hook para você descrevendo o que você quer no CLI.

Opcionalmente, estreite o matcher

Por padrão, o hook dispara em todos os tipos de notificação. Para disparar apenas para eventos específicos, defina o campo matcher para um destes valores:

Matcher	Dispara quando
`permission_prompt`	Claude precisa que você aprove um uso de ferramenta
`idle_prompt`	Claude terminou e está esperando seu próximo prompt
`auth_success`	Autenticação completa
`elicitation_dialog`	Claude está fazendo uma pergunta

Verifique o hook

Digite /hooks e selecione Notification para confirmar que o hook aparece. Selecioná-lo mostra o comando que será executado. Para testá-lo de ponta a ponta, peça ao Claude para executar um comando que requer permissão e mude para longe do terminal, ou peça ao Claude para disparar uma notificação diretamente.

Para o esquema de evento completo e tipos de notificação, consulte a referência de Notificação.

Usar Claude como um utilitário estilo unix

Adicione Claude ao seu processo de verificação

Suponha que você queira usar Claude Code como um linter ou revisor de código. Adicione Claude ao seu script de compilação:

// package.json
{
    ...
    "scripts": {
        ...
        "lint:claude": "claude -p 'you are a linter. please look at the changes vs. main and report any issues related to typos. report the filename and line number on one line, and a description of the issue on the second line. do not return any other text.'"
    }
}

Dicas:

Use Claude para revisão de código automatizada em seu pipeline CI/CD
Personalize o prompt para verificar problemas específicos relevantes ao seu projeto
Considere criar múltiplos scripts para diferentes tipos de verificação

Pipe in, pipe out

Suponha que você queira canalizar dados para Claude e obter dados de volta em um formato estruturado. Canalize dados através do Claude:

cat build-error.txt | claude -p 'concisely explain the root cause of this build error' > output.txt

Dicas:

Use pipes para integrar Claude em scripts shell existentes
Combine com outras ferramentas Unix para fluxos de trabalho poderosos
Considere usar —output-format para saída estruturada

Controlar formato de saída

Suponha que você precise da saída do Claude em um formato específico, especialmente ao integrar Claude Code em scripts ou outras ferramentas.

Use formato de texto (padrão)

cat data.txt | claude -p 'summarize this data' --output-format text > summary.txt

Isso produz apenas a resposta de texto simples do Claude (comportamento padrão).

Use formato JSON

cat code.py | claude -p 'analyze this code for bugs' --output-format json > analysis.json

Isso produz um array JSON de mensagens com metadados incluindo custo e duração.

Use formato JSON de streaming

cat log.txt | claude -p 'parse this log file for errors' --output-format stream-json

Isso produz uma série de objetos JSON em tempo real conforme Claude processa a solicitação. Cada mensagem é um objeto JSON válido, mas a saída inteira não é JSON válido se concatenado.

Dicas:

Use --output-format text para integrações simples onde você apenas precisa da resposta do Claude
Use --output-format json quando você precisa do log de conversa completo
Use --output-format stream-json para saída em tempo real de cada turno de conversa

Pergunte ao Claude sobre suas capacidades

Claude tem acesso integrado à sua documentação e pode responder perguntas sobre seus próprios recursos e limitações.

Perguntas de exemplo

can Claude Code create pull requests?

how does Claude Code handle permissions?

what skills are available?

how do I use MCP with Claude Code?

how do I configure Claude Code for Amazon Bedrock?

what are the limitations of Claude Code?

Claude fornece respostas baseadas em documentação para essas perguntas. Para exemplos executáveis e demonstrações práticas, consulte as seções de fluxo de trabalho específicas acima.

Dicas:

Claude sempre tem acesso à documentação mais recente do Claude Code, independentemente da versão que você está usando
Faça perguntas específicas para obter respostas detalhadas
Claude pode explicar recursos complexos como integração MCP, configurações empresariais e fluxos de trabalho avançados

Próximos passos

Melhores práticas

Padrões para aproveitar ao máximo Claude Code

Como Claude Code funciona

Entenda o loop agentic e gerenciamento de contexto

Estender Claude Code

Adicione skills, hooks, MCP, subagents e plugins

Implementação de referência

Clone nossa implementação de referência de contêiner de desenvolvimento

Primeiros passos

Conceitos principais

Usar Claude Code

Plataformas e integrações

​Entender novas bases de código

​Obter uma visão geral rápida da base de código

​Encontrar código relevante

​Corrigir bugs com eficiência

​Refatorar código

​Usar subagents especializados

​Usar Plan Mode para análise segura de código

​Quando usar Plan Mode

​Como usar Plan Mode

​Exemplo: Planejando uma refatoração complexa

​Configure Plan Mode como padrão

​Trabalhar com testes

​Criar pull requests

​Lidar com documentação

​Trabalhar com imagens

​Referenciar arquivos e diretórios

​Usar pensamento estendido (thinking mode)

​Configurar thinking mode

​Como funciona o pensamento estendido

​Retomar conversas anteriores

​Nomeie suas sessões

​Use o seletor de sessão

​Executar sessões paralelas de Claude Code com Git worktrees

​Worktrees de subagent

​Limpeza de worktree

​Gerenciar worktrees manualmente

​Controle de versão não-git

​Obtenha notificações quando Claude precisa de sua atenção

​Usar Claude como um utilitário estilo unix

​Adicione Claude ao seu processo de verificação

​Pipe in, pipe out

​Controlar formato de saída

​Pergunte ao Claude sobre suas capacidades

​Perguntas de exemplo

​Próximos passos

Melhores práticas

Como Claude Code funciona

Estender Claude Code

Implementação de referência

Entender novas bases de código

Obter uma visão geral rápida da base de código

Encontrar código relevante

Corrigir bugs com eficiência

Refatorar código

Usar subagents especializados

Usar Plan Mode para análise segura de código

Quando usar Plan Mode

Como usar Plan Mode

Exemplo: Planejando uma refatoração complexa

Configure Plan Mode como padrão

Trabalhar com testes

Criar pull requests

Lidar com documentação

Trabalhar com imagens

Referenciar arquivos e diretórios

Usar pensamento estendido (thinking mode)

Configurar thinking mode

Como funciona o pensamento estendido

Retomar conversas anteriores

Nomeie suas sessões

Use o seletor de sessão

Executar sessões paralelas de Claude Code com Git worktrees

Worktrees de subagent

Limpeza de worktree

Gerenciar worktrees manualmente

Controle de versão não-git

Obtenha notificações quando Claude precisa de sua atenção

Usar Claude como um utilitário estilo unix

Adicione Claude ao seu processo de verificação

Pipe in, pipe out

Controlar formato de saída

Pergunte ao Claude sobre suas capacidades

Perguntas de exemplo

Próximos passos