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
Equipe editorial do Maliang Writer · Edição: Maliang · Atualizado em 2026-10-11
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.
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ério
Maliang Writer
agentes de programação
Observaçã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 desktop
O 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/rules
O 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 autor
Há 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
№01Maliang 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.
№02Maliang 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».
№03Maliang 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.
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
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.
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.
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.
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
O autor vê e altera os dados direto na ficha do personagem, sem abrir a pasta.O autor confere uma a uma as alterações da IA no texto já formatado.O autor não gostou do resultado desta rodada e escolhe desfazer a rodada atual ou abrir uma ramificação.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
Memória e checkpoints do Claude Code: A memória entre sessões usa o CLAUDE.md e a Auto memory; a cada prompt cria um checkpoint automático, guarda os 100 mais recentes e volta com /rewind. (Documentação oficial · code.claude.com · verificado em 2026-10)Ver →
Checkpoints do Cursor: A documentação oficial diz que os checkpoints são guardados localmente, separados do Git, e recomenda o Git para o controle de versões de longo prazo. (Documentação oficial · cursor.com · verificado em 2026-10)Ver →
Codex CLI AGENTS.md: Lê o AGENTS.md em níveis, do global ao projeto, com limite padrão somado de 32 KiB; a documentação oficial do CLI recomenda salvar uma versão no Git antes e depois da tarefa para poder voltar. (Documentação oficial · learn.chatgpt.com · verificado em 2026-10)Ver →
Regiões atendidas pela Anthropic: A lista oficial de regiões atendidas não inclui a China continental, Hong Kong nem Macau, e vale para o Claude.ai, o Claude Code e a API. (Documentação oficial · anthropic.com · verificado em 2026-10)Ver →
Prática de escrever romances de médio e longo porte no Cursor: Uma pasta por livro, com as regras em .cursor/rules; o autor menciona que, depois que o texto ocupa muito contexto, as ambientações costumam ser esquecidas, e que os capítulos em chinês ficam fora de ordem. (Discussão da comunidade · juejin.cn · verificado em 2026-10)Ver →
Fórum do Cursor: problemas de conversas longas ao escrever obras longas: O autor menciona que conversas longas de 200 mensagens elevam o custo e fazem o modelo começar a se repetir ou a escrever um texto sem graça. (Discussão da comunidade · forum.cursor.com · verificado em 2026-10)Ver →
Modelo de código aberto oh-story-claudecode: Ambientações, roteiro, texto e acompanhamento ficam separados, o arquivo de estado do acompanhamento é a fonte estruturada dos fatos, e pode ser instalado no Claude Code e no Codex CLI. (Discussão da comunidade · github.com · verificado em 2026-10)Ver →
Escrever romances no VS Code: O autor menciona que a IA tem limite de contexto, que unir arquivos um a um consome muito do uso e que, para quem não é programador, o VS Code intimida. (Discussão da comunidade · substack.aicentral.blog · verificado em 2026-10)Ver →
Arquivos da história do Maliang: Ao terminar o capítulo, organiza o estado dos personagens, as relações, as localizações e as pistas plantadas. (Dados do site · maliangwriter.com · verificado em 2026-10)Ver →
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?
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?
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?
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.
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
Se Você é programador e está acostumado a gerir tudo com o Git → escolha agentes de programação, porque Um agente de programação junto com o Git permite gerir cada versão do rascunho do seu jeito..
Se Você quer escrever scripts para estatísticas do livro todo, renomear em lote e personalizar verificações → escolha agentes de programação, porque Os agentes de programação executam scripts diretamente, algo que nem todo software de escrita permite personalizar desse jeito..
Se Você quer escrever em um software de escrita e só às vezes usar uma ferramenta de programação para processamento em lote → combine os dois, porque Mantenha a escrita do dia a dia, as ambientações e os arquivos no Maliang; deixe as tarefas pontuais que exigem scripts com o agente de programação..
Se Você não conhece o terminal ou não quer montar pastas e escrever regras → escolha o Maliang Writer, porque Volumes, capítulos, personagens e ambientações já vêm prontos, e os métodos de escrita se escolhem com /..
Se Você escreveu várias dezenas de capítulos com um agente de programação e o registro está cada vez mais difícil de manter → escolha o Maliang Writer, porque O estado dos personagens e as pistas plantadas ficam por conta dos arquivos da história organizados quando o capítulo termina, e o que não bate fica pendente de confirmaçã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.
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á.