O que você vai aprender
Da terminologia básica aos fluxos avançados de quem trabalha com os dois agentes em paralelo.
Mapa mental claro
A diferença real entre CLAUDE.md e AGENTS.md, .claude/ e .codex/, sem decoreba.
Anatomia de cada runtime
Skills, agents, hooks, settings, MCP — onde cada peça mora em cada ecossistema.
Conversão sem perder nada
Prompt-template para migrar um projeto de Claude Code pra Codex (e vice-versa) em minutos.
polyskill na prática
Uma fonte canônica, dois outputs otimizados. CLI completo: init, build, import, reconcile.
Workflow lado a lado
Dois terminais, um projeto. Como passar contexto de um agente pro outro sem perder o fio.
Tool-agnostic
Não fique preso a um ecossistema. Se um cai, o outro segue. Se um trava, o outro destrava.
Trilhas do curso
6 trilhas independentes — pegue a que mais faz sentido pro seu momento.
🧱 Fundamentos
O que é Claude Code, o que é Codex, por que usar os dois e nunca depender de um só.
Começar trilha →🔷 Anatomia do Claude Code
CLAUDE.md, .claude/, skills com YAML, sub-agents, hooks e settings.
🟣 Anatomia do Codex
AGENTS.md, .codex/, .agents/, agents em TOML e openai.yaml.
🟡 Convertendo seu projeto
Prompt-template, manutenção sincronizada e armadilhas comuns ao rodar os dois.
Começar trilha →🦜 polyskill — skills cross-runtime
Uma definição source, outputs otimizados pra cada runtime. Round-trip Claude ↔ Codex, drift policy, CLI completo.
Começar trilha →🌹 Fluxos avançados
Session handoff, dois terminais no mesmo projeto, MCP compartilhado e governança.
Começar trilha →Cheat sheet — Claude Code vs Codex
Mesmo conhecimento, nomes diferentes. Este é o quadro que aparece em quase toda aula.
💡A grande sacada
Conhecimento do projeto é compartilhado — documentos, scripts, referências. Só os arquivos de configuração mudam de nome e formato. Quem entende esse mapa migra entre runtimes em minutos, não em dias.
Pra quem é este curso
✓ É pra você se…
- ✓Já usa Claude Code (ou Codex) e quer aprender o outro sem reaprender tudo
- ✓Quer rodar os dois agentes no mesmo projeto sem duplicar conteúdo
- ✓Cria skills/sub-agents e cansa de manter duas versões à mão
- ✓Quer ficar tool-agnostic e parar de depender de um ecossistema só
✗ Não é pra você se…
- ✗Procura tutorial introdutório de "o que é um LLM"
- ✗Quer comparativo de modelo (GPT vs Claude). Aqui é sobre runtime, não modelo.
- ✗Espera que o curso decida por você qual ferramenta é "melhor"
Pronto pra começar?
Se nunca viu nenhum dos dois, comece pela Trilha 1. Se já é fluente nos dois, vai direto pra Trilha 5 (polyskill) — é o pulo do gato.