Folio №12 · vs agentes de programação · 2026-10-11
Escolher ferramentas por cenário

Agente de programação ou software de escrita de romances: o que se ganha e se perde ao escrever obras longas com ferramentas de código

Claude Code, Cursor e Codex CLI leem e gravam pastas inteiras, e há autores que os usam em romances longos. Compare-os com o Maliang: pastas, regras, registro e revisões.

❦ · Verdict · ❦
Em uma frase

A conclusão primeiro

Os agentes de programação são muito capazes: leem e gravam entre arquivos, fazem alterações em lote e executam scripts, e autores com conhecimento técnico montam fluxos de escrita muito flexíveis; o preço é que pastas, arquivos de regras, registro de ambientações e gestão de versões precisam ser projetados e mantidos por você, e a interface é voltada a programadores. O Maliang transforma isso em fichas, sumário e editor, que o autor já conhece.
Para quem o Maliang Writer serveAutores que não conhecem o terminal e o Git, ou que não querem montar pastas, escrever regras e manter o registro, e só querem se concentrar em escrever uma obra longa.
Para quem agentes de programação serveAutores que conhecem o terminal, o Git e o Markdown, querem controlar cada arquivo e cada regra e aceitam manter todo o fluxo por conta própria.
Cenário

Um cenário de escrita concreto

Desde 2025, cada vez mais gente descobriu que os agentes de programação também escrevem romances: guarda-se cada capítulo em um arquivo Markdown, criam-se as pastas de ambientações, roteiro e acompanhamento, deixa-se na raiz um CLAUDE.md ou AGENTS.md com as regras e pede-se ao Claude Code, ao Cursor ou ao Codex CLI que leia a pasta inteira para escrever. Já há no GitHub vários modelos de código aberto assim, como webnovel-writer e oh-story-claudecode. O método de fato funciona e é flexível. Mas, olhando as práticas compartilhadas publicamente, alguns tipos de problema se repetem: esquecimento de ambientações e exigências depois de uma conversa longa, deriva de estilo e de personagens, custo de uso que sobe, arquivos de capítulos em chinês fora de ordem e uma barreira nada pequena para quem não programa. No fim, os agentes de programação foram feitos para programadores cuidarem de código, e para escrever romances com eles você precisa antes ser meio engenheiro e montar a estrutura e as regras do livro.

❦ · Matrix · ❦
Tabela comparativa

10 critérios comparados um a um

Em telas estreitas, role na horizontal para ver todas as colunas.

