Neste post separo os comandos que mais fazem sentido num homelab, pelo que diz a documentação oficial, e mostro como criar um comando seu.

Como os comandos funcionam #

Pela documentação, um comando só é reconhecido no começo da mensagem. O que vem depois do nome vira argumento. Se você manda um comando enquanto o Claude Code está respondendo, ele entra na fila e roda quando a resposta termina. Alguns, como /status e /usage, rodam na hora.

Digite / e algumas letras para filtrar o menu.

Para retomar e organizar sessões #

• /resume: retoma uma conversa pelo nome ou pelo ID, ou abre a lista de sessões. É o que uso sempre que volto a um projeto.
• /clear: começa uma conversa nova, com o contexto vazio. Dá para passar um nome, que aparece depois na lista do /resume.
• /remote-control: deixa a sessão disponível no claude.ai, para continuar pelo navegador. O atalho é /rc. Uso quando preciso mandar um arquivo, por exemplo.
• /export: exporta a conversa como texto. Bom para guardar o registro do que foi feito num servidor.

Para cuidar do contexto #

Sessão longa enche o contexto, e o Claude Code passa a esquecer o começo da conversa. Três comandos ajudam:

• /context: mostra o uso do contexto como uma grade colorida, com sugestões do que está pesando.
• /compact: resume a conversa até aqui para liberar espaço, sem começar do zero. Aceita instruções, como /compact mantenha os comandos que rodamos no container do DNS.
• /btw: faz uma pergunta paralela sobre a sessão sem entrar na conversa. Bom para tirar uma dúvida rápida sem gastar contexto.

Para regras e permissões #

São os que mais importam num servidor. Falei das regras que dou ao Claude Code no post Claude Code no homelab: as regras.

• /init: cria um CLAUDE.md para o projeto, o arquivo de instruções carregado no começo de toda sessão.
• /memory: edita os arquivos CLAUDE.md e mostra as anotações da memória automática.
• /permissions: abre as regras de permissão: o que é liberado, o que pede confirmação e o que é proibido.
• /plan: entra no modo de planejamento. O Claude Code propõe o que vai fazer antes de mexer. Aceita uma descrição, como /plan atualizar o container do Vaultwarden.

Para ver e desfazer mudanças #

• /diff: mostra as mudanças na pasta de trabalho, incluindo o que o Claude Code editou.
• /rewind: volta a conversa e os arquivos editados para um ponto anterior. Os atalhos são /checkpoint e /undo.

Para conferir a instalação e o uso #

• /status: versão, modelo, conta e conexão.
• /model: troca o modelo de IA.
• /usage: custo da sessão e limites do plano. /cost e /stats são atalhos.
• /doctor: confere instalação, configurações e CLAUDE.md, e propõe correções, que só são aplicadas depois que você confirma.
• /help: a ajuda e a lista de comandos.

Criando um comando seu #

Dá para criar comandos próprios. A documentação chama de skill: uma pasta com um arquivo SKILL.md. Para valer em todos os projetos, ela fica em ~/.claude/skills/. Para valer só num projeto (e ir para o git), em .claude/skills/.

Um exemplo simples, para ver o estado de um serviço:

---
name: servico
description: Mostra o estado e os últimos logs de um serviço systemd
disable-model-invocation: true
---

Mostre o estado do serviço $ARGUMENTS com systemctl status e as últimas 30 linhas
do journalctl dele. Não reinicie nem altere nada; só leia e resuma o que encontrar.

Salvo como ~/.claude/skills/servico/SKILL.md, ele vira o comando /servico. Digitando /servico caddy, o $ARGUMENTS é trocado por caddy. A linha disable-model-invocation: true faz o comando rodar só quando eu chamo.

O formato antigo, um arquivo em .claude/commands/, ainda funciona, mas a documentação recomenda o de skills para coisas novas.

Resumindo #

• / no começo da mensagem abre o menu de comandos.
• Sessões: /resume, /clear, /remote-control e /export.
• Contexto: /context, /compact e /btw.
• Regras: /init, /memory, /permissions e /plan.
• Mudanças: /diff e /rewind, que não desfaz o que já rodou no servidor.
• Comandos próprios são skills em ~/.claude/skills/<nome>/SKILL.md.

Os meus fixos são o /resume e o /remote-control. Para quem está começando, eu diria que conhecer meia dúzia dos outros, principalmente os de contexto e de permissões, já muda o dia a dia com o Claude Code num servidor.