Pular para o conteúdo principal
Uma sessão de Código reúne a conversa, os resultados das ferramentas e o ambiente selecionado. Use-a para investigar um problema, orientar uma tarefa ativa e retomar o trabalho depois. Comece pelo início rápido se ainda não executou uma sessão.

Inicie e organize uma sessão

Abra Código → Nova sessão, escolha uma pasta e confira branch, modelo e permissões antes da primeira mensagem. Essa mensagem vincula o ambiente à sessão. Para trabalhar em outro ambiente de execução, crie uma sessão e escolha o destino primeiro. Dê a cada sessão um objetivo específico, como investigar um teste de checkout ou revisar uma mudança de API. Use o menu da sessão para renomear, fixar trabalhos frequentes ou arquivar o que terminou. Sessões arquivadas continuam em Arquivadas. Excluir uma sessão local remove seu histórico deste computador; leia a confirmação antes de continuar. Use Filtrar sessões, ao lado do campo de busca, para restringir a lista por Status, Projeto, Ambiente ou Quando. Um ponto marca uma sessão que terminou ou falhou enquanto você estava fora, até você abri-la, e um lápis marca uma sessão com um rascunho não enviado. Clique no cabeçalho de um projeto para recolher o grupo; Arquivadas começa recolhido. Para agir sobre várias sessões de uma vez, clique nelas com Shift ou Cmd (Ctrl no Windows e no Linux) e depois fixe, arquive ou exclua todas pela barra de seleção. As conversas aceitam a mesma seleção para exclusão. O menu … de um projeto permite fixá-lo, iniciar uma nova sessão na pasta, arquivar suas sessões ou removê-lo da barra lateral. Remover um projeto apenas o oculta neste computador; nenhuma sessão ou arquivo é excluído. Uma conversa nova não cria outra cópia do repositório. Se duas tarefas precisarem editar o projeto de forma independente, use worktrees separados.

Adicione contexto do projeto

Mencione caminhos de arquivos com @ ou anexe a saída do teste que falhou. O campo de mensagem aceita seleção de arquivos, arrastar e soltar e anexos colados, incluindo especificações e capturas de tela. O envio de imagens exige um modelo que aceite esse tipo de entrada.

Faça uma solicitação verificável

Inclua comportamento observado, resultado esperado e como verificá-lo. Nomes de arquivos e saída do erro ajudam o agente a começar pelo código relevante:
O checkout retorna 12 para três itens com preço 12. Leia @checkout.js e @checkout.test.js. Adicione um teste que falhe esperando total 36, corrija o cálculo e execute npm test. Preserve a assinatura pública da função.
Selecione o item correto nas sugestões de @ antes de enviar. Anexe um design ou captura quando a aparência importar e explique a região relevante. Alguns documentos exigem uma skill; o aplicativo avisa quando ela está inativa. Na miniatura da captura, abra a opção de marcação da imagem para destacar um controle ou região. Revise o resultado e escolha Aplicar. A imagem marcada substitui o anexo dessa mensagem.

Acompanhe uma tarefa em execução

A linha do tempo registra as respostas e a atividade das ferramentas durante a tarefa. Cada cartão mostra uma ação e seu resultado: leitura de arquivo, execução de comando ou resposta de um serviço conectado. No exemplo da compra, examine primeiro a falha do teste e compare-a com o resultado após a mudança no cálculo. Clique no cartão para expandir o comando e sua saída. Quando o aplicativo pedir aprovação, examine a ação proposta antes de aprová-la ou negá-la. Responda às perguntas do agente na sessão e envie novas instruções se precisar mudar o rumo da tarefa. O envio de mensagens durante uma execução segue Ajustes → Compositor → Mensagem durante uma execução. Enfileirar guarda a mensagem até a execução terminar. Interromper a entrega na próxima interação com o modelo, permitindo mudar a ação seguinte do agente. Para encerrar a execução ativa, escolha Cancelar a execução. Quando um turno termina, o compositor pode sugerir, em texto esmaecido, a mensagem que você provavelmente enviará a seguir. Pressione Tab para aceitá-la e envie como de costume; digitar qualquer outra coisa a oculta. Ative ou desative as sugestões em Ajustes → Compositor → Sugerir um próximo prompt.