Maliang Writer vs agentes de programação: comparação dos critérios principais
CritérioMaliang Writeragentes de programaçãoObservação
Barreira de entrada✅ Abre e já dá para usar na web, sem instalar⚠️ Com arquivos locais, é preciso instalar, entrar na conta e operar no terminal ou em um editor de código; algumas ferramentas têm também entrada pela web ou pelo desktopO Codex CLI se instala por npm ou Homebrew; o Cursor é um editor para desktop; o Claude Code tem também versões desktop e web
Estrutura do livro✅ Volumes, capítulos, roteiros de capítulo, personagens, itens da bíblia da história, linhas narrativas e documentos já vêm prontos⚠️ O autor projeta as próprias pastas, como texto, roteiro, bíblia da história e arquivos de acompanhamento
Regras de escrita✅ Digite / para escolher métodos de escrita (continuar, planejar o roteiro do capítulo, remover o tom de IA etc.), e uma mensagem pode combinar vários✅ Você escreve as regras no CLAUDE.md, no AGENTS.md ou em .cursor/rulesO AGENTS.md do Codex CLI tem limite padrão somado de 32 KiB
Registro do estado dos personagens e das pistas plantadas✅ Ao terminar o capítulo, organiza os arquivos da história; o que não bate fica «pendente de confirmação»; dá para desligar⚠️ O autor ou a IA mantém arquivos de registro no formato que o autor projetou
Alterações em lote entre arquivos✅ A IA altera personagens, ambientações e o texto de vários capítulos conforme o pedido, e as mudanças podem ser conferidas e desfeitas✅ Ponto forte: confere e altera em lote entre mais de cem arquivos e ainda executa scripts
Comparação de revisões✅ No editor de romances, exclusões em vermelho e acréscimos em verde sobre o original, para manter ou reverter uma a uma✅ O Cursor tem visualização de diff em tempo real; o Claude Code mostra o diff no plugin do VS Code e no aplicativo para desktop; o Codex CLI mostra um diff de texto no terminal
Desfazer✅ Desfazer a rodada atual, abrir uma ramificação a partir de antes da rodada, editar e reenviar✅ Claude Code: checkpoints automáticos + /rewind; Cursor: os checkpoints ficam locais e a empresa recomenda o Git para versões de longo prazo; Codex CLI: a empresa recomenda salvar uma versão no Git antes e depois da tarefa
Ordenação e leitura de capítulos em chinês✅ Aparecem no sumário na ordem de volumes e capítulos, e o texto é lido já formatado no editor⚠️ Ficam guardados como arquivos, e a ordenação e a união cabem ao autorHá práticas públicas que mencionam nomes de capítulos em chinês fora de ordem na ordenação alfabética
Disponibilidade na China continental✅ Interface em chinês, acesso direto pelo navegador⚠️ Claude Code: a lista oficial de regiões atendidas pela Anthropic não inclui a China continental; o Codex vem com os planos do ChatGPT, e a lista oficial de regiões atendidas pelo ChatGPT não inclui a China continental; Cursor: a empresa diz que alguns provedores de modelos têm restrições regionais
Custo✅ Desconto de créditos conforme o uso, com cadastro gratuito para testar✅ O Claude Code está incluído no Claude Pro, a partir de US$ 20/mês; Cursor Hobby gratuito, Individual: US$ 20/mês; o Codex está incluído em todos os planos do ChatGPT (páginas oficiais de preços verificadas em 2026-10)

✅ Suporte confirmado em materiais oficiais ou no produto   ⚠️ Suporte parcial ou sem menção nos materiais oficiais   ❌ Oficialmente sem suporte · As informações sobre concorrentes vêm de seus materiais públicos.

A abordagem do Maliang Writer

Como o Maliang Writer lida com esses problemas

№01 Maliang Writer

A estrutura do livro já vem pronta

Volumes, capítulos, roteiros de capítulo, personagens, ambientações, pistas plantadas, linhas narrativas e documentos já estão classificados. Você vê fichas e sumário, sem projetar pastas nem escrever arquivos de regras.

№02 Maliang Writer

O registro fica por conta dos arquivos da história

A «linha do tempo dos personagens e o registro de pistas plantadas» que nas práticas públicas o autor precisa manter, no Maliang são feitos pela organização dos arquivos da história depois que o capítulo termina: estado dos personagens, relações, localização e pistas plantadas; o que não bate fica «pendente de confirmação».

№03 Maliang Writer

As alterações aparecem no editor de romances

Quando a IA altera o texto, as mudanças aparecem direto sobre o original já formatado, e você mantém ou reverte uma a uma, sem ler comparações de arquivos com estilo de código.

  1. Os métodos de escrita se escolhem com /, sem escrever regras: Digite / para escolher métodos de escrita como continuar, planejar o roteiro do capítulo, remover o tom de IA e diagnosticar o capítulo, digite @ para indicar capítulos e personagens, e uma mensagem pode combinar vários.
O que você precisa cobrir

