Início rápido

O aplicativo desktop funciona no macOS, Windows e Linux. Código abre uma sessão vinculada a uma pasta de projeto e a um ambiente de execução, com ferramentas de arquivos e comandos disponíveis para o agente. Conversas abre uma conversa com um modelo. Cada sessão de Código mantém seu próprio histórico, para que você possa consultar a investigação e os resultados das ferramentas depois.

Antes de começar

Instale o aplicativo desktop e conecte sua conta. Escolha um projeto com dependências e ferramentas de teste já instaladas. Use um projeto local neste passo a passo.

Este passo a passo começa com uma pergunta de leitura e acompanha um erro de quantidades por teste de regressão, correção e revisão Git. Use o exemplo executável ou adapte arquivos e comandos ao seu repositório. A resposta e a sequência de ferramentas podem variar; confira os resultados reais. Nomes de arquivos e código mantêm o idioma original.

Prepare um exemplo pequeno

Use seu repositório ou crie uma pasta vazia checkout-example com os três arquivos abaixo. O exemplo usa o executor de testes integrado do Node.js e não precisa de pacotes externos. O cálculo ignora quantidade de propósito para você acompanhar uma falha real até a correção.

Arquivos do projeto de exemplo

{
  "name": "checkout-example",
  "private": true,
  "type": "module",
  "scripts": {
    "test": "node --test"
  }
}

export function calculateTotal(items) {
  return items.reduce((total, item) => total + item.price, 0);
}

import test from 'node:test';
import assert from 'node:assert/strict';
import { calculateTotal } from './checkout.js';

test('one unit costs 12', () => {
  assert.equal(calculateTotal([{ price: 12, quantity: 1 }]), 12);
});

Em um terminal aberto nessa pasta, execute:

Bash

npm test

O teste inicial deve passar porque só cobre uma unidade. Crie um README.md com “Este exemplo calcula totais de checkout. Execute npm test para rodar os testes.” A primeira solicitação usa esse README. Para a revisão Git, inicialize a pasta como repositório e faça commit dos arquivos iniciais, ou use um repositório existente em que possa conferir o diff. Este exemplo mínimo não tem página web. A verificação no navegador dos outros guias se aplica ao seu próprio projeto web.

Escolha o projeto e o modelo

Uma sessão de Código precisa de uma pasta de projeto, um modelo e um modo de permissão. A pasta define o projeto em que o agente trabalha; o gateway fornece os modelos disponíveis; o modo de permissão determina como tratar as solicitações de aprovação das ferramentas.

Abra uma nova sessão de Código e escolha a pasta do projeto. Em um repositório Git, selecione a branch ou crie um worktree separado para a tarefa.
Escolha um modelo no seletor. Os modelos disponíveis vêm do gateway configurado.
Escolha um modo de permissão. Use Sempre perguntar na primeira tarefa se quiser revisar as solicitações para alterar arquivos ou executar comandos.
Descreva a tarefa e envie a mensagem. Inclua o resultado esperado e como verificá-lo.

Os controles de pasta, branch e worktree ficam junto ao campo de mensagem. Escolha o ambiente antes da primeira mensagem; uma sessão existente mantém seu destino de execução.

Escolha a pasta do projeto e o ambiente de execução antes de iniciar a sessão.

Pergunte sobre o projeto

Comece com uma pergunta cuja resposta você possa conferir no projeto:

Leia @README.md e identifique como executar este projeto e seus testes. Não altere arquivos.

Selecione README.md nas sugestões de @ para incluir o arquivo na solicitação. Expanda o cartão de leitura do arquivo e compare a resposta com o README. No exemplo, a resposta deve identificar npm test e explicar o cálculo. Não deve afirmar que executou testes se a linha do tempo não mostrar o comando e seu resultado.

Reproduza e corrija um erro

Em seguida, forneça um problema reproduzível e o resultado esperado:

O total da compra ignora as quantidades dos itens. Adicione um teste de regressão em checkout.test.js para três unidades de US$ 12 cada: o total esperado é US$ 36. Execute npm test para reproduzir a falha, corrija checkout.js e execute os testes novamente.

A primeira execução deve mostrar o total incorreto de 12; após a correção, a mesma asserção deve passar com 36. Confira a saída dos testes antes de aceitar o resumo do agente.

Confira o resultado

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.

A sessão de exemplo informa a falha reproduzida, a correção das quantidades e dois testes aprovados.

Revise antes do commit

Abra Alterações da sessão e confira checkout.js e checkout.test.js. Verifique se o cálculo multiplica o preço pela quantidade e se o teste de regressão cobre três unidades. Expanda o resultado para confirmar que os dois testes passaram e revise e faça o commit das alterações. Em um projeto web, você também pode conferir a página no navegador.

Primeiros passos

Recursos

Ferramentas e personalização

Outras interfaces

Suporte

Início rápido

Antes de começar

Prepare um exemplo pequeno

Escolha o projeto e o modelo

Pergunte sobre o projeto

Reproduza e corrija um erro

Confira o resultado

Revise antes do commit

​Antes de começar

​Prepare um exemplo pequeno

​Escolha o projeto e o modelo

​Pergunte sobre o projeto

​Reproduza e corrija um erro

​Confira o resultado

​Revise antes do commit

Antes de começar

Prepare um exemplo pequeno

Escolha o projeto e o modelo

Pergunte sobre o projeto

Reproduza e corrija um erro

Confira o resultado

Revise antes do commit