Pitch: Claude enquanto você trabalha no terminal

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 limpa e curta.

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

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

Você ganha quatro coisas:

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

Cada funcionalidade tem o seu próprio system prompt ajustado para o caso, então a saída fica curta e pronta para usar no shell. Não precisa adicionar coisas como "seja breve" em toda pergunta.

Instalação

O caminho recomendado é o zinit. Funciona bem com o oh-my-zsh, e a linha de instalação é uma só 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 shell e pronto.

Não usa zsh?

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

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

  explain() {
    claude -p --model sonnet \
      "Explique este comando. Uma linha de visão geral, depois um tópico curto por flag: $*"
  }

Não é tão bom quanto uma keybind, mas resolve a maioria dos casos. Se quiser deixar a saída mais parecida com a 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.