Claw Code vs Claude Code: O que um clone open source no GitHub revela sobre a arquitetura de agentes de IA

Se você pesquisou por claw code github ou quis saber se Claude Code open source existe de forma realmente significativa, Claw Code é o projeto que as pessoas querem dizer. Trata-se de uma implementação open source, reverse-engineered, do Claude Code da Anthropic — reconstruída em Rust (runtime) e Python (metadata e scaffold de portabilidade) — e oferece uma rara visão interna de como um agente de codificação com IA em estilo de produção é estruturado.

Este guia segue nosso formato usual de Comparação: o que cada lado é, como se comparam na prática, onde o Claw Code se posiciona tecnicamente e um veredito claro para builders que estão avaliando a base de código.

O que é Claw Code?

Claw Code é um projeto open source que tenta replicar a funcionalidade principal do Claude Code — a ferramenta agentic de codificação da Anthropic para terminal e IDE. O código-fonte está no GitHub sob uma licença aberta; ele não é afiliado à Anthropic.

O projeto é dividido em duas camadas:

• Uma camada de metadata em Python que serve principalmente como scaffold de portabilidade — acompanhando o progresso, gerenciando a persistência de sessão e abrigando schemas baseados em dataclass.
• Um runtime em Rust para CLI que implementa o loop conversacional agentic real, a execução de ferramentas, o streaming da API e o gerenciamento de permissões.

Com cerca de 1.500 linhas de Python e 4.000 linhas de Rust, o Claw Code é um protótipo em estágio inicial. Mas ele identifica corretamente vários padrões arquiteturais que fazem agentes de codificação com IA funcionarem.

O que é Claude Code?

Claude Code é o assistente de codificação com IA nativo de terminal e IDE da Anthropic. Ele não é open source: o produto é fechado, distribuído pela Anthropic, e opera com modelos Claude com recursos como MCP (Model Context Protocol), subagents, hooks, skills e integração profunda com IDE.

Quando as pessoas pedem por Claude Code open source, geralmente estão procurando por (a) uma reimplementação independente como o Claw Code no GitHub, ou (b) um produto diferente por completo (por exemplo, um coworker desktop multi-agent). O Claw Code está claramente na primeira categoria — um espelho educacional e experimental de parte do comportamento do Claude Code, não um release oficial.

Claw Code vs Claude Code: Visão geral

A comparação é assimétrica por design: o Claw Code é um artefato de aprendizado e reimplementação parcial; o Claude Code é um produto lançado com investimento completo de plataforma.

O que o Claw Code acerta

O loop de conversa agentic

A coisa mais importante que Claw Code acerta é o loop agentic fundamental — o núcleo de qualquer assistente de codificação com IA:

Mensagem do usuário → Chamada de API → Parse da resposta → Execução de ferramentas → Retorno dos resultados → Repetir

A implementação em Rust (ConversationRuntime<C, T>) modela esse loop com abstrações baseadas em traits sobre ApiClient e ToolExecutor. Essa separação espelha agentes de produção: chamadas ao modelo e execução de ferramentas permanecem desacopladas, testáveis e substituíveis.

Streaming SSE e integração com a API

O cliente da API é, provavelmente, a parte mais pronta para produção do Claw Code. Ele implementa:

• A Messages API v1 da Anthropic com streaming via Server-Sent Events (SSE)
• Parse incremental de frames com buffering
• Lógica de retry com exponential backoff para respostas 408, 429 e 5xx
• Rastreamento de cache tokens para cache_creation_input_tokens e cache_read_input_tokens
• Autenticação via ANTHROPIC_API_KEY e ANTHROPIC_AUTH_TOKEN

Para quem está construindo um cliente personalizado da Anthropic, este crate é uma referência confiável.

Ferramentas de operação em arquivos

O Claw Code traz seis ferramentas principais — Bash, Read, Write, Edit, Glob e Grep — com comportamento alinhado ao modelo do Claude Code:

• Edit usa correspondência exata de string em vez de regex, reproduzindo o comportamento do Claude Code e evitando uma classe de bugs de escape.
• Glob ordena os resultados por tempo de modificação (mais recente primeiro).
• Grep oferece suporte a linhas de contexto, múltiplos modos de saída e paginação.
• Write cria automaticamente diretórios pai.

O modelo de permissões

O sistema de permissões em três níveis (Allow, Deny, Prompt) com overrides por ferramenta via uma struct PermissionPolicy reflete como o Claude Code controla a execução de ferramentas. Qualquer agente que executa comandos de shell e edita arquivos precisa dessa camada — a modelagem do Claw Code está conceitualmente correta.

Compaction de sessão

Quando o contexto cresce em direção aos limites de tokens, os agentes precisam comprimir turnos antigos sem perder a utilidade das mensagens mais recentes. A compaction do Claw Code — resumindo mensagens anteriores no system prompt enquanto mantém os últimos N turnos — captura como isso funciona na prática.

Lacunas significativas: o que está faltando

Embora Claw Code capture o esqueleto de um agente de codificação com IA, vários sistemas que separam protótipos de ferramentas de produção estão ausentes.

Sem suporte a MCP (Model Context Protocol)

Esta é a maior lacuna. MCP é a base de extensibilidade do Claude Code: servidores MCP externos fornecem ferramentas, resources e prompts que o agente descobre em runtime. O Claw Code não tem cliente MCP, transporte, descoberta dinâmica nem integração de resources — o conjunto de ferramentas permanece fixo em tempo de build.

Sem orquestração de subagents

O Claude Code pode iniciar conversas aninhadas entre agentes e trabalho paralelo (com isolamento e agregação). O Claw Code não implementa conversas aninhadas, isolamento de worktree, boundaries de contexto filho ou merge de resultados.

