Monitore sessões do Claude Code, do Codex e de outros agentes de programação com IA no seu Mac
O OneMacTools permite monitorar sessões do Claude Code e do Codex no seu Mac, além de Gemini CLI, Aider, Cursor Agent e opencode. A aba Agentes de Dev e agentes mostra cada sessão em execução com o projeto, tudo o que ela iniciou (servidores de dev, executores de testes, builds), a memória, a CPU e as portas que ocupa, quanto dos seus limites de uso do Codex e do Claude Code já foi usado, e um botão Parar que encerra a sessão inteira de forma limpa.
Nesta página
Por que monitorar seus agentes de programação?
Um agente de programação com IA não só escreve código. Ele inicia coisas: um servidor de dev para conferir o trabalho, um observador de testes, um build de TypeScript, um script Python que nunca termina. Feche a aba do terminal e muitos deles continuam rodando. Depois de um dia com dois ou três agentes, é comum encontrar um gigabyte de memória e meia dúzia de portas ocupadas por processos que ninguém lembra de ter iniciado.
O Monitor de Atividade os mostra como uma lista simples de entradas node e python, sem nenhuma pista de a qual agente ou projeto pertencem. Dev e agentes os reagrupa em sessões, para você ver que o Claude Code em storefront-web é responsável por quatro processos, 1,18 GB e a porta 3000.
Abra Dev e agentes em Seu Mac na barra lateral (ou Ir › Dev e agentes); Agentes é a primeira aba. As outras abas, para servidores de dev, Docker e pastas de build, são explicadas em Gerenciar servidores de dev e portas.
Quais agentes de IA são detectados
O OneMacTools reconhece estes agentes de linha de comando pelo nome do programa ou pela forma como foram iniciados:
| Agente | Reconhecido por |
|---|---|
| Claude Code | O comando claude ou o pacote @anthropic-ai/claude-code |
| Codex | O comando codex ou o pacote @openai/codex |
| Gemini CLI | O comando gemini ou o pacote @google/gemini-cli |
| Aider | O comando aider ou python -m aider |
| Cursor Agent | cursor-agent |
| opencode | O comando opencode |
Não importa onde eles foram iniciados: Terminal, iTerm, o terminal do VS Code, Cursor ou o app Claude para desktop. O chip De em cada sessão mostra o nome do app.
Quando nenhum está rodando, você verá Nenhum agente de IA em execução. As sessões aparecem enquanto rodam e somem quando terminam.
O que cada cartão de sessão mostra
- O agente e o projeto: Claude Code storefront-web. O projeto é a pasta mais próxima com um
package.json,.git,Cargo.tomlou arquivo de projeto semelhante; o caminho completo aparece abaixo. - do Terminal (ou do app que o iniciou).
- Chips de porta como :3000, para até três portas ocupadas pelo agente ou por algo que ele iniciou.
- em execução há 2 h 12 min · 4 processos: quanto tempo desde que começou, e o agente mais o que ele iniciou.
- Memória em letras grandes e CPU abaixo, somando a sessão inteira.
- Iniciou N processos: expanda para ver cada comando, seu ID de processo e sua memória (até 40).
As sessões aparecem das mais novas para as mais antigas. A memória vem da própria contabilidade do macOS; a CPU é a parte de um núcleo usada desde a última leitura, então uma sessão em 150% está usando um núcleo e meio.
Subagentes e hosts
Quando um agente inicia outro do mesmo tipo na mesma pasta (um subagente), os processos dele são contados na sessão do agente principal, e não como um cartão separado. Um processo de agente que só hospeda sessões em outras pastas, rodando a partir da sua pasta pessoal ou de /, não é contado como sessão, então os apps de desktop que rodam o Claude Code para você não criam um cartão fantasma.
Como parar uma sessão do Claude Code ou do Codex
Às vezes você quer se livrar de um agente, junto com tudo o que ele iniciou: ele está em loop, está ocupando uma porta de que você precisa, ou você já terminou e o terminal foi fechado há tempos.
- Clique em Parar… no cartão da sessão.
- Leia a confirmação, por exemplo Parar esta sessão do Claude Code? com Para o agente e os 3 processos que ele iniciou, liberando a porta 3000. O trabalho não salvo na sessão pode ser perdido.
- Clique em Parar. Uma linha verde confirma quantos processos pararam.
O OneMacTools pede a cada processo que encerre, começando pelos filhos mais novos e terminando no agente, com o mesmo sinal educado de pressionar Ctrl-C. Os arquivos que o agente já gravou ficam como estão, e o Claude Code e o Codex mantêm suas transcrições, então geralmente você consegue retomar depois. Só seus próprios processos são tocados, e cada um é verificado para garantir que é o mesmo programa que foi listado.
Para parar só um servidor que um agente iniciou e deixar o agente rodando, use Parar… nesse servidor na aba Servidores de dev.
Alertas quando o processo de um agente sai do controle
O OneMacTools também observa o que os agentes iniciam, a cada 30 segundos, mesmo com a tela fechada. Quando um processo usa um núcleo inteiro por 10 minutos, cresce um gigabyte em uma hora ou fica ocioso em uma porta por um dia, você recebe uma notificação com um botão Parar. O agente em si nunca é parado por esses alertas. Defina ou desative a parada automática em Ajustes › Processos Descontrolados (referência de ajustes).
Limites de uso do Codex e do Claude Code
Acima das sessões, Limites de uso mostra o quanto você está perto de ser bloqueado. Isso é lido dos próprios arquivos de sessão dos agentes no seu Mac, a partir da última sessão, e só as linhas sobre limites são lidas, nunca suas conversas.
Codex: porcentagem usada
O Codex registra seus limites enquanto roda, então você recebe números reais: uma linha para o limite de 5 horas e outra para o limite semanal, cada uma com uma barra, 38% usado e quando reinicia. A barra fica verde, laranja a partir de 70% e vermelha a partir de 90%.
Depois que o horário de reinício passa, o valor antigo não diz mais nada, então a linha mostra Reiniciado com quando, e a próxima sessão vai mostrar quanto foi usado.
Claude Code: quando um limite foi atingido
O Claude Code não registra quanto resta do limite, só quando você atinge um e quando ele é reiniciado. Por isso, a linha dele mostra uma destas opções:
- Limite de 5 horas atingido · reinicia às 13h: você está limitado agora, até esse horário.
- Sem limite agora · atingiu o limite semanal ontem: você foi limitado antes, mas o limite já foi reiniciado.
- Nenhum limite atingido nas sessões recentes. O Claude Code não registra quanto resta do limite, só quando um é atingido.
Se o Codex estiver instalado mas ainda não tiver registrado um limite, a linha dele diz Nenhum limite registrado ainda; ele aparece após a próxima sessão. Clique em Atualizar na barra de ferramentas para ler os limites de novo.
Em que isso difere do Monitor de Atividade e do ps
Monitor de Atividade / ps | Dev e agentes | |
|---|---|---|
| Agrupamento | Uma lista simples de processos | Um cartão por sessão de agente, com tudo o que ela iniciou |
| Projeto | Não mostrado | A pasta do projeto em que cada sessão roda |
| Portas | Precisa do lsof | Aparece no cartão |
| Como parar | Um processo por vez | O agente e todos os processos filhos de uma vez, dos mais novos para os mais antigos |
| Limites de uso | Não disponível | Porcentagem usada do Codex; limites atingidos e reinícios do Claude Code |
Para o Mac inteiro, incluindo apps e processos do sistema, use a Saúde do Mac. Dev e agentes é propositalmente mais restrito: seus próprios processos de desenvolvimento, nada mais.
Agentes verificando agentes (MCP)
Seus agentes também podem ver isso. Pelo servidor MCP do OneMacTools, Claude Code, Codex, Cursor e outros podem listar as sessões de agentes com o que elas iniciaram, verificar limites de uso e ver o que está em uma porta antes de iniciar um servidor próprio. Qualquer coisa que mude o seu Mac continua precisando da sua aprovação (permissões de assistentes).
Dev e agentes faz parte do OneMacTools; consulte os preços para ver o que cada plano inclui, ou baixe o app para experimentar.
Perguntas
Como vejo quais processos o Claude Code iniciou?
Abra Dev e agentes no OneMacTools e fique na aba Agentes. Cada sessão do Claude Code tem um cartão; expanda Iniciou N processos para ver cada comando que ela iniciou, com o ID do processo e a memória, e as portas que eles ocupam.
Como verifico meu limite de 5 horas e o semanal do Codex em um Mac?
Abra Dev e agentes › Agentes. Limites de uso mostra os limites de 5 horas e semanal do Codex, com a porcentagem usada e quando cada um é renovado, lidos dos próprios arquivos de sessão do Codex na última sessão.
O OneMacTools mostra quanto resta do meu limite do Claude Code?
Não, porque o Claude Code não registra isso no seu Mac. Ele registra quando você atinge um limite e quando ele é reiniciado, então o OneMacTools mostra se você está limitado agora e quando atingiu pela última vez o limite de 5 horas ou o semanal.
Parar uma sessão apaga o trabalho do agente?
Não. Os arquivos que ele gravou continuam no disco, e a transcrição do agente é mantida, então o Claude Code e o Codex geralmente conseguem retomar. Trabalho não salvo dentro da sessão, como uma edição pela metade, pode se perder.
O OneMacTools lê as conversas dos meus agentes?
Não. Para os limites de uso, ele procura nos arquivos de sessão dos agentes só as linhas sobre limites de uso e nunca decodifica o resto. Os cartões de sessão vêm da lista de processos, não das transcrições.
Por que uma sessão de agente mostra uma porta?
Algo que o agente iniciou, normalmente um servidor de dev ou de pré-visualização, está escutando nessa porta. Parar a sessão a libera; para manter o agente e liberar só a porta, pare esse servidor na aba Servidores de dev.
