Skip to content

README_PT.md

Latest commit

 

History

History
416 lines (305 loc) · 12.2 KB

README_PT.md

File metadata and controls

416 lines (305 loc) · 12.2 KB
Raw

English | 中文 | Français | Русский | हिन्दी | العربية | Português

🚀 Claude Code Python

Uma Reimplementação Completa em Python Baseada no Código Fonte Real do Claude Code

Do Código Fonte TypeScript → Reconstruído em Python com ❤️

GitHub stars GitHub forks License: MIT Python 3.10+

🔥 Desenvolvimento Ativo • Novos Recursos Semanalmente 🔥

🎯 O Que É Isso?

Claw Codex é uma reescrita completa em Python do Claude Code, baseada no código fonte TypeScript real.

⚠️ Importante: Isso NÃO É Apenas Código Fonte

Diferente do código fonte TypeScript vazado, Claw Codex é uma ferramenta CLI totalmente funcional:

Core Features Showcase
Bash Execution
Real-time Tool Execution
Web Fetch
Instant Web Content Extraction
File Operations
Seamless Coding & Debugging
Skills (Slash Commands)
Flexible Skill Systems

CLI Real • Uso Real • Comunidade Real

  • ✅ CLI Funcional — Não é apenas código, mas uma ferramenta de linha de comando totalmente funcional que você pode usar hoje
  • ✅ Baseado no Código Real — Portado da implementação TypeScript real do Claude Code
  • ✅ Máxima Fidelidade — Preserva a arquitetura original enquanto otimiza
  • ✅ Python Nativo — Código Python limpo e idiomático com anotações de tipo completas
  • ✅ Amigável ao Usuário — Configuração fácil, REPL interativo, documentação abrangente
  • ✅ Continuamente Melhorado — Tratamento de erros aprimorado, testes, documentação

🚀 Experimente agora! Faça fork, modifique, torne seu! Pull requests são bem-vindos!

🌿 Compressão de tokens /eco — -80% medidos na saída do Bash

Ative /eco e o ClawCodex comprime a renderização enviada ao modelo de cada resultado do Bash com filtros determinísticos portados do RTK: resumos de testes focados nas falhas, remoção de cerimônia (git/pip/npm), deduplicação de logs e truncamento recuperável — a saída bruta completa fica em disco atrás de uma dica executável. Garantia nunca pior: uma compressão que não supera a renderização bruta é descartada, e linhas de erro sempre sobrevivem.

Medido (tokens tiktoken cl100k_base) em 27 operações reais reproduzidas pelo pipeline de produção:

Operação Bruto /eco Ganho
pytest (com falhas) 1,347 390 -71%
git clone --progress 6,868 18 -99%
ls -R src 9,088 225 -97%
log show --last 90s (34k linhas) 10,512 1,977 -81%
Corpus completo (27 operações) 92,989 17,767 -80%

Tabelas completas e metodologia: eval/eco/.

⭐ Star History

Star History Chart

✨ Recursos

Suporte Multi-Provedor

providers = [
    # Protocolos nativos / específicos
    "anthropic", "minimax", "deepseek", "zai", "openrouter", "openai", "gemini",
    # Provedores compatíveis com OpenAI
    "nvidia-nim", "atlascloud", "wanjie-ark", "volcengine", "xiaomi-mimo",
    "novita", "fireworks", "siliconflow", "siliconflow-cn", "arcee", "moonshot",
    "huggingface", "together", "stepfun", "deepinfra",
    # Servidores locais (nenhuma chave de API necessária)
    "ollama", "vllm", "sglang",
]  # 25 provedores; aliases como nim, kimi, hf são resolvidos automaticamente

REPL Interativo

>>> Olá!
Assistant: Oi! Sou o Claw Codex, uma reimplementação em Python...

>>> /help         # Mostrar comandos
>>> /             # Mostrar comandos e skills
>>> /save         # Salvar sessão
>>> /multiline    # Modo multilinha
>>> Tab           # Auto-completar
>>> /explain-code qsort.py   # Executar um skill

Skills (Slash Commands)

See README.md for a quick tutorial on creating skills under .clawcodex/skills/<skill-name>/SKILL.md.

CLI Completo

clawcodex --dangerously-skip-permissions              # Iniciar REPL
clawcodex login        # Configurar API
clawcodex --version    # Verificar versão
clawcodex config       # Ver configurações

📊 Status

Componente Status Quantidade
Comandos ✅ Completo 150+
Ferramentas ✅ Completo 100+
Cobertura de Testes ✅ 90%+ 75+ testes
Documentação ✅ Completa 10+ docs

🚀 Início Rápido

Instalar

# Instalar pelo PyPI (recomendado). O pacote se chama clawcodex-cli,
# mas o comando instalado continua sendo `clawcodex`.
pipx install clawcodex-cli
# Ou: uv tool install clawcodex-cli
# Ou em um ambiente virtual ativado: pip install clawcodex-cli

clawcodex --help

Para desenvolver a partir do código-fonte:

git clone https://github.com/agentforce314/clawcodex.git
cd clawcodex

# Criar venv (uv recomendado)
uv venv --python 3.11
source .venv/bin/activate

# Instalar o pacote e as ferramentas de desenvolvimento
uv pip install -e ".[dev]"

O arquivo de configuração é salvo em ~/.clawcodex/config.json. Exemplo mínimo:

