Descrição
O Caderno de Agentes é um proxy local que fica entre um agente de codificação, Claude Code ou Codex, e o modelo subjacente. Ele adiciona uma chamada de ferramenta extra a cada solicitação: um espaço para o modelo pensar em voz alta antes de responder, anotando a decisão que está tomando, as alternativas que considerou e o custo de cada opção. O objetivo declarado do projeto é permitir que um desenvolvedor verifique se o plano declarado de um agente corresponde ao que ele realmente faz.
Ler mais
O proxy é executado localmente através do Docker Compose e expõe um painel em 127.0.0.1:8080, onde cada anotação é transmitida à medida que o modelo a escreve, com sessões CLI separadas mantidas em linhas distintas. O Claude Code aponta para o proxy configurando ANTHROPIC_BASE_URL para o endereço local; o Codex é configurado através de um provedor de modelo personalizado. Um modo de continuidade opcional mantém anotações anteriores disponíveis entre chamadas de ferramentas dentro da mesma rodada (ativado por padrão para Codex e habilitado para Claude Code com uma flag de ambiente explícita uma vez que tenha sido verificado contra a versão instalada do Claude Code), com limites configuráveis sobre contagem de sessões, memória e tempo limite ocioso.
O projeto documenta seus próprios custos de forma clara. Como faz uma chamada extra ao modelo para cada rodada, e até quatro quando o modelo continua escrevendo anotações, isso aproximadamente dobra o uso de tokens de entrada e adiciona centenas a milhares de tokens de saída por rodada, e uma resposta não começa a ser transmitida até que a chamada de anotação oculta termine, podendo levar até 60 segundos. Também avisa que uma anotação do caderno é uma saída de modelo comum, portanto, uma chave de API ou segredo colado pode aparecer em uma.
O Caderno de Agentes não lê nem expõe o raciocínio interno protegido de um modelo; as anotações são produzidas através de uma chamada de ferramenta comum, a mesma que qualquer outro argumento de ferramenta que um modelo pode escrever. Nada é escrito em disco, a menos que o operador defina um caminho de arquivamento, e a documentação do projeto pede explicitamente aos usuários que não o utilizem para coletar ou treinar com rastros de raciocínio dos modelos da Anthropic ou da OpenAI. É lançado sob a licença Apache 2.0 e afirma que não está afiliado a nenhuma das empresas.
É um pequeno projeto de código aberto, desenvolvido por um único desenvolvedor, voltado para desenvolvedores que usam Claude Code ou Codex e desejam visibilidade sobre o raciocínio de um agente durante uma sessão de codificação, em vez de um produto para usuários não técnicos.
- CategoriaCriadores de agentes de IA
- Modelo de preçosCódigo aberto
- ImplantaçãoAuto-hospedado
- PlataformasWeb
Recursos principais de Caderno de Agentes
Proxy local adiciona uma chamada de ferramenta "pensar em voz alta" a cada solicitação do Claude Code / Codex
Painel ao vivo (127.0.0.1:8080) transmitindo cada anotação à medida que é escrita
Linhas separadas por sessão CLI no painel
Continuidade opcional entre solicitações que mantém anotações anteriores disponíveis dentro de uma rodada
Limites de continuidade configuráveis (contagem de sessões, tamanho da memória, tempo limite ocioso)
Funciona tanto com Claude Code (via ANTHROPIC_BASE_URL) quanto com Codex (via configuração de provedor personalizado)
Executa totalmente localmente via Docker Compose; nada escrito em disco, a menos que configurado
Licença de código aberto Apache 2.0
Primeiros passos com Caderno de Agentes
Clone o repositório: Obtenha o projeto do GitHub (softcane/agents-workbook).
Inicie o proxy: Execute docker compose up -d --build.
Abra o painel: Visite 127.0.0.1:8080 e mantenha a aba aberta.
Aponte seu CLI para o proxy: Defina ANTHROPIC_BASE_URL para Claude Code ou configure as configurações do provedor de modelo do Codex.
Trabalhe normalmente: Use Claude Code ou Codex e observe seu raciocínio sendo transmitido para o painel.
Ative a continuidade (opcional): Defina WORKBOOK_CONTINUITY_CLAUDE_ENABLED=true para manter as anotações disponíveis entre chamadas de ferramentas para Claude Code.
Casos de uso de Caderno de Agentes
- Auditoria de plano versus ação
- Revisão de sessão de codificação
- Depuração local
