Um só regendo todos os seus projetos.

O Cláudio Maestro é um app web local para acompanhar e conduzir várias sessões do Claude ao mesmo tempo, em projetos diferentes, numa tela só. Ele roda na sua máquina, abre no navegador e conversa com o Claude pelo Claude Agent SDK em Python.

Nasceu de dois incômodos: a extensão do VSCode é pesada e presa a um projeto por vez, e no terminal fica difícil ler diffs, saídas de comando e saber qual sessão está esperando por você.

Não, não foi engano do tradutor. O Cláudio é brasileiro: a interface é em português, a documentação também, e assim vai continuar. Aqui se escreve "commitar" sem culpa, se toma um cafezinho enquanto o agente roda os testes e se considera deploy na sexta-feira uma falta de amor-próprio.

Se você não lê português, o tradutor do navegador dá conta, e o próprio Claude também. Pull requests de quem chegou pelo tradutor são muito bem-vindos.

• Todos os projetos numa tela. Menu lateral com cada projeto, suas branches e suas conversas.
• Estado de relance. Cada conversa está rodando, esperando você ou finalizada, com ícone próprio além da cor. O que pede a sua atenção aparece primeiro.
• Leitura confortável. Respostas em markdown, o diff de cada edição, comandos com a saída, tabelas e blocos de código legíveis.
• Você decide pela interface. Permissões (permitir uma vez, sempre ou negar), perguntas do Claude e aprovação de planos.
• Git sempre à vista. A branch de cada repositório do projeto, inclusive worktrees, e as alterações de cada conversa.
• Continuidade com o CLI. As conversas ficam em ~/.claude/projects, como no CLI e na extensão. Dá para retomar no Maestro uma conversa começada no terminal, e vice-versa.
• Controles por conversa. Modelo, nível de raciocínio, modo de permissão, imagens coladas, comandos / e menções @.
• Resumo das conversas. Um agente do próprio app pode resumir em fases o que cada conversa em andamento já fez.

O que ele não é, de propósito: IDE, terminal embutido, editor de código ou árvore de arquivos.

• Linux ou macOS (no Windows não foi testado)
• Python 3.13 e uv
• Node 22.12 ou mais novo e pnpm
• git
• No Linux, o zenity (opcional) abre o seletor de pastas nativo. Sem ele, o app usa o navegador de pastas próprio
• Claude Code instalado e autenticado na máquina

git clone https://github.com/vateiixeira/claudio-maestro.git
cd claudio-maestro
uv sync
pnpm --dir frontend install
uv run claudio-maestro

Abra http://localhost:6660.

Na primeira execução, e sempre que o frontend mudar (depois de um git pull, por exemplo), o comando compila o frontend antes de subir. Para usar outra porta: uv run claudio-maestro --port 7000.

O Cláudio Maestro não faz login e não guarda credenciais. Ele usa a autenticação que o Claude Code já tem na sua máquina, do mesmo jeito que o CLI usa.

A Anthropic orienta que produtos de terceiros feitos com o Agent SDK usem autenticação por chave de API (ANTHROPIC_API_KEY). Escolha a forma de autenticação de acordo com os termos que valem para a sua conta.

As portas precisam estar entre 1024 e 65535, fora de 6665 a 6669 (os navegadores bloqueiam essas). O app escuta só em 127.0.0.1, sempre.

O comando que abre arquivos no editor (padrão: code) fica nas Preferências do app.

O app executa comandos na sua máquina pelo Claude, então qualquer site aberto no seu navegador é uma ameaça a ele. Por isso ele escuta só em 127.0.0.1, recusa Host e Origin de fora, não libera CORS, exige um cabeçalho próprio em toda chamada à API e só aceita caminhos dentro dos projetos cadastrados.

Não exponha o app na rede. Detalhes e como relatar uma falha em SECURITY.md.

• Interface só em português.
• Windows não testado.
• Acesso só local, por uma pessoa.

Veja CONTRIBUTING.md. O que pode vir pela frente está no ROADMAP.md, e o que mudou em cada versão no CHANGELOG.md.

MIT.

O Cláudio Maestro é um projeto independente. Não é afiliado, endossado nem patrocinado pela Anthropic. Claude é marca registrada da Anthropic, PBC.