{
  "default_provider": "deepseek",
  "providers": {
    "deepseek": {
      "api_key": "xxx-xxx",
      "base_url": "https://api.deepseek.com",
      "default_model": "deepseek-v4-pro"
    }
  },
  "env": {
    "TAVILY_API_KEY": "tvly-YOUR-TAVILY-API-KEY"
  }
}

Nota: TAVILY_API_KEY é necessário para a ferramenta WebSearch — obtenha uma chave em tavily.com.

Os blocos session, settings e env são opcionais — valores padrão razoáveis se aplicam quando omitidos (estrutura completa abaixo).

Configurar

Opção 1: Interativo (Recomendado)

python -m src.cli login

Este processo irá:

  1. pedir que você escolha um provedor: anthropic / openai / gemini / zai / minimax / openrouter / deepseek, ou qualquer provedor compatível com OpenAI (together, novita, fireworks, moonshot, nvidia-nim, siliconflow, deepinfra, huggingface, …) e servidores locais (ollama / vllm / sglang)
  2. pedir a chave API desse provedor
  3. salvar opcionalmente uma URL base personalizada
  4. salvar opcionalmente um modelo padrão
  5. definir o provedor selecionado como padrão

O arquivo de configuração é salvo em ~/.clawcodex/config.json. Exemplo de estrutura:

{
  "default_provider": "deepseek",
  "providers": {
    "anthropic": {
      "api_key": "your-api-key",
      "base_url": "https://api.anthropic.com",
      "default_model": "claude-sonnet-4-6"
    },
    "openai": {
      "api_key": "your-api-key",
      "base_url": "https://api.openai.com/v1",
      "default_model": "gpt-5.4"
    },
    "zai": {
      "api_key": "your-api-key",
      "base_url": "https://api.z.ai/api/coding/paas/v4",
      "default_model": "glm-5.2"
    },
    "minimax": {
      "api_key": "your-api-key",
      "base_url": "https://api.minimaxi.com/anthropic",
      "default_model": "MiniMax-M2.7"
    },
    "openrouter": {
      "api_key": "your-api-key",
      "base_url": "https://openrouter.ai/api/v1",
      "default_model": "deepseek/deepseek-v4-pro"
    },
    "deepseek": {
      "api_key": "your-api-key",
      "base_url": "https://api.deepseek.com",
      "default_model": "deepseek-v4-pro"
    }
  },
  "session": {
    "auto_save": true,
    "max_history": 100
  },
  "settings": {
    "advisor_enabled": false,
    "advisor_model": "claude-sonnet-4-6",
    "advisor_client_mode": false,
    "advisor_provider": "openai"
  },
  "env": {
    "TAVILY_API_KEY": "tvly-YOUR-TAVILY-API-KEY"
  }
}

Executar

python -m src.cli          # Iniciar REPL
python -m src.cli --help   # Mostrar ajuda

É isso! Comece a conversar com IA em 3 passos.

💡 Uso

Comandos REPL

Comando Descrição
/help Mostrar todos os comandos
/save Salvar sessão
/load <id> Carregar sessão
/multiline Alternar modo multilinha
/clear Limpar histórico
/exit Sair do REPL

Exemplo de Sessão

Exemplo de Sessão

🎓 Por Que Claw Codex?

Baseado no Código Fonte Real

  • Não é um clone — Portado da implementação TypeScript real
  • Fidelidade arquitetural — Mantém padrões de design comprovados
  • Melhorias — Melhor tratamento de erros, mais testes, código mais limpo

Python Nativo

  • Dicas de tipo — Anotações de tipo completas
  • Python moderno — Usa recursos 3.10+
  • Idiomático — Código Python limpo

Focado no Usuário

  • Configuração em 3 passos — Clonar, configurar, executar
  • Configuração interativa — clawcodex login guia você
  • REPL rico — Completar com tab, destaque de sintaxe
  • Persistência de sessão — Nunca perca seu trabalho

📦 Estrutura do Projeto

Claw-Codex/
├── src/
│   ├── cli.py           # Entrada CLI
│   ├── config.py        # Configuração
│   ├── repl/            # REPL interativo
│   ├── providers/       # Provedores LLM
│   └── agent/           # Gerenciamento de sessão
├── tests/               # 75+ testes
└── docs/                # Docs completos

🗺️ Roteiro

  • MVP Python
  • Suporte multi-provedor
  • Persistência de sessão
  • Auditoria de segurança
  • Sistema de chamada de ferramentas
  • Pacote PyPI
  • Versão Go

🤝 Contribuindo

Nós acolhemos contribuições!

# Configuração rápida de dev
pip install -e .[dev]
python -m pytest tests/ -v

Veja CONTRIBUTING.md para diretrizes.

📖 Documentação

⚡ Performance

  • Inicialização: < 1 segundo
  • Memória: < 50MB
  • Resposta: Streaming (tempo real)

🔒 Segurança

✅ Auditoria de Segurança Realizada

  • Sem dados sensíveis no Git
  • Chaves API criptografadas na configuração
  • Arquivos .env ignorados
  • Seguro para produção

📄 Licença

Licença MIT — Veja LICENSE

🙏 Agradecimentos

  • Baseado no código fonte TypeScript do Claude Code
  • Projeto educacional independente
  • Não afiliado à Anthropic

🌟 Mostre Seu Apoio

Se você acha isso útil, por favor dê uma star ⭐ no repo!

Feito com ❤️ pela equipe Claw Codex

⬆ Voltar ao Topo