Enfileire, redirecione ou pare

Use Enfileirar quando a mensagem depender do resultado atual, como um resumo após os testes. Use Interromper para mudar a próxima ação, por exemplo corrigindo um nome de arquivo ou reduzindo o escopo. A interrupção chega na próxima interação com o modelo; confira na linha do tempo o que já foi executado. Para alterar uma mensagem que você enfileirou pelo compositor, use os botões abaixo dela antes do envio: Editar mensagem a devolve ao compositor, que precisa estar vazio, e Remover da fila a exclui. Pressionar Up em um compositor vazio também recupera a última mensagem da fila. Cancelar para o turno ativo. Depois, confira as alterações da sessão para saber quais edições permaneceram e decidir como continuar. Cancelar não reverte arquivos pelo Git.

Faça uma pergunta paralela

Para perguntar sobre uma sessão local sem interrompê-la, escolha Conversa paralela no cabeçalho da sessão ou pressione Cmd + Shift + A (Ctrl + Shift + A no Windows e no Linux). Você também pode digitar /ask seguido da pergunta no compositor principal, ou selecionar um trecho da sessão, clicar com o botão direito e escolher Perguntar sobre isto. A conversa paralela lê a conversa da sessão e pode ler arquivos, mas não edita arquivos nem executa comandos. Nada nela chega ao agente, a menos que você copie uma resposta para o compositor principal e a envie. Fechar uma conversa paralela a exclui.

Retome um trabalho anterior

Para retomar um trabalho, use Buscar sessões para localizar uma sessão pelo nome ou pelo texto da conversa. Selecione-a para reabrir a conversa e continuar no ambiente salvo. Use Buscar nesta sessão para encontrar um resultado em um histórico longo. Para guardar uma cópia fora do aplicativo, abra o menu de uma sessão ou conversa na barra lateral e escolha Exportar como Markdown… ou Copiar como Markdown. Para a sessão ou conversa aberta, pressione Cmd + Shift + S (Ctrl + Shift + S no Windows e no Linux). Arquivo → Importar de Markdown… lê uma exportação de volta: uma conversa se torna uma conversa que você pode continuar, e uma sessão abre como um novo rascunho, com a exportação anexada.

Retome uma decisão

Fixe uma mensagem útil e abra Fixados para encontrá-la depois. Para explorar outra abordagem, escolha Ramificar a partir daqui em uma resposta depois que a execução terminar. Isso copia a conversa até aquele ponto para uma nova sessão e mantém a original inalterada. Isso ramifica a discussão; use uma branch Git ou worktree se os arquivos também precisarem de isolamento. Reiniciar a partir desta mensagem e a opção de editar e reiniciar substituem a conversa posterior. A confirmação pode oferecer restaurar arquivos alterados desde aquele ponto. Confira a lista: manter a transcrição, substituir mensagens e restaurar arquivos são operações diferentes.

A busca encontra sessões anteriores para retomar a conversa e consultar seus resultados.

Entenda o uso de contexto

O indicador de contexto mostra quanto da janela de contexto do modelo está em uso. Quando Compactar sessão está disponível, a ação resume o histórico anterior para liberar espaço; a transcrição original permanece na sessão. Abra o indicador para examinar os detalhes. Os totais de solicitações e tokens do gateway aparecem separadamente em Consumo.

Use conversas junto com a programação

Mude para Conversas para discutir uma abordagem ou pedir explicações a um modelo. Use Código para trabalhar em um projeto selecionado com ferramentas de arquivos e comandos. Em Conversas, as respostas aparecem à medida que são geradas e o histórico fica armazenado localmente. Você pode renomear conversas, interromper uma resposta ou gerar novamente a última resposta. Conversas e Código aceitam ditado. Grave sua solicitação pelo microfone ao lado do campo de mensagem e revise a transcrição antes de enviar. Continue com Planejamento e permissões.