Sem sistemas de hooks ou skills

O Claude Code de produção expõe hooks configuráveis pelo usuário e um pipeline de skills / slash-command. O handler do Claw Code é mínimo (por exemplo, apenas /compact), sem pipeline de descoberta de hooks ou skills.

Construção incompleta do system prompt

O construtor de prompt tem as seções gerais corretas, mas omite partes dinâmicas como descoberta de CLAUDE.md, snapshots de git status, instruções de servidores MCP e metadata de runtime (data, nome do modelo etc.).

Sem integração com IDE

A arquitetura de bridge e server usada para extensões do VS Code e JetBrains está ausente.

Qualidade da implementação

Camada Rust — base sólida (7/10)

O código em Rust usa #![forbid(unsafe_code)], estrutura baseada em traits e um parser SSE que lida com frames de múltiplas linhas e pings. Pontos ásperos incluem um parser JSON personalizado para arquivos de sessão em vez de serde_json, pontos de entrada de CLI sobrepostos, padrões hardcoded e estimativa ingênua de tokens (comprimento da string / 4).

Camada Python — majoritariamente scaffold (3/10)

A camada Python é limpa para dataclasses e auditorias de paridade, mas grande parte dela é composta por stubs, ferramentas simuladas e caminhos remotos/SSH vazios. O valor em runtime hoje está na camada Rust.

Scorecard de paridade de recursos

Implementado

• Loop central de conversa agentic
• Seis ferramentas MVP (bash, read, write, edit, glob, grep)
• Cliente de streaming da API com SSE
• Persistência e compaction de sessão

Parcialmente implementado

• Enforcements de permissão (framework sem prompt interativo completo)
• Construção do system prompt (estrutura sem injeção dinâmica completa)
• Mesclagem de arquivos de configuração (user / project / local)

Não implementado

• Cliente e transporte MCP
• Spawn de subagent / ferramenta Agent
• Bridge com IDE via LSP ou extensões
• Sistema de skills, hooks, ferramentas de web search
• Budgeting de contexto mais inteligente e tooling de custo
• Ferramentas de leitura de notebook e PDF

O que isso nos ensina sobre a arquitetura de agentes de IA

Além da comparação linha a linha entre Claw Code vs Claude Code, o projeto no GitHub é um artefato útil para builders:

• O loop é a parte fácil. “Chamar o modelo → interpretar ferramentas → executar → devolver” é simples. O poder vem de MCP, subagents, hooks, skills e bridges com IDE.
• Streaming importa. Esperar até a conclusão completa parece quebrado para agentes em CLI; o trabalho SSE do Claw Code é o componente mais reutilizável.
• Permissões são requisito básico para ferramentas de shell e arquivos.
• Contexto ainda é difícil. A compaction ingênua funciona até deixar de funcionar; sistemas de produção precisam de retenção seletiva e disciplina de budget.

Veredito

O Claw Code captura cerca de 20–25% da superfície funcional do Claude Code. A camada Rust — cliente de API, loop, ferramentas de arquivo — é o núcleo valioso. A camada Python documenta principalmente a intenção de portabilidade.

Como um estudo de claw code github e do que um espelho não oficial no estilo Claude Code open source pode mostrar, ele é bem-sucedido. Como um substituto direto para o Claude Code, precisaria de muito trabalho adicional nas camadas de MCP, orquestração e integração.

Quem deveria explorar o Claw Code no GitHub?

Escolha o Claw Code quando você quiser:

• Ler uma implementação concreta open source de loops de ferramentas e clientes SSE no estilo Anthropic
• Ensinar ou pesquisar arquitetura de agentes de codificação com IA sem depender de código fechado
• Fazer fork de uma base Rust-first e investir em MCP por conta própria

Quem deve continuar com o Claude Code?

Fique com o Claude Code da Anthropic quando você precisar de MCP, subagents, extensões de IDE, hooks, skills e um caminho de produto com suporte — e não de um protótipo de pesquisa.

Por que considerar o Eigent como uma opção open source mais ampla

Se seu objetivo é automação open source além de um único agente de codificação de terminal, Eigent é um coworker open source multi-agent com fluxos de trabalho de desktop, skills e múltiplos provedores de modelo — complementar à leitura do Claw Code para entender a mecânica de agentes em baixo nível.

FAQ

O que é o Claw Code no GitHub?

Claw Code é um projeto open source que faz engenharia reversa de partes do Claude Code usando uma CLI em Rust e uma camada de metadata em Python. O repositório é github.com/instructkr/claw-code.

O Claude Code é open source?

Não. O Claude Code é proprietário. O Claw Code é um projeto open source independente inspirado no comportamento do Claude Code; ele não é um release da Anthropic.

O Claw Code é um substituto completo para o Claude Code?

Não hoje. As lacunas críticas incluem MCP, orquestração de subagents, integração com IDE e o pipeline completo de ferramentas e prompts.

Em quais linguagens o Claw Code foi escrito?

Principalmente Rust para o runtime (~4k linhas) e Python para o scaffold (~1.5k linhas). O Claude Code em si é um produto fechado em TypeScript/Node.

Por que a ausência de MCP importa?

MCP é como o Claude Code estende ferramentas dinamicamente. Sem ele, a superfície de ferramentas do Claw Code permanece fixa, o que limita fluxos de trabalho do mundo real.

Principais aprendizados

• Claw Code GitHub = clone parcial open source e educacional; Claude Code = produto proprietário completo.
• O loop central, o cliente de streaming, as ferramentas de arquivo e as permissões no Claw Code são instrutivos; MCP, subagents e camadas de IDE ainda não estão lá.
• Pesquisar por claude code open source deve levar você a projetos como o Claw Code — referências úteis, não substitutos completos.