O rastreamento de tarefas fornece uma maneira estruturada de gerenciar tarefas e exibir progresso aos usuários. O Claude Code SDK inclui funcionalidade de tarefas integrada que ajuda a organizar fluxos de trabalho complexos e manter os usuários informados sobre a progressão das tarefas.

​
Ciclo de Vida das Tarefas

As tarefas seguem um ciclo de vida previsível:
  1. Criadas como pending quando as tarefas são identificadas
  2. Ativadas para in_progress quando o trabalho começa
  3. Concluídas quando a tarefa termina com sucesso
  4. Removidas quando todas as tarefas em um grupo são concluídas

​
Quando as Tarefas São Usadas

O SDK cria automaticamente tarefas para:
  • Tarefas complexas de múltiplas etapas que requerem 3 ou mais ações distintas
  • Listas de tarefas fornecidas pelo usuário quando múltiplos itens são mencionados
  • Operações não triviais que se beneficiam do rastreamento de progresso
  • Solicitações explícitas quando os usuários pedem organização de tarefas

​
Exemplos

​
Monitorando Mudanças nas Tarefas

import { query } from "@anthropic-ai/claude-code";

for await (const message of query({
  prompt: "Otimize o desempenho do meu app React e rastreie o progresso com tarefas",
  options: { maxTurns: 15 }
})) {
  // Atualizações de tarefas são refletidas no fluxo de mensagens
  if (message.type === "tool_use" && message.name === "TodoWrite") {
    const todos = message.input.todos;
    
    console.log("Atualização do Status das Tarefas:");
    todos.forEach((todo, index) => {
      const status = todo.status === "completed" ? "✅" : 
                    todo.status === "in_progress" ? "🔧" : "❌";
      console.log(`${index + 1}. ${status} ${todo.content}`);
    });
  }
}

​
Exibição de Progresso em Tempo Real

import { query } from "@anthropic-ai/claude-code";

class TodoTracker {
  private todos: any[] = [];
  
  displayProgress() {
    if (this.todos.length === 0) return;
    
    const completed = this.todos.filter(t => t.status === "completed").length;
    const inProgress = this.todos.filter(t => t.status === "in_progress").length;
    const total = this.todos.length;
    
    console.log(`\nProgresso: ${completed}/${total} concluídas`);
    console.log(`Atualmente trabalhando em: ${inProgress} tarefa(s)\n`);
    
    this.todos.forEach((todo, index) => {
      const icon = todo.status === "completed" ? "✅" : 
                  todo.status === "in_progress" ? "🔧" : "❌";
      const text = todo.status === "in_progress" ? todo.activeForm : todo.content;
      console.log(`${index + 1}. ${icon} ${text}`);
    });
  }
  
  async trackQuery(prompt: string) {
    for await (const message of query({
      prompt,
      options: { maxTurns: 20 }
    })) {
      if (message.type === "tool_use" && message.name === "TodoWrite") {
        this.todos = message.input.todos;
        this.displayProgress();
      }
    }
  }
}

// Uso
const tracker = new TodoTracker();
await tracker.trackQuery("Construa um sistema de autenticação completo com tarefas");

​
Documentação Relacionada