Como Claude Code e Codex podem ajudar um ao outro no PandaNPC?

Este artigo foi escrito pela equipe PandaNpc e apresenta formas de uso em seu próprio produto.

Ver PNG da capa em tamanho original (1920×1080)

Nota sobre as imagens: As opções de mecanismo abaixo vêm de uma interface real do produto em inglês; os cards de tarefa, respostas de exemplo e subagentes da barra lateral usam componentes reais do PandaNpc e dados de demonstração, apenas para mostrar posição e aparência. Desta vez, não houve conexão real entre os dois mecanismos, envio de tarefas nem verificação de ret de resultados.

Claude Code e Codex podem ajudar ao outro no mesmo projeto do PandaNpc. Você explica em uma conversa quem deve fazer o quê, e o outro pode receber a tarefa; quando terminar, o resultado volta para a conversa original. A seguir, vamos percorrer “pedir ao Codex para revisar as alterações do Claude Code” e “pedir ao Claude Code para ajudar o Codex a resolver um problema”.

Primeiro passo: conecte os dois primeiro

Abra a página Agent do PandaNpc e confirme que a lista de conexões mostra seu Claude Code e seu Codex e que o computador que vai executar o trabalho está online. Se não houver conexão, use “Adicionar conexão” ou “Nova conexão” na página e siga as instruções para conectá-los.

Quando os dois forem lidar com o mesmo projeto, confirme também que ambos conseguem abrir esse projeto. Se as conexões estiverem em computadores diferentes, primeiro faça com que o computador de destino também consiga acessar os arquivos do projeto; o fato de dois nomes aparecerem na lista de conversas não significa que os dois computadores tenham os mesmos arquivos.

Figura: Ao selecionar o mecanismo, Claude Code e Codex ficam visíveis. O que é mostrado aqui são opções; isso não significa que as duas conexões estejam online. Ver PNG em tamanho original (603 × 250)

Segundo passo: peça ao Codex para revisar na conversa do Claude Code

Abra a conversa do Claude Code no projeto e primeiro informe os limites da tarefa. Você pode copiar esta mensagem diretamente e substituir o conteúdo entre colchetes pelo seu projeto:

Peça ao Codex conectado para revisar de forma independente [o projeto ou esta alteração]. Concentre-se em erros de lógica, casos de borda esquecidos e pontos que possam afetar funcionalidades existentes. Apenas faça a revisão, sem modificar arquivos; envie as descobertas, os arquivos correspondentes e as sugestões de alteração de volta para esta conversa. Se não encontrar uma conexão do Codex que consiga acessar o projeto, avise-me primeiro.

Figura: Aparência do card de tarefa entregue ao Codex na conversa do Claude Code. Dados de demonstração; nenhuma tarefa foi realmente enviada. Ver PNG em tamanho original (1032 × 108)

Quando a conexão estiver disponível, o Claude Code pode selecionar sua conexão do Codex e entregar a tarefa. Depois que o Codex terminar, o resultado da revisão volta para a conversa do Claude Code. Você pode pedir ao Claude Code para decidir o próximo passo com base nas descobertas, ou abrir a subconversa do Codex para ver o processo.

Figura: Aparência de exemplo quando a conclusão da revisão volta para a conversa principal. Dados de demonstração; não é uma verificação real de retorno de resultados. Ver PNG em tamanho original (1032 × 191)

Se você quiser que o Codex faça alterações diretamente, troque “apenas faça a revisão, sem modificar arquivos” por um escopo de alteração claro, por exemplo, “altere apenas a mensagem de erro do formulário de login e informe quais arquivos foram modificados”. Quanto mais específica a tarefa, mais fácil será verificar o resultado.

Terceiro passo: peça ajuda ao Claude Code na conversa do Codex

O contrário também vale. Abra a conversa do Codex no mesmo projeto e explique claramente o que você quer que o Claude Code resolva. Por exemplo:

Peça ao Claude Code conectado para verificar [o problema específico]. Primeiro encontre a causa e depois dê sugestões de correção; por enquanto, não modifique arquivos. Quando terminar, envie a conclusão e os arquivos envolvidos de volta para esta conversa. Se a conexão de destino não puder acessar este projeto, avise-me primeiro.

