zsh-claude-code: Claude enquanto você trabalha no terminal

Terminal mostrando o prompt do zsh-claude-code perguntando como remover todas as branches locais do git menos a main, com o plugin pensando em como fazer isso.

Eu queria o Claude enquanto trabalho no terminal. Digitar uma pergunta, receber uma resposta. Colar um comando, ver o que ele faz. Sem digitar claude -p e escrever o mesmo system prompt toda vez para conseguir uma resposta curta e limpa.

A maioria das ferramentas de “IA no terminal” quer uma API key, mas eu já estou logado no Claude Code nesta máquina, eu só queria usar esse login.

Então eu construí o zsh-claude-code. Por baixo dos panos ele envolve a CLI do claude no modo --print. Se o claude login funciona, o plugin funciona. Nada mais para configurar.

demo do zsh-claude-code

Você ganha quatro coisas:

ask <pergunta>: uma resposta curta para qualquer dúvida de dev ou de terminal.
explain <comando>: o que um comando faz, explicado de forma direta.
Ctrl+X: digite um pedido em linguagem natural, aperte o atalho, e a linha é reescrita ali mesmo como um comando de shell.
Alt+E: imprime uma explicação do comando que está no seu prompt, acima dele. O comando fica onde está.

Cada funcionalidade tem o seu próprio system prompt ajustado para a tarefa, então a saída continua curta e pronta para o shell. Sem precisar adicionar coisas como “seja breve” em toda pergunta.

Instalação

O caminho recomendado é o zinit. Ele funciona bem com o oh-my-zsh, e a linha de instalação é uma tag no ~/.zshrc:

zinit light matheus-poli/zsh-claude-code

Se você prefere o oh-my-zsh puro, clone na pasta de plugins customizados e adicione zsh-claude-code ao seu array plugins=(...):

git clone https://github.com/matheus-poli/zsh-claude-code \
  "${ZSH_CUSTOM:-$HOME/.oh-my-zsh/custom}/plugins/zsh-claude-code"

Reinicie o seu shell e pronto.

Não usa zsh?

Os widgets precisam do editor de linha do zsh (zle), então os atalhos não vão junto. Mas ask e explain são wrappers finos sobre o claude -p com um system prompt ajustado, fáceis de imitar no bash. Coloque algo assim no ~/.bashrc:

ask() {
  claude -p --model sonnet "$*"
}

explain() {
  claude -p --model sonnet \
    "Explain this command. One overview line, then a short bullet per flag: $*"
}

Não é tão bom quanto um atalho, mas cobre o caso comum. Se você quiser chegar mais perto do estilo de saída do plugin, os system prompts completos ficam em zsh-claude-code.plugin.zsh, copie o que quiser.

É isso. Código no GitHub: matheus-poli/zsh-claude-code. Issues e PRs são bem-vindos.