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

# Instalação

> Instale o aplicativo desktop, conecte sua conta e confira o gateway e os modelos disponíveis.

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

Você precisa de uma conta ou chave de API para o gateway MKA1 da sua organização. O pacote desktop inclui o ambiente de execução do agente; você não precisa instalar a CLI nem compilar a aplicação a partir do código-fonte.

Antes de baixar, confira se sua organização exige uma distribuição própria. Se exigir, use esse pacote; caso contrário, use os downloads públicos abaixo. Você também precisa de acesso de rede ao gateway e de uma conta ou chave de API autorizada. A lista de modelos depende desse acesso.

O aplicativo inclui o ambiente de execução do agente, mas não instala as ferramentas do projeto. Um projeto JavaScript, por exemplo, pode precisar de Node.js e dependências para executar testes. Você pode instalar o aplicativo e conectar a conta antes de preparar um projeto.

<span id="baixe-o-instalador" />

## 1. Baixe

Baixe o instalador desktop para seu sistema operacional e processador. Estes links correspondem ao MKA1 Code 1.57.4.

| Plataforma | Baixar |
| - | - |
| macOS · Apple silicon | [Baixar DMG](https://downloads.mka1.com/code/v1.57.4/MKA1-Code-1.57.4-arm64.dmg) |
| macOS · Intel | [Baixar DMG](https://downloads.mka1.com/code/v1.57.4/MKA1-Code-1.57.4-x64.dmg) |
| Windows · x64 | [Baixar EXE](https://downloads.mka1.com/code/v1.57.4/MKA1-Code-1.57.4-x64-setup.exe) |
| Linux · ARM64 | [Baixar AppImage](https://downloads.mka1.com/code/v1.57.4/MKA1-Code-1.57.4-arm64.AppImage) |
| Linux · x64 | [Baixar AppImage](https://downloads.mka1.com/code/v1.57.4/MKA1-Code-1.57.4-x86_64.AppImage) |

O [manifesto da versão pública](https://downloads.mka1.com/code/latest/manifest.json) lista a versão publicada e as somas de verificação dos pacotes.

No macOS, abra **Sobre Este Mac** para conferir se o computador tem chip Apple ou processador Intel. Os downloads do Windows oferecem suporte a x64. No Linux, escolha ARM64 para processadores ARM ou x64 para x86-64. O pacote precisa corresponder ao computador em que o aplicativo desktop será executado.

### Distribuições de organizações

Se sua organização fornecer uma distribuição com marca própria ou exigir uma versão específica, use os pacotes dela:

1. Abra [Aplicativos no console MKA1](https://platform.mka1.com/downloads) e faça login. Se sua organização usar outro endereço para o console, abra esse console e selecione **Aplicativos** no final da barra lateral.
2. Selecione sua organização. A distribuição pode ter outro nome e logotipo.
3. No cartão de download da aplicação, use **Plataforma** para selecionar o sistema operacional e o processador.
4. Escolha **Baixar** ao lado de **Aplicativo para desktop**. Para as outras interfaces, escolha o pacote da extensão do VS Code ou da CLI.

Se a distribuição exigida pela organização não aparecer ou não estiver disponível para sua plataforma, peça ao administrador o instalador e acesso ao gateway.

<span id="instale-o-aplicativo-desktop" />

## 2. Instale

<Tabs>
  <Tab title="macOS">
    1. Abra o arquivo `.dmg` baixado.
    2. Arraste o aplicativo para **Aplicativos** e espere a cópia terminar.
    3. Ejete a imagem de disco e abra o aplicativo instalado em **Aplicativos**. Execute a cópia instalada, não a que está dentro da imagem de disco.
    4. Continue em **Conecte sua conta** abaixo.
  </Tab>

  <Tab title="Windows">
    1. Abra o instalador `x64-setup.exe` baixado.
    2. Siga as instruções até concluir a instalação.
    3. Abra o aplicativo instalado pelo menu **Iniciar**.
    4. Continue em **Conecte sua conta** abaixo.
  </Tab>

  <Tab title="Linux">
    1. Salve o `.AppImage` baixado na pasta em que deseja manter o aplicativo.
    2. Abra um terminal nessa pasta. Substitua `<application>.AppImage` pelo nome exato do arquivo baixado e execute os comandos para torná-lo executável e abri-lo:

    ```bash Bash theme={null}
    chmod +x "<application>.AppImage"
    ./"<application>.AppImage"
    ```

    3. Mantenha o AppImage em uma pasta gravável para que o aplicativo possa atualizá-lo.
    4. Continue em **Conecte sua conta** abaixo.
  </Tab>
</Tabs>

Se o sistema operacional bloquear o instalador ou o aplicativo, peça ao administrador o procedimento de instalação da sua organização.

<span id="conecte-sua-conta" />

## 3. Conecte sua conta

A autenticação abre no navegador. O código exibido pelo aplicativo identifica a solicitação de autorização que você precisa confirmar:

1. Inicie o login. O aplicativo exibe um código de autorização e abre o navegador.
2. No navegador, entre com a conta da sua organização. Confira se o navegador e o aplicativo exibem o mesmo código antes de aprovar o acesso. Enquanto aguarda, você pode copiar o código ou reabrir a página de autorização pelo aplicativo.
3. Volte ao aplicativo quando a autorização terminar. Consulte o seletor de modelos para ver os modelos disponíveis pelo gateway.

Se sua organização fornecer uma chave de API, abra **Ajustes → Acesso**, selecione **Chave de API**, informe a chave e escolha **Usar chave de API**. O aplicativo valida a chave antes de ativá-la. Os recursos que exigem a identidade da conta, incluindo a [memória do projeto](/pt/docs/mka1-code/memory), continuam exigindo login com uma conta.

<Frame caption="Escolha o login com conta ou uma chave de API em Ajustes → Acesso.">
  <ScreenshotCrop src="/images/mka1-code/guides/pt/install.jpg" alt="Opções de conta e chave de API nos ajustes de acesso" width={2720} height={1660} x={1030} y={30} cropWidth={1080} cropHeight={340} maxWidth="100%" />
</Frame>

### Escolha um modelo

Abra o seletor e escolha um modelo disponível pelo gateway. Para uma pergunta de código em texto, comece com um modelo recomendado pela organização para programação. Para anexar capturas de tela, escolha um que aceite imagens. Um seletor vazio indica um problema de conexão ou catálogo a resolver antes da tarefa; não significa que o projeto esteja vazio.

Se o login retornar ao aplicativo sem modelos, confira a conexão abaixo. Se a autorização expirou, solicite outro código e repita o login. Consulte [Consumo e solução de problemas](/pt/docs/mka1-code/troubleshooting) para as etapas de recuperação.

### Confira a conexão

Em **Ajustes → Conexão**, use a URL do gateway fornecida pelo administrador. Com uma credencial ativa, escolha **Testar conexão** para conferir o acesso e os modelos disponíveis. O teste não salva as alterações; escolha **Salvar** para aplicá-las. Alterar a origem do servidor remove a credencial ativa, então autentique-se novamente após salvar.

Você também pode escolher idioma e tema em **Ajustes**.

Nas sessões locais, o agente e as ferramentas do projeto são executados no seu computador. Nas sessões remotas, são executados no ambiente selecionado. Prompts, conteúdo relevante dos arquivos e resultados das ferramentas são enviados ao gateway MKA1 configurado como contexto para as solicitações ao modelo.

### Verifique a instalação

Após fazer login, confira se o seletor mostra os modelos do seu gateway. Abra um projeto local em **Código** e envie uma solicitação cujo resultado você possa conferir, como:

> Leia README.md e explique o que este projeto faz. Não altere arquivos.

Se o projeto não tiver `README.md`, indique outro arquivo de texto que ele contenha. Confira se uma resposta chega e examine o resultado da leitura do arquivo na linha do tempo.

Para executar comandos do projeto, instale as dependências habituais e as ferramentas de compilação ou teste. O Git é necessário para usar branches, worktrees e commits. Em sessões remotas, essas ferramentas precisam estar instaladas no ambiente selecionado.

Continue com [Início rápido](/pt/docs/mka1-code/first-task).