Figura: Exemplo do componente de card de tarefa quando o Codex pede ajuda ao Claude Code. Dados de demonstração; a conversa principal do Codex não foi realmente conectada. Ver PNG em tamanho original (1032 × 108)

Se você precisar que ele faça alterações de verdade, pode trocar por:

Peça ao Claude Code conectado para corrigir [o problema específico], alterando apenas [os arquivos ou funcionalidades permitidos]. Quando terminar, explique as mudanças, a validação e os pontos que ainda precisam da minha confirmação, e envie o resultado de volta para esta conversa.

Figura: Aparência de exemplo da conclusão do Claude Code aparecendo na conversa principal. Dados de demonstração; não é uma verificação real de retorno de resultados. Ver PNG em tamanho original (1032 × 191)

Isso não é enviar a mesma mensagem para os dois ao mesmo tempo. A conversa atual é responsável por organizar; o outro faz o trabalho na própria subconversa e, ao terminar, reporta de volta para a conversa atual.

Quarto passo: acompanhe o progresso, veja o resultado e continue fazendo solicitações

Depois de enviar a tarefa, a subconversa aparecerá na área de subagentes da conversa relacionada. Você pode clicá-la para ver o que ela está fazendo; mesmo que saia temporariamente da página atual, ao voltar você poderá conferir. Quando terminar, primeiro leia o resultado que voltou para a conversa original e depois verifique os arquivos e as alterações reais mencionados por ele.

Figura: Localização da entrada e do status do subagente na barra lateral. Dados de demonstração; a revisão do Codex não foi realmente executada. Ver PNG em tamanho original (760 × 210)

Se o resultado ainda não for suficiente, continue dizendo diretamente na conversa original:

Entregue a tarefa anterior à mesma pessoa para continuar: complemente [os problemas omitidos mantenha o contexto anterior da tarefa e me diga o resultado quando terminar.

O mesmo subagente pode continuar o trabalho a partir da conversa anterior. Se a rodada anterior ainda estiver em execução, espere que ela termine antes de perguntar novamente. Se demorar para responder, primeiro verifique o status e o resultado da subconversa; não envie uma tarefa idêntica de novo só porque a página ainda não mostrou uma resposta.

Quando é adequado usar isso?

Um uso comum é “uma pessoa altera, a outra revisa”: por exemplo, o Claude Code conclui uma correção e você pede ao Codex para procurar omissões sob outra perspectiva; também é possível pedir ao Codex para escrever código e ao Claude Code para verificar em relação aos requisitos. Você também pode distribuir trabalhos diferentes entre os dois, mas deve indicar os arquivos de responsabilidade de cada um para evitar que alterem o mesmo ponto ao mesmo tempo.

Lembre-se de dois limites: a outra parte precisa conseguir usar o projeto de destino; depois de receber uma tarefa de alteração, o subagente pode operar diretamente os arquivos no diretório de destino. Portanto, ao enviar a tarefa, é melhor especificar o projeto, o escopo da tarefa, se alterações são permitidas e como você quer que ele relate o resultado. A conclusão da revisão também precisa ser avaliada por você em conjunto com as alterações reais; não basta olhar apenas para a palavra “concluído”.

FAQ

Só o Claude Code está conectado; posso pedir ajuda ao Codex diretamente?

É preciso ter primeiro uma conexão do Codex disponível. O contrário também vale.

Eles ainda podem se ajudar se estiverem em computadores diferentes?

É possível enviar tarefas para a conexão em outro computador, mas o computador de destino precisa conseguir acessar o projeto que será tratado. Antes de enviar a tarefa, confirme que ele está vendo os arquivos corretos.

Depois que o subagente terminar, preciso trocar de conversa para encontrar a resposta?

Normalmente não. O resultado volta para a conversa original que iniciou a tarefa; se quiser ver detalhes, abra a subconversa.

Posso especificar que o outro apenas revise, sem alterar arquivos?

Você pode escrever claramente na tarefa “apenas faça a revisão, sem modificar arquivos”. Também é recomendável especificar o escopo da revisão e o resultado que você espera receber.