O que o autor precisa fazer ao escrever um romance longo diretamente com agentes de programação

  1. As pastas e as regras você projeta: Ao escrever romances com um agente de programação, o primeiro passo é projetar as pastas e os arquivos de regras. O AGENTS.md do Codex CLI tem limite padrão somado de 32 KiB, e a empresa recomenda pôr no AGENTS.md as regras que precisam ser obedecidas, em vez de depender só da memória.
  2. O registro você mantém: As práticas públicas de obras longas projetam, cada uma, um arquivo de estado ou de acompanhamento como fonte dos fatos, por exemplo registrando separadamente a «verdade do autor» e o «que o leitor já sabe», para evitar que os personagens já saibam a resposta de antemão. O formato e as regras de manutenção cabem ao autor.
  3. Problemas comuns nas práticas públicas: Um autor que escreveu romances de médio e longo porte no Cursor diz, em suas palavras: «com frequência há alucinações: ou esquece as ambientações do romance, ou esquece o que eu pedi na criação de arquivos»; um autor no fórum do Cursor menciona que conversas longas de 200 mensagens fazem o modelo começar a se repetir e o texto ficar sem graça; e outro menciona que pedir ao Claude para unir arquivos um a um consumiu muito do uso.
  4. Barreira para quem não programa: Há autores que escrevem que, para quem não é programador, o VS Code já dá receio só de ouvir; outros acham que o Claude Code é mais poderoso, mas também mais intimidante, e que a maioria dos autores fica na interface de conversa.
Pontos fortes do outro

No que agentes de programação se destaca

Os agentes de programação são muito capazes: o Claude Code entende o projeto inteiro e executa tarefas entre arquivos, e os checkpoints automáticos permitem voltar a qualquer momento; o Cursor tem um sistema de regras detalhado, diff em tempo real e modelos de vários fornecedores à escolha; o Codex CLI é de código aberto, vê arquivos, altera arquivos e executa comandos no terminal, com isolamento de segurança em nível de sistema e aprovação. Autores com conhecimento técnico podem fazer com eles muita coisa que um software de escrita não faz: escrever scripts para contar a frequência de palavras do livro todo, renomear personagens em lote, personalizar o fluxo de verificação e gerir cada versão do rascunho com o Git.

Cada produto serve a certos cenários; aqui damos sugestões apenas para um: romances longos seriados em chinês.

Interface real

A interface real do Maliang Writer

Ficha de personagem flutuante no Maliang Writer
O autor vê e altera os dados direto na ficha do personagem, sem abrir a pasta.
No editor do Maliang Writer, as alterações da IA aparecem com exclusões em vermelho e acréscimos em verde
O autor confere uma a uma as alterações da IA no texto já formatado.
Botões de desfazer a rodada atual, abrir ramificação e editar e reenviar no Maliang Writer
O autor não gostou do resultado desta rodada e escolhe desfazer a rodada atual ou abrir uma ramificação.
Arquivos do capítulo no Maliang Writer: estado dos personagens, relações, localização e pistas plantadas
O autor vê os arquivos do capítulo, organizados automaticamente depois que o capítulo termina.
❦ · Evidence · ❦
Dados e fontes

Fontes e datas de verificação

Faça quatro tarefas de escrita reais antes de decidir como escolher

Nesta página, vale registrar principalmente quanta operação o autor precisa fazer para preparar pastas, regras de escrita, atualização de materiais e verificação de revisões. Não compare apenas o estilo de uma geração nem presuma de antemão que ferramentas baseadas em pastas são necessariamente mais difíceis de usar.

Esta é uma lista de testes com a mesma tarefa, não um experimento comparativo já concluído. Você pode usar o material didático original “Jiehuo City” ou um manuscrito que tenha direito de usar; registre separadamente o processo de preparação, o resultado e as correções do autor.

Começar uma obra nova

Dê o mesmo protagonista, as mesmas regras centrais e as mesmas preferências de leitura; compare primeiro as direções de abertura e depois organize o roteiro geral, o roteiro do primeiro volume e os roteiros dos três primeiros capítulos.

Verifique: Ela distingue o papel de cada um dos três níveis de roteiro? O autor consegue confirmar o plano antes de continuar? Algum detalhe ainda indefinido foi escrito como fato sem aviso?

Usar o mesmo pacote de materiais de abertura

Continuar vinte capítulos já escritos

