Guia de agentes da Flaq AI
Guia prático para usar o ZCode com os serviços de API da Flaq AI
Conecte o ambiente desktop de programação com IA ZCode à API da Flaq AI compatível com a OpenAI e use os modelos GLM 5.2, Kimi K3 ou DeepSeek v4 para perguntas sobre repositórios e fluxos de trabalho de programação. Este guia aborda o download oficial do ZCode, a configuração de um provedor personalizado, a seleção do modelo e um teste simples do espaço de trabalho.
Instalar
Instalar o ZCode
Baixe o aplicativo oficial do ZCode para macOS, Windows ou Linux, instale-o seguindo o fluxo padrão do seu sistema e escolha um diretório de projeto na primeira inicialização. Atualmente, o ZCode oferece uma AppImage para Linux x64, além dos downloads para macOS e Windows.
Baixar o ZCode
Abra a página oficial de instalação e escolha o pacote correspondente ao seu sistema operacional e à sua arquitetura.
Escolha o arquivo .dmg para Apple Silicon ou Intel, arraste o ZCode para a pasta Aplicativos e abra o aplicativo pelo Launchpad.
Baixar o ZCode para macOS
Configurar
Conectar o ZCode à Flaq AI
Abra as configurações de modelos do ZCode, adicione a Flaq AI como um provedor de terceiros usando o protocolo OpenAI, insira sua chave de API da Flaq e adicione manualmente o ID do modelo selecionado. O ZCode pode usar serviços de modelos compatíveis por meio de provedores personalizados, mesmo quando eles não estão incluídos na lista de provedores integrados.
Opção padrão recomendada para fluxos de trabalho de programação no ZCode, tarefas de repositório em várias etapas, planejamento e análise de código.
Modelo Kimi K3 para programação de longo prazo, contexto técnico extenso, análise e fluxos de trabalho de texto baseados em agentes.
Modelo DeepSeek v4 Pro para análise de repositórios, perguntas de programação e tarefas que se beneficiam de um raciocínio mais avançado.
Opção mais rápida do DeepSeek v4 Flash para resumos, perguntas rotineiras sobre código e tarefas leves de repositório.
Clique no nome do modelo na caixa de chat do ZCode, selecione Manage Models e abra Settings → Model Settings. Clique em Add Provider, escolha o protocolo OpenAI, insira as configurações da Flaq abaixo e ative o provedor. Se a lista de modelos não for carregada automaticamente, clique em Add Model e insira manualmente o ID do modelo selecionado.
- Use o URL base exato da API da Flaq e substitua o espaço reservado pela sua chave de API da Flaq.
- Mantenha o ID do modelo selecionado exatamente como mostrado.
Configurações do provedor Flaq AI
- Use o URL base exato da API da Flaq e substitua o espaço reservado pela sua chave de API da Flaq.
- Mantenha o ID do modelo selecionado exatamente como mostrado.
Configurações do provedor Flaq AI
- Use o URL base exato da API da Flaq e substitua o espaço reservado pela sua chave de API da Flaq.
- Mantenha o ID do modelo selecionado exatamente como mostrado.
Configurações do provedor Flaq AI
- Use o URL base exato da API da Flaq e substitua o espaço reservado pela sua chave de API da Flaq.
- Mantenha o ID do modelo selecionado exatamente como mostrado.
Configurações do provedor Flaq AI
Verificar
Verificar a Flaq no ZCode
Escolha o modelo Flaq configurado no seletor de modelos, abra um diretório de projeto como o espaço de trabalho atual, inicie uma nova sessão do ZCode Agent e envie primeiro uma tarefa de somente leitura sobre o repositório.
Use este prompt para verificar se o modelo selecionado responde com informações do espaço de trabalho atual sem solicitar alterações nos arquivos.
Testar o acesso ao projeto
Use este prompt para verificar se o modelo selecionado responde com informações do espaço de trabalho atual sem solicitar alterações nos arquivos.
Testar o acesso ao projeto
Use este prompt para verificar se o modelo selecionado responde com informações do espaço de trabalho atual sem solicitar alterações nos arquivos.
Testar o acesso ao projeto
Use este prompt para verificar se o modelo selecionado responde com informações do espaço de trabalho atual sem solicitar alterações nos arquivos.
Testar o acesso ao projeto
Site oficial
Visitar o site oficial do ZCode
Visite o site oficial do ZCode para obter os downloads atuais do aplicativo para desktop, instruções de instalação, documentação de configuração dos modelos, notas de versão e atualizações do produto.
Abra o site oficial do ZCode para baixar o aplicativo e consultar o fluxo de configuração mais recente para macOS, Windows e Linux.
Solução de problemas