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

# Extensão do VS Code

> Instale o MKA1 Code no VS Code e trabalhe com o agente ao lado dos arquivos.

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>;

A extensão coloca sessões de programação, atividade das ferramentas, aprovações e revisão de diffs ao lado dos arquivos no VS Code. As visualizações separadas de Conversas e Consumo ficam no aplicativo desktop.

Baixe o pacote de VS Code para seu sistema operacional e processador. Estes links correspondem ao MKA1 Code 1.57.4.

| Plataforma | Baixar |
| - | - |
| macOS · Apple silicon | [Baixar VSIX](https://downloads.mka1.com/code/v1.57.4/mka1-code-darwin-arm64-1.57.4.vsix) |
| macOS · Intel | [Baixar VSIX](https://downloads.mka1.com/code/v1.57.4/mka1-code-darwin-x64-1.57.4.vsix) |
| Windows · x64 | [Baixar VSIX](https://downloads.mka1.com/code/v1.57.4/mka1-code-win32-x64-1.57.4.vsix) |
| Linux · ARM64 | [Baixar VSIX](https://downloads.mka1.com/code/v1.57.4/mka1-code-linux-arm64-1.57.4.vsix) |
| Linux · x64 | [Baixar VSIX](https://downloads.mka1.com/code/v1.57.4/mka1-code-linux-x64-1.57.4.vsix) |

Se sua organização fornecer uma distribuição própria, siga as [etapas de download da organização](/pt/docs/mka1-code/install#distribuições-de-organizações) e escolha o pacote de VS Code.

## Instale a extensão

Baixe o arquivo `.vsix` específico da plataforma. No VS Code, execute **Extensions: Install from VSIX…** na paleta de comandos e selecione o arquivo. O nome desse comando depende do idioma do VS Code.

## Inicie uma sessão

1. Abra a pasta do projeto no VS Code.
2. Na paleta de comandos, execute **MKA1 Code: Abrir**. Se o VS Code estiver em inglês, o comando aparece como **MKA1 Code: Open**.
3. Se solicitado, escolha **Entrar** e conclua a autorização no navegador, ou escolha **Chave de API** e valide a chave no gateway configurado.
4. Inicie uma sessão e escolha um modelo. Abra **+ → Rascunhar um plano** para investigar antes de editar. Revise a proposta e escolha **Implementar o plano** quando estiver pronto.

No exemplo, mantenha o teste ou o cálculo aberto ao lado da conversa. O painel mostra as respostas à medida que chegam, a atividade das ferramentas, os diffs e o uso de contexto. Responda às perguntas e aprovações no painel e execute **MKA1 Code: Revisar as alterações** para revisar as edições antes do commit. Em um VS Code em inglês, use **MKA1 Code: Review changes**.

Você pode retomar uma sessão ou ramificar a conversa a partir de uma mensagem anterior para explorar outra abordagem. A extensão também permite preparar uma branch ou um worktree para a sessão. Ramificações de conversa preservam históricos diferentes; branches e worktrees do Git gerenciam as alterações no repositório.

Na tela de ajustes, **Extensões** permite gerenciar conectores MCP e pacotes de plugins compatíveis. Essas configurações são compartilhadas com o desktop e a CLI quando usam o mesmo armazenamento local.

## Conduza uma alteração no editor

Mantenha o código ou teste aberto ao lado do painel. Mencione o arquivo e o resultado esperado: “Adicione um teste de regressão para três itens, corrija o cálculo e execute os testes.” Expanda a atividade para conferir a saída e use **MKA1 Code: Revisar as alterações** para examinar implementação e teste juntos.

Use **MKA1 Code: Interromper a execução** para parar. Para outra tarefa, use **MKA1 Code: Nova sessão** e confira pasta e branch. Outra conversa não isola arquivos: escolha um worktree quando precisar de uma cópia independente.

<Frame caption="O painel MKA1 Code no VS Code mostra a atividade dos comandos e o resultado dos testes. Interface em inglês.">
  <ScreenshotCrop src="/images/mka1-code/vscode.jpg" alt="Extensão MKA1 Code com dois testes do carrinho aprovados" width={2880} height={1660} x={120} y={85} cropWidth={710} cropHeight={985} maxWidth="420px" />
</Frame>

## Configure e resolva problemas

Abra os ajustes no cabeçalho da extensão ou pela Paleta de Comandos. Confira acesso, conexão e modelo padrão. Salve mudanças de conexão antes de outra solicitação. Se a distribuição usar outro nome, os comandos seguem esse nome.

Um conector pode exigir autorização no navegador. Em uma sessão remota de VS Code, siga qualquer orientação para concluir a conexão no desktop ou terminal local. Controles exclusivos do desktop, como prévias de documentos e acompanhamentos agendados de conversas, estão nas respectivas guias.

Continue com [Consumo e solução de problemas](/pt/docs/mka1-code/troubleshooting).