Use o mesmo manuscrito antigo que você tenha direito de usar, indique como termina o último capítulo e qual é o objetivo do próximo; tente primeiro uma cena e não altere os vinte capítulos anteriores.

Verifique: Que materiais você preparou? As posições dos personagens, os objetos e as pontas soltas foram mantidos? Como distinguir as versões candidatas das adotadas?

Ver a lista de tarefas de importação e continuação

Alterar um elemento já estabelecido da história

Escolha uma regra real que afete capítulos anteriores; peça primeiro que liste os capítulos afetados e as evidências, e só então o autor escolhe o alcance da alteração.

Verifique: Ela diz quais partes não verificou? Dá para ver as alterações antes? Ela editou por engano texto fora da tarefa ou gravou nos materiais um plano não adotado?

Ver como alterar um elemento já estabelecido

Levar a obra e os materiais embora

Teste na prática se consegue manter o texto, a ordem de volumes e capítulos, as fichas de personagens e as regras do universo, e verifique se o resultado serve para continuar editando; liste o que não pode ser levado.

Verifique: O formato e a ordem são reconhecíveis? O que há na conta da plataforma, o que há em arquivos locais e o que há nos arquivos exportados? Não deduza a utilidade só por uma página promocional.

Copiar a ficha de registro de tarefa e resultado

Registre os modelos, planos ou condições de conta realmente usados e o tempo gasto preparando materiais e revisando o texto. Deixe em branco o que não testou ou não consegue confirmar; não substitua a experiência completa pelo nome de um recurso ou por uma única geração.

Como escolher

Escolha conforme a sua situação

Perguntas frequentes

Perguntas frequentes

O Claude Code escreve romances?

Escreve. O jeito comum é um arquivo Markdown por capítulo, com pastas à parte para ambientações, roteiro e acompanhamento, regras no CLAUDE.md e o Claude Code lendo e gravando a pasta inteira. Atenção: a lista oficial de regiões atendidas pela Anthropic não inclui a China continental.

O Cursor é bom para escrever romances?

O Cursor permite referenciar arquivos com @, escrever regras com rules e ver o diff em tempo real, e para autores com conhecimento técnico é muito flexível. Nas práticas públicas também há autores que mencionam problemas como esquecer as ambientações depois de uma conversa longa e capítulos em chinês fora de ordem, que exigem projetar as próprias pastas e regras para resolver.

O que é preciso para escrever romances com o Codex?

É preciso instalar o Codex CLI, entrar com a conta do ChatGPT ou usar a chave de API da OpenAI e escrever as regras do AGENTS.md no projeto. A documentação oficial do CLI recomenda salvar uma versão no Git antes e depois da tarefa para poder voltar.

Ao escrever romances com uma ferramenta de programação com IA, como dividir as pastas?

A divisão comum nos modelos públicos tem quatro tipos: texto, roteiro (roteiro geral, roteiros de volume e roteiros de capítulo), bíblia da história e acompanhamento (estado e registro de pistas plantadas), com o arquivo de regras na raiz e o Git para as versões. No Maliang essas categorias já vêm prontas, e os arquivos também são organizados automaticamente quando o capítulo termina.

O que escrever no CLAUDE.md ao escrever um romance?

Em geral, exigências de estilo, ambientações rígidas dos personagens, proibições e quais arquivos ler a cada capítulo. Quanto mais regras, mais é preciso enxugá-las de tempos em tempos, senão elas são ignoradas ou entram em conflito. O Maliang usa métodos de escrita no lugar do arquivo de regras, e basta digitar / para escolher.

Dá para escrever romances com o Claude Code sem saber programar?

Dá para aprender, mas antes é preciso conhecer o terminal, os arquivos e as pastas, e saber ler a comparação de arquivos. Se você só quer se concentrar em escrever, um software de escrita na versão web poupa muito trabalho.

O que sai mais barato para escrever romances: agente de programação ou software de escrita?

