my-friends-claude - Plugin para personalizar as mensagens de saída e a UX do Claude Code
(github.com/hundong2)Claro que as mensagens exibidas pelo Claude já são boas, mas achei que seria legal ter um plugin para criar minhas próprias mensagens com um clique, então fiz e estou compartilhando~
my-friends-claude 🤝
É um marketplace de plugins para personalizar as mensagens de saída e a UX do Claude Code. Basta editar um único config.json para mudar saudações da sessão, mensagens de trabalho, barra de status, estilos de resposta e muito mais com os textos que você quiser.
Um marketplace de plugins do Claude Code para personalizar mensagens e UX. Edite um único config.json para mudar saudações da sessão, barra de status, estilos de resposta e mais.
Instalação (Installation)
Instalar pelo marketplace (recomendado)
Execute os comandos abaixo dentro do Claude Code:
1. Adicionar o marketplace
/plugin marketplace add hundong2/my-friends-claude
2. Instalar o plugin
/plugin install my-friends-claude@my-friends-claude
Instalação manual
git clone https://github.com/hundong2/my-friends-claude.git
claude --plugin-dir ./my-friends-claude/plugins/my-friends-claude
Áreas que podem ser personalizadas
Área Descrição
1 Estilo de resposta Alterar o tom/idioma das respostas do Claude (estilo amigo, conciso, mentor)
2 Barra de status Personalizar a barra de informações na parte inferior do terminal
3 Saudação/encerramento da sessão Mensagens personalizadas no início/fim
4 Persona por prompt Injeção de idioma/persona a cada entrada
5 Feedback de uso de ferramentas Aviso de git push, mensagens de resultado de teste etc.
6 Notificações Personalizar o título das notificações no desktop
7 Regras de comportamento padrão Instruções persistentes de comportamento
8 Verbos do spinner Alterar textos de carregamento como "✽ Effecting…" para coreano
Uso (Usage)
Comandos slash
/my-friends-claude:show-config # Ver a configuração atual
/my-friends-claude:set-style # Alterar estilo
/my-friends-claude:set-message # Alterar mensagem
/my-friends-claude:apply-spinner # Aplicar/restaurar verbos do spinner
/my-friends-claude:status # Dashboard de status do plugin
Tipos de estilo
friendly-korean — estilo coreano amigável (informal, emoji, tom amistoso)
concise — estilo conciso (formal, só o essencial, sem emoji)
mentor — estilo mentor (formal, focado em explicação, incentiva aprendizado)
Personalização dos verbos do spinner
É possível trocar para coreano os textos do spinner que o Claude Code exibe durante o trabalho, como ✽ Effecting… e ✽ Thinking….
/my-friends-claude:apply-spinner # Aplicar spinner em coreano
/my-friends-claude:apply-spinner restore # Restaurar para o inglês original
Após aplicar, ao reiniciar o Claude Code, a exibição muda para algo como ✽ pensando…, ✽ criando… etc.
Os 56 verbos originais e suas correspondências em coreano estão organizados em config/config.json em spinnerVerbs._original_mapping.
Original (inglês) Coreano Significado
Thinking pensando Ação básica de raciocínio
Working esforçando-se Execução do trabalho
Crafting criando Produção caprichada
Cooking cozinhando Metáfora de “cozinhar” código
Clauding fazendo Claude Verbo próprio do Claude
Vibing entrando no clima Gíria para acompanhar o clima
... ... (total de 56, consulte config.json)
Exemplo de config.json
{
"language": "ko",
"activeStyle": "friendly-korean",
"persona": { "name": "Claude Amigo", "emoji": true },
"messages": {
"session_start": "Oi! Vamos mandar ver juntos hoje também! 🚀",
"session_end": "Bom trabalho hoje! Até a próxima! 👋",
"working": "Criando com dedicação! 🔨",
"thinking": "Hmm... pensando... 🤔",
"error_occurred": "Ops, apareceu um problema. Vamos resolver juntos! 💪",
"task_complete": "Concluído! O que vamos fazer agora? ✅",
"git_push_warning": "⚠️ Vamos conferir mais uma vez antes de dar push?",
"test_passed": "Teste aprovado! 🎉",
"test_failed": "Teste falhou... vamos corrigir juntos! 🔧"
}
}
Estrutura de diretórios
my-friends-claude/
├── .claude-plugin/
│ └── marketplace.json # Manifesto do marketplace
├── plugins/
│ └── my-friends-claude/
│ ├── .claude-plugin/plugin.json # Manifesto do plugin
│ ├── config/config.json # Configuração das mensagens (editável pelo usuário)
│ ├── styles/ # Output Styles
│ │ ├── friendly-korean.md
│ │ ├── concise.md
│ │ └── mentor.md
│ ├── skills/ # Comandos slash
│ │ ├── set-style/SKILL.md
│ │ ├── show-config/SKILL.md
│ │ ├── set-message/SKILL.md
│ │ ├── apply-spinner/SKILL.md
│ │ └── status/SKILL.md
│ ├── hooks/ # Scripts de hook
│ │ ├── hooks.json
│ │ ├── session-start.sh
│ │ ├── prompt-submit.sh
│ │ ├── stop.sh
│ │ ├── pre-tool-use.sh
│ │ └── notification.sh
│ ├── scripts/ # Scripts utilitários
│ │ ├── statusline.sh
│ │ ├── read-config.sh
│ │ └── spinner-manage.sh
│ └── rules/CLAUDE.md # Regras de comportamento padrão
├── LICENSE
└── README.md
Remoção (Uninstall)
/plugin uninstall my-friends-claude@my-friends-claude
/plugin marketplace remove my-friends-claude
Os verbos do spinner são aplicados automaticamente no início da sessão e restaurados automaticamente no fim da sessão. Ao remover o plugin, os hooks deixam de ser executados a partir da próxima sessão, então todas as personalizações voltam automaticamente ao estado original.
Dependências (Dependencies)
jq (recomendado) — parsing de JSON. Se não existir, usa python3 como fallback
git — para exibir a branch na barra de status
Licença (License)
MIT License
Ainda não há comentários.