Apothem versus a configuração manual do Claude Code
Manter à mão toda a árvore de configuração nativa do Claude Code versus gerenciá-la através do perfil compartilhado do Apothem.
O Claude Code (do fabricante Anthropic) mantém sua configuração nativa em
~/.claude/. O adaptador claude-code do Apothem é o adaptador de superfície
completa: ele propaga o corpus compartilhado diretamente para essa árvore. Esta
página contrasta manter a configuração à mão com gerenciá-la com o Apothem.
Comparação de esforço
| Tarefa | Configuração manual | Gerenciada pelo Apothem |
|---|---|---|
| Escrever regras, agentes, comandos, skills | Editar cada superfície em ~/.claude/ à mão | Escrever uma vez no corpus compartilhado |
| Manter output-styles e statuslines | Editar à mão por superfície | Propagados do corpus compartilhado |
| Configurar hooks | Editar à mão as entradas de hook de settings.json | Propagados (PreToolUse/PostToolUse/Stop/SessionStart) |
| Manter a configuração alinhada com outros harnesses | Manual, por ferramenta | Automático no apothem update |
| Verificar se a configuração está correta | Inspeção manual | apothem verify --harness claude-code |
O que o Apothem gerencia
O adaptador propaga regras, agentes, comandos, skills, output-styles,
statuslines e settings.json para ~/.claude/. Os hooks nativos PreToolUse,
PostToolUse, Stop e SessionStart são configurados a partir do corpus
compartilhado.
O Apothem grava um único bloco gerenciado, delimitado por sentinelas, no seu ~/.claude/CLAUDE.md, no escopo de usuário. O apothem update reescreve apenas esse bloco e mantém o seu texto fora dele. Os arquivos CLAUDE.md de projeto não são tocados. O Apothem governa as superfícies propagadas ao redor dele.
Caminho de migração
- Execute
apothem profile initpara criar o perfil compartilhado, caso ainda não o tenha. - Mova suas regras, agentes, comandos e skills existentes de
~/.claude/para o corpus compartilhado. - Deixe o
CLAUDE.mdonde está. O Apothem mantém o seu texto fora do bloco gerenciado dele e reescreve apenas esse bloco. - Execute
apothem install --harness claude-codepara propagar o corpus. - Execute
apothem verify --harness claude-codepara confirmar que a configuração foi gravada. - Use
apothem update --harness claude-codepara cada mudança posterior.
Leia a seguir
Apothem versus outros frameworks de harness
Como o Apothem se compara a ferramentas de configuração de um único harness, gerenciadores de dotfiles e configuração manual por ferramenta como abordagens para gerenciar configurações de assistentes com IA.
Apothem versus a configuração manual do Cursor
Manter à mão as regras MDC do Cursor sob .cursor/rules/ versus renderizá-las a partir do perfil compartilhado do Apothem.