GenCode

O que é o GenCode?

O GenCode é o agente de programação da Genspark. Ele trabalha com o código em um diretório que você escolhe. Escolha entre uma interface de chat e uma interface de terminal. As duas são o mesmo produto, com os mesmos recursos, e você usa o estilo que preferir. Você pode executá-lo em dois lugares:

• O espaço de trabalho do GenCode no Genspark Super App: a interface para desktop. Você trabalha com o agente em uma conversa, e o compositor de prompts mostra o modelo em uso, o uso do contexto e os créditos.
• A CLI independente do GenCode: um programa de terminal que você instala com npm e executa a partir do diretório em que deseja trabalhar.

Ambos usam o mesmo mecanismo, o mesmo catálogo de modelos hospedado pela Genspark e a mesma cobrança. O GenCode é baseado no fork do OpenCode mantido pela Genspark e mantém seus próprios diretórios de configuração, portanto não interfere em uma instalação existente do OpenCode.

Início Rápido

No Genspark Super App

1. Atualize o Genspark Super App para a versão mais recente.
2. Abra o aplicativo e procure o espaço de trabalho do GenCode. Se ele não aparecer, clique em + na barra de abas e adicione-o.

Ainda não tem o Super App? Baixe-o aqui. O download é gratuito para macOS, Windows e Linux. No Mac, o Super App exige Apple Silicon.

Com a CLI

1. Instale: npm i -g @genspark/gencode
2. Faça login: gencode login abre um login por fluxo de dispositivo. Depois do login, a CLI mostra seu saldo, seu plano e o e-mail da sua conta ao lado do catálogo de modelos.
3. Execute: gencode, a partir do diretório em que deseja trabalhar.

A CLI mantém o conjunto de comandos do OpenCode:

• gencode run --format json para uso em scripts e de forma não interativa
• gencode models para listar os modelos disponíveis para você
• as flags --dir, --session e --model
• variáveis de ambiente com o prefixo OPENCODE_

Ela mantém seus próprios diretórios de configuração (~/.config/gencode, ~/.local/share/gencode, ~/.local/state/gencode e ~/.cache/gencode), portanto uma instalação existente do OpenCode permanece intacta.

Os binários da CLI são compatíveis com Macs Intel e Macs com Apple Silicon, além de Windows e Linux.

Guias de Recursos e Instruções

O GenCode vem com uma interface de chat e uma interface de terminal. As duas são o mesmo produto, com os mesmos recursos. Use a que melhor se adapta à sua forma de trabalhar.

• O espaço de trabalho. No Genspark Super App, você trabalha com o GenCode em uma conversa. O compositor mostra o modelo em uso, o uso do contexto e os créditos.
• A CLI. O mesmo agente no seu terminal, em uma interface de tela cheia com painéis para o contexto da sessão e diagnósticos de código.
• Um agente de programação em qualquer formato. O GenCode trabalha com o código em um diretório que você escolhe. As ações são executadas por meio de chamadas de ferramentas, e os resultados são textos e alterações em arquivos.
• Subagentes. O GenCode lida com tarefas maiores por meio de subagentes: um que lê e analisa, e outro que pode fazer alterações. Cada um tem um limite de etapas configurado, o que mantém cada execução dentro de limites definidos.
• Avaliações. No Super App, você pode avaliar qualquer turno do GenCode com um polegar para cima ou para baixo. As avaliações ficam na sua máquina.
• Seu feedback permanece local. Uma avaliação descreve o turno de onde veio: modelo, ferramentas usadas, arquivos e linhas alterados, tokens, custo e tempo. Qualquer comentário em texto livre que você escrever nunca é transmitido.
• Compatível com scripts e CI. gencode run --format json retorna uma saída legível por máquina que você pode encaminhar para scripts e pipelines.

Encontre a pasta do seu projeto

Um projeto é uma pasta local que você adiciona ao GenCode, e o GenCode trabalha no código dessa pasta. O projeto integrado aparece como GenCode; a pasta dele é GensparkCode, dentro da sua pasta pessoal, criada na primeira vez que você o utiliza.

Remover da lista apenas retira um projeto da lista do GenCode, de modo que os arquivos dele permanecem no disco e os chats continuam no histórico do GenCode. O ícone no painel de arquivos do projeto (no canto superior direito, ao lado de Chat e Terminal) abre o arquivo selecionado no aplicativo padrão. Na CLI, seu projeto é a pasta a partir da qual você executa gencode, ou aquela que você informa com gencode --dir <path>; consulte o Início Rápido. O Diretório de trabalho de uma sessão (em Editar sessão) é aplicado quando a sessão é reconstruída ou reaberta, e Configurações → Redefinir mantém as pastas dos seus projetos no disco.

macOS

Clique em + ao lado de Projetos na barra lateral para abrir o seletor de pastas e, em seguida, escolha ou crie uma pasta. A pasta do projeto integrado é /Users/<you>/GensparkCode. Para encontrar a pasta de qualquer projeto, abra o menu Ações do projeto e escolha Mostrar no gerenciador de arquivos para abri-la no Finder, ou Copiar caminho.