Os agentes de programação costumam estar incluídos em assinaturas, como o Claude Pro, a partir de US$ 20/mês, e o Cursor Individual, US$ 20/mês (verificado em 2026-10); conversas longas e operações em lote consomem mais do uso. O Maliang desconta créditos conforme o uso, com o consumo de cada rodada abaixo da resposta, e dá para comparar depois de testar com cadastro gratuito.

Dá para levar os arquivos de romance do Claude Code para o Maliang?

Dá para colar os arquivos de ambientação e o conteúdo dos capítulos na IA do Maliang e pedir que ela os organize em fichas de personagem, fichas de ambientação e sumário de capítulos, e depois de conferir é só continuar escrevendo.

❦ · Continued · ❦
Comparativos relacionados

Comparativos relacionados

O Claude Code escreve romances? Como as práticas públicas funcionam e no que diferem do Maliang Writer

vs Claude Code · atualizado em 2026-10-11

O Claude Code escreve romances, e com muita capacidade: lê e grava a pasta do livro inteiro, verifica a continuidade entre arquivos e faz alterações em lote. Nas práticas públicas, o autor projeta as pastas, escreve o CLAUDE.md, mantém um registro de ambientações e trabalha no terminal ou em um plugin de editor, o que serve a quem domina a linha de comando. O Maliang coloca o sumário, as fichas de personagem, os arquivos da história e a comparação de revisões em um editor web, e o autor começa a escrever pela conversa.

Read the comparison →

Como é escrever romances no Cursor? As práticas públicas e as diferenças em relação ao Maliang Writer

vs Cursor · atualizado em 2026-10-11

O Cursor escreve romances: no editor dá para ver os arquivos e o diff em tempo real, o sistema de Rules é detalhado e a variedade de modelos é grande. Nas práticas públicas, o autor cria as pastas de capítulos, escreve as rules, mantém as ambientações e o registro, e com muitos capítulos ainda precisa lidar com a ordenação e a união dos arquivos. O Maliang coloca o sumário de volumes e capítulos, as fichas de personagem, os arquivos da história e a comparação de revisões em um editor web.

Read the comparison →

O Codex escreve romances? Como usar o Codex CLI em obras longas e no que difere do Maliang Writer

vs Codex CLI · atualizado em 2026-10-11

O Codex CLI é de código aberto e roda no terminal local, lê e grava o projeto inteiro, executa scripts e tem isolamento em nível de sistema e aprovação. Para escrever romances nele, o autor precisa criar as pastas, escrever o AGENTS.md, manter o registro e usar o Git para versões, e as alterações são vistas no terminal como diff de texto. O Maliang coloca isso em um editor web: sumário de volumes e capítulos, fichas de personagem, arquivos da história e comparação de revisões trecho a trecho.

Read the comparison →

Como gerir as ambientações de um romance: pastas com Markdown ou fichas de personagem e arquivos da história?

vs gestão por pastas + Markdown · atualizado em 2026-10-11

Pastas com Markdown são livres e transparentes, os arquivos ficam nas suas mãos, e servem a quem gosta de definir o próprio formato; o ponto fraco é que, com muitos arquivos, qual é o mais recente e quais outros precisam ser sincronizados depois de uma alteração você tem de lembrar sozinho. As fichas de personagem com arquivos da história fixam cada personagem e cada ambientação em uma ficha e organizam o estado sozinhas quando o capítulo termina, o que serve a quem não quer manter arquivos. O Maliang tem os dois: personagens e ambientações são fichas, o roteiro geral fica à parte; a amostra de estilo e o material de abertura do livro são documentos.

Read the comparison →

Se quiser primeiro saber quais tipos de software para escrever romances existem e no que cada um é bom, leia Como escolher uma ferramenta de IA para escrever romances.

Comece

Teste um capítulo do romance que você está escrevendo

Depois de se cadastrar, crie uma obra ou importe capítulos existentes, diga à IA qual capítulo continuar e veja o que ela escreveu, o que alterou e o que registrou no arquivo; só então decida se vai levar seu romance longo para lá.