12 dicas de customização do criador do Claude Code

• Partindo da ideia de que cada engenheiro usa ferramentas de um jeito diferente, o Claude Code foi projetado desde o início para oferecer ótimos padrões e alto grau de liberdade para customização ao mesmo tempo
• Do tema do terminal, notificações e modo Vim até agentes, plugins, MCP e skills, quase todo o comportamento pode ser ajustado pelo usuário
• Há suporte para 37 itens de configuração e 84 variáveis de ambiente, e ao versionar o settings.json no Git é possível compartilhar as configurações com todo o time
• É possível ajustar com bastante detalhe desde verbos do spinner até a barra de status e o estilo de saída, maximizando a experiência do desenvolvedor (DX)

---

Configurações do terminal

• É possível alternar entre os temas claro/escuro com o comando /config
• É possível ativar notificações do iTerm2 ou usar hooks de notificação personalizados
• Ao usar o terminal da IDE, Apple Terminal, Warp ou Alacritty, executar /terminal-setup permite quebrar linha com shift+enter (sem precisar digitar barra invertida)
• Ative o modo Vim com o comando /vim
• Optimize your terminal setup

Ajuste do nível de effort

• É possível escolher o nível de effort com o comando /model
  • Low: usa menos tokens e responde mais rápido
  • Medium: comportamento equilibrado
  • High: usa mais tokens, mas oferece um nível maior de inteligência
• Boris usa High para todas as tarefas

Instalação de plugins, MCP e skills

• Por meio de plugins, é possível instalar LSP (compatível com todas as principais linguagens), MCP, skills, agentes e hooks personalizados
• É possível instalar pelo marketplace oficial de plugins da Anthropic ou criar diretamente um marketplace interno da empresa
• Ao fazer check-in do settings.json na base de código, o marketplace é adicionado automaticamente para o time
• Comece com o comando /plugin
• Discover and install prebuilt plugins through marketplaces

Criação de agentes personalizados

• Ao adicionar arquivos .md ao diretório .claude/agents, é possível criar agentes personalizados
• Para cada agente, é possível definir individualmente nome, cor, conjunto de ferramentas, ferramentas previamente permitidas/bloqueadas, modo de permissões e modelo
• Também é possível definir um agente padrão com o campo "agent" no settings.json ou com a flag --agent (um recurso pouco conhecido)
• Comece com o comando /agents
• Create custom subagents

Pré-aprovação de permissões

• O Claude Code usa um sistema de permissões que combina detecção de prompt injection, análise estática, sandboxing e supervisão humana
• Por padrão, apenas alguns comandos seguros são pré-aprovados, e é possível adicionar listas de permissão/bloqueio com /permissions
• Há suporte à sintaxe com curingas — por exemplo: Bash(bun run *), Edit(/docs/**)
• É possível compartilhar isso fazendo check-in no settings.json do time
• Configure permissions

Ativação do sandboxing

• Com o runtime de sandbox open source do Claude Code, é possível aumentar a segurança e ao mesmo tempo reduzir prompts de permissão
• A ativação é feita com o comando /sandbox, e ele roda na máquina local
• Há suporte tanto para isolamento de arquivos quanto de rede
• Suporte a Windows em breve
• Sandboxing

Adição de barra de status

• A barra de status personalizada é exibida logo abaixo do composer
• Dá para montar livremente as informações desejadas, como nome do modelo, diretório, contexto restante e custo
• Cada integrante do time do Claude Code usa uma barra de status diferente
• Ao executar /statusline, o Claude gera automaticamente a barra de status com base em .bashrc/.zshrc
• Customize your status line

Customização de atalhos de teclado

• Todos os atalhos de teclado do Claude Code podem ser remapeados com /keybindings
• As configurações são recarregadas em tempo real, então dá para verificar na hora

Configuração de hooks

• Hooks são uma forma de intervir de maneira determinística no ciclo de vida do Claude
• Exemplos de uso:
  • Rotear automaticamente solicitações de permissão para Slack ou Opus
  • Dar um empurrão para o Claude continuar ao fim do turno (com execução por agente ou julgamento baseado em prompt)
  • Pré-processar/pós-processar chamadas de ferramentas — por exemplo, adicionar logging personalizado
• Hooks reference

Customização dos verbos do spinner

• É possível adicionar ou substituir seus próprios verbos na lista padrão do spinner
• Ao fazer check-in do settings.json no controle de versão, isso pode ser compartilhado com o time

Configuração do estilo de saída

• Ao configurar o estilo de saída em /config, é possível alterar o tom e o formato das respostas do Claude
• Estilo "explanatory": ao explorar uma nova base de código, trabalha explicando o framework e os padrões de código
• Estilo "learning": orienta as mudanças no código em formato de mentoria
• Também é possível criar diretamente um estilo de saída personalizado
• Output styles

Customização completa

• O Claude Code foi projetado para funcionar bem no estado padrão, mas ao customizar é recomendável versionar o settings.json no Git para compartilhar com o time
• As configurações podem ser aplicadas por base de código, subpasta, usuário individual ou até no nível de política corporativa
• Há suporte a 37 itens de configuração e 84 variáveis de ambiente
• Usando o campo "env" do settings.json, é possível configurar variáveis de ambiente sem scripts wrapper
• Claude Code settings

[onestone]

Claude Code é o futuro..!

[roxie]

É o futuro!!

[shakespeares]

É o futuro!!