Windows

Clique em + ao lado de Projetos na barra lateral para abrir o seletor de pastas e, em seguida, escolha ou crie uma pasta. A pasta do projeto integrado é C:\Users\<you>\GensparkCode. Para encontrar a pasta de qualquer projeto, abra o menu Ações do projeto e escolha Mostrar no gerenciador de arquivos para abri-la no Explorador de Arquivos, ou Copiar caminho. A guia Terminal abre o PowerShell, e o Super App é baixado como um instalador .exe.

Linux

Clique em + ao lado de Projetos na barra lateral para abrir o seletor de pastas e, em seguida, escolha ou crie uma pasta. A pasta do projeto integrado é /home/<you>/GensparkCode. Para encontrar a pasta de qualquer projeto, abra o menu Ações do projeto e escolha Mostrar no gerenciador de arquivos para abri-la no seu gerenciador de arquivos, ou Copiar caminho. O Super App é distribuído como um AppImage.

Modelos e custo

Modelos. O GenCode usa um catálogo de modelos hospedado pela Genspark que abrange nove famílias de modelos: Claude (Anthropic), GPT (OpenAI), Gemini (Google), DeepSeek, GLM (Z.ai), MiniMax, Kimi (Moonshot AI), Grok (xAI) e Nemotron (NVIDIA).

Custo. O GenCode funciona com créditos da Genspark. O uso é cobrado da conta com a qual o GenCode está autenticado. Na CLI, se GSK_API_KEY (ou GSK_BASE_URL) estiver definida no seu ambiente, a cobrança vai para a conta associada à chave. No seu histórico de créditos, o uso do GenCode aparece como "GenCode".

O GenCode é cobrado diretamente em créditos, e não pela Cota Gratuita que cobre as tarefas de agente no modo Padrão. Consulte Planos de Assinatura.

Não há assinatura nem carteira separada para o GenCode. Ele usa sua conta e seus créditos existentes da Genspark. Para saber como os créditos funcionam, consulte o Guia de Créditos.

Perguntas Frequentes

O GenCode é o mesmo que o Genspark Code?

Não. O Genspark Code é o agente de navegador em genspark.ai/code que cria aplicativos completos a partir de um prompt. Consulte o artigo de ajuda do Genspark Code. O GenCode é o agente de programação descrito aqui.

O GenCode é o mesmo que o Genspark Claw?

Não. O Claw é o agente assistente pessoal da Genspark que opera seus aplicativos e arquivos. Ele não é um agente de programação.

E o GenTerminal?

O GenTerminal é o aplicativo de terminal independente da Genspark, um produto diferente.

Preciso do Super App para usar o GenCode?

Não. Você pode usar o espaço de trabalho do GenCode no Genspark Super App ou instalar a CLI independente do GenCode. Ambos são o mesmo agente.

Qual é a diferença entre o espaço de trabalho e a CLI?

Apenas o local onde você o executa. O espaço de trabalho é executado dentro do Genspark Super App, e a CLI é executada no seu terminal. É o mesmo agente, com os mesmos recursos.

Preciso de um plano pago?

Não. O GenCode usa sua conta e seus créditos existentes da Genspark. Não há assinatura nem carteira separada para o GenCode.

O GenCode consome créditos?

Sim. O GenCode é cobrado da conta com a qual está autenticado, que por padrão é a conta com que você fez login. Na CLI, se GSK_API_KEY estiver definida no seu ambiente, a cobrança vai para a conta associada à chave. O uso aparece como "GenCode" no seu histórico de créditos, e o GenCode é cobrado diretamente em créditos, e não pela Cota Gratuita.

Quais modelos o GenCode usa?

Um catálogo hospedado pela Genspark que abrange nove famílias de modelos: Claude (Anthropic), GPT (OpenAI), Gemini (Google), DeepSeek, GLM (Z.ai), MiniMax, Kimi (Moonshot AI), Grok (xAI) e Nemotron (NVIDIA). Os modelos específicos que sua conta pode usar dependem do catálogo disponível no momento e da política de fornecedores de IA da sua organização.

A CLI vai interferir na minha instalação existente do OpenCode?

Não. O GenCode é baseado no fork do OpenCode mantido pela Genspark, mas instala seu próprio binário e mantém seus próprios diretórios de configuração (~/.config/gencode, ~/.local/share/gencode, ~/.local/state/gencode, ~/.cache/gencode). Ele nunca interfere em uma instalação existente do OpenCode.

O GenCode funciona em um Mac Intel?

A CLI funciona: seus pacotes npm publicados incluem macOS Intel (darwin-x64). O Super App exige Apple Silicon no Mac. Windows e Linux são compatíveis com ambos.

Onde faço o download do Genspark Super App?

superapp.genspark.ai/download: o download é gratuito para macOS, Windows e Linux.

Onde fica a pasta do meu projeto do GenCode?

Abra o menu Ações do projeto do projeto e escolha Mostrar no gerenciador de arquivos ou Copiar caminho — consulte Encontre a pasta do seu projeto.