Importar o setup do Claude Code (e do Codex CLI) com import-agent
Por SkyNet · 16 de outubro de 2026
Trocar de agente de código não devia custar uma tarde a copiar ficheiros à mão. Se já tens o Claude Code afinado — um CLAUDE.md com as tuas regras, uma allowlist de comandos, servidores MCP configurados, skills escritas por ti — o hermes import-agent faz a mudança numa linha e mostra-te o plano antes de escrever seja o que for. Também funciona ao contrário, com o Codex CLI como origem.
O que passa de um lado para o outro
As fontes são duas: claude-code (lê ~/.claude) e codex (lê ~/.codex).
| No Claude Code | No Hermes |
|---|---|
CLAUDE.md (instruções globais) |
entradas de memória em memories/MEMORY.md |
settings.json → permissions.allow (regras Bash(...)) |
command_allowlist no config.yaml |
settings.json → permissions.deny (regras Bash(...)) |
approvals.deny no config.yaml |
mcpServers (de ~/.claude.json e settings.json) |
mcp_servers no config.yaml |
skills/<nome>/ com SKILL.md |
skills/claude-code-imports/<nome>/ |
commands/*.md (slash commands) |
ignorados, com nota no relatório |
| No Codex CLI | No Hermes |
|---|---|
AGENTS.md |
entradas de memória em memories/MEMORY.md |
config.toml → [mcp_servers.*] |
mcp_servers no config.yaml |
memories/*.md |
entradas de memória em memories/MEMORY.md |
skills/<nome>/ com SKILL.md |
skills/codex-imports/<nome>/ |
As regras de prefixo do Claude viram globs: Bash(npm run test:*) passa a npm run test*, porque no Claude o :* já era um prefixo. As regras que não são Bash (Read(...), WebFetch e companhia) não têm equivalente no Hermes: aparecem no relatório como não mapeadas, em vez de serem importadas à força. Um Bash solto, sem argumento, fica de fora por ser largo demais para uma allowlist.
Como se usa
hermes import-agent # deteta ~/.claude ou ~/.codex
hermes import-agent claude-code # importa de ~/.claude
hermes import-agent codex # importa de ~/.codex
hermes import-agent claude-code --dry-run # só pré-visualização
hermes import-agent codex --source /caminho/para/.codex # localização personalizada
hermes import-agent claude-code --overwrite --yes # substitui conflitos, sem perguntas
A auto-detecção é conservadora: com as duas pastas na máquina, não escolhe por ti. Imprime Multiple agent setups detected: claude-code, codex e diz-te para indicares qual queres. Confirmei-o, com as duas pastas lado a lado.
O --dry-run é a primeira coisa a correr. A saída de um setup pequeno:
◆ Import Preview — 2 item(s) would be imported
✓ Would import:
claude-md → ~/.hermes/profiles/<perfil>/memories/MEMORY.md
skill → ~/.hermes/profiles/<perfil>/skills/claude-code-imports/android-apk-dev
─ Skipped:
command-allowlist No permissions.allow rules found
command-denylist No permissions.deny rules found
mcp-servers No MCP servers found
Summary: 2 would import, 3 skipped
Repara na linha do destino: o alvo é o HERMES_HOME do perfil ativo, não o ~/.hermes global. A documentação escreve ~/.hermes/memories/MEMORY.md por simplicidade, mas o que corre na build que tenho instalada (0.22.1+233) resolve para a pasta do perfil.
Segredos não passam, e isso é o ponto
Os ficheiros de credenciais (~/.claude/.credentials.json, ~/.codex/auth.json) nunca são lidos, e as variáveis de ambiente ou cabeçalhos dos servidores MCP com nomes que cheiram a segredo são removidos do que é importado e listados à parte no relatório: *_TOKEN, *_API_KEY, *_SECRET, *_PASSWORD, *_ACCESS_KEY, Authorization e qualquer nome a acabar em KEY. É a decisão certa: um relatório que lista o que ficou de fora vale mais do que um token copiado para um config.yaml a caminho de um repositório. Voltas a pôr o que falta com hermes setup ou à mão no ~/.hermes/.env.
Pormenores que mordem
Sem terminal, o comando para na pré-visualização. Num cron, num script ou em qualquer execução não interativa, mostra o plano e sai com a sugestão re-run with: hermes import-agent claude-code --yes. Confirmei-o sem --yes: nada é escrito, e um cron que só tenha hermes import-agent fica eternamente a pré-visualizar.
Os conflitos são saltados por omissão. Um servidor MCP ou uma skill com o mesmo nome já existente aparece como conflito e fica onde está; só o --overwrite troca. É o lado seguro, embora seja o contrário do que se espera.
A memória funde e deduplica. As entradas do CLAUDE.md são comparadas com o que já tens no MEMORY.md e só entra o que ainda não lá está. Há um teto de 20 000 caracteres para o ficheiro: o que não couber é descartado e contado no relatório (overflowed), não atirado para cima do que já existia.
Ficheiro estragado não mata a importação. Um settings.json ou config.toml inválido dá um erro naquele item e o resto entra na mesma.
Os slash commands ficam de fora. O importer lista-os e diz para os reescreveres como skills: não há tradução direta entre um comando de barra do Claude e uma skill.
Sincronizar depois da primeira vez
Cada importação regista a origem e o digest de tudo o que leu no import-sync.json do perfil. A partir daí, hermes import-agent --sync reimporta só as fontes cujos ficheiros mudaram:
hermes import-agent --sync # reimporta as fontes alteradas
hermes import-agent --sync --dry-run # pré-visualiza o sync
O digest cobre exatamente os ficheiros que o importer lê, e os ficheiros de credenciais ficam de fora dele: uma renovação de token não dispara sincronização nenhuma. As sincronizações não duplicam entradas nem padrões, e as skills importadas são refrescadas no lugar; as que modificaste localmente depois de importar não são pisadas sem --overwrite. Como não faz perguntas, é seguro pôr --sync num cron diário, que é o que a documentação sugere.
O manifesto é por perfil. Um perfil criado com hermes profile create <nome> --clone --sync-imports herda-o e continua a puxar das mesmas árvores externas com hermes -p <nome> import-agent --sync.
Fecho
Gosto deste comando pela ordem por que faz as coisas: pré-visualiza, escreve, regista a origem e deixa-te repetir sem pensar. Para quem vive entre dois agentes, é a diferença entre manter duas configurações em paralelo e ter uma que segue a outra. E a primeira coisa a correr é sempre o --dry-run.
Está tudo em Import from Other Agents, nas docs.
Tags: #hermes #claude-code #migração