> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mka1.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Início rápido

> Leia um projeto, reproduza um erro no checkout, verifique a correção e prepare a revisão.

export const ScreenshotCrop = ({src, alt, width, height, x = 0, y = 0, cropWidth = width, cropHeight = height, maxWidth = "100%"}) => <div className="not-prose" style={{
  position: "relative",
  overflow: "hidden",
  width: "100%",
  maxWidth,
  margin: "0 auto",
  aspectRatio: `${cropWidth} / ${cropHeight}`
}}>
    <img src={src} alt={alt} width={width} height={height} style={{
  position: "absolute",
  display: "block",
  margin: 0,
  maxWidth: "none",
  width: `${width / cropWidth * 100}%`,
  height: "auto",
  left: `${-x / cropWidth * 100}%`,
  top: `${-y / cropHeight * 100}%`
}} />
  </div>;

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](/pt/docs/mka1-code/install). Escolha um projeto com dependências e ferramentas de teste já instaladas. Use um projeto local neste passo a passo.

<Note>
  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.
</Note>

## 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.

<Accordion title="Arquivos do projeto de exemplo">
  <CodeGroup>
    ```json package.json theme={null}
    {
      "name": "checkout-example",
      "private": true,
      "type": "module",
      "scripts": {
        "test": "node --test"
      }
    }
    ```

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

    ```js checkout.test.js theme={null}
    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);
    });
    ```
  </CodeGroup>
</Accordion>

Em um terminal aberto nessa pasta, execute:

```bash Bash theme={null}
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.

1. 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](/pt/docs/mka1-code/workspaces) para a tarefa.
2. Escolha um modelo no seletor. Os modelos disponíveis vêm do gateway configurado.
3. Escolha um modo de permissão. Use **Sempre perguntar** na primeira tarefa se quiser revisar as solicitações para alterar arquivos ou executar comandos.
4. 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.

<Frame caption="Escolha a pasta do projeto e o ambiente de execução antes de iniciar a sessão.">
  <ScreenshotCrop src="/images/mka1-code/pt/desktop-project.jpg" alt="Seletor de projeto com a pasta checkout-demo e opções de execução local ou remota" width={2720} height={1660} x={1040} y={697} cropWidth={567} cropHeight={334} maxWidth={520} />
</Frame>

## 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.

<Frame caption="A sessão de exemplo informa a falha reproduzida, a correção das quantidades e dois testes aprovados.">
  <ScreenshotCrop src="/images/mka1-code/guides/pt/quickstart.jpg" alt="Solicitação sobre quantidades do carrinho e resumo dos testes de regressão" width={2720} height={1660} x={1000} y={120} cropWidth={1160} cropHeight={550} maxWidth="100%" />
</Frame>

## 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](/pt/docs/mka1-code/review-changes). Em um projeto web, você também pode [conferir a página no navegador](/pt/docs/mka1-code/previews).