Verificando acesso...

MÓDULO 1.3

📁 Anatomia: .claude/ vs .codex/

Onde tudo mora: skills, agents, settings, hooks. Mapa lado a lado dos dois mundos pra vocĂȘ bater o olho e saber onde mexer.

6
TĂłpicos
35
Minutos
BĂĄsico
NĂ­vel
PrĂĄtico
Tipo
1

📂 Estrutura do .claude/

A pasta .claude/ Ă© onde Claude Code procura tudo do projeto. Convenção sobre configuração — nĂŁo precisa apontar paths.

.claude/
├── skills/                 # SKILL.md (markdown + YAML)
│   ├── revisar-pr/
│   │   └── SKILL.md
│   └── deploy-check/
│       └── SKILL.md
├── agents/                 # Subagents (markdown + YAML frontmatter)
│   ├── pr-reviewer.md
│   └── test-runner.md
├── hooks/                  # Scripts de evento
│   ├── pre-edit.sh
│   └── post-tool.sh
├── settings.json           # Config (commit)
└── settings.local.json     # Config local (gitignore)

Regra: settings.json commitado (regras pro time), settings.local.json NO .gitignore (suas preferĂȘncias pessoais).

2

📁 Estrutura do .codex/

A pasta .codex/ tem filosofia diferente: TOML ao invés de markdown. Mais explícito, menos amigåvel visualmente.

.codex/
├── config.toml             # Config (TOML)
└── agents/                 # Subagents (TOML, um por arquivo)
    ├── pr-reviewer.toml
    └── test-runner.toml

.agents/                    # SKILLS ficam fora — padrão aberto
└── skills/
    └── revisar-pr/
        └── SKILL.md

📊 Diferença sutil mas importante

Skills no Codex moram em .agents/skills/ (nĂŁo em .codex/skills/) — Ă© o padrĂŁo aberto Agent Skills, entĂŁo qualquer agente (Cursor, Gemini) tambĂ©m encontra ali.

3

đŸ€ Skills: o lado bom

SKILL.md Ă© o ponto de convergĂȘncia. Mesmo arquivo funciona em Claude Code, Codex CLI, Cursor e Gemini CLI. É o Agent Skills standard.

Anatomia de SKILL.md:

---
name: revisar-pr
description: Revisa PR aberto procurando regressÔes, código duplicado e cobertura faltante
allowed-tools: [Read, Grep, Bash]
disable-model-invocation: false
---

# Skill: Revisar PR

Quando invocada, faça:
1. Liste arquivos mudados (git diff main...HEAD --name-only)
2. Para cada um, analise diff procurando:
   - FunçÔes sem teste
   - Imports nĂŁo usados
   - Edge cases nĂŁo cobertos
3. Retorne markdown com seçÔes "Críticos", "SugestÔes", "Nits"

Investimento amortizado: escreva uma vez, usa em qualquer agente. Maior alavancagem prĂĄtica do curso.

4

⚡ Agents: o lado divergente

Subagents Ă© onde os formatos divergem mais. Claude usa markdown puro (corpo = system prompt). Codex usa TOML com campo explĂ­cito.

Claude: pr-reviewer.md

---
name: pr-reviewer
description: Revisa PRs
tools: [Read, Bash]
---

VocĂȘ revisa PRs procurando
regressÔes e código duplicado.

Sempre retorne markdown com:
- CrĂ­ticos
- SugestÔes
- Nits

Codex: pr-reviewer.toml

name = "pr-reviewer"
description = "Revisa PRs"
model = "gpt-5-pro"
sandbox_mode = "read-only"
developer_instructions = """
VocĂȘ revisa PRs procurando
regressÔes e código duplicado.

Sempre retorne markdown com:
- CrĂ­ticos
- SugestÔes
- Nits
"""

Mesma informação, formatos diferentes: markdown body vira developer_instructions. YAML frontmatter vira campos TOML. ConversĂŁo Ă© determinĂ­stica — IA faz por vocĂȘ.

5

🌍 Global vs projeto

Ambos suportam 2 escopos. Cada um serve a um propósito — confundir gera duplicação ou conflito.

PathEscopoO que vai
~/.claude/skills/GlobalSkills genéricas (revisão, formatação, doc)
./.claude/skills/ProjetoSkills especĂ­ficas (deploy desse projeto)
~/.codex/agents/GlobalSubagents pessoais
./.codex/agents/ProjetoSubagents do time

Regra de precedĂȘncia: projeto sobrescreve global. Se vocĂȘ tem skill deploy em ambos, a do projeto vence.

6

đŸ—ș Cheat sheet de conversĂŁo

A tabela pra colar na parede. Bate o olho, sabe onde mexer.

Claude Code↔Codex CLI
CLAUDE.md↔AGENTS.md
.claude/skills/↔.agents/skills/
.claude/agents/X.md↔.codex/agents/X.toml
settings.json↔config.toml
.claude/hooks/⚠(sem equivalente)
/agents↔spawn (manual)

⚠ Atenção: hooks

Claude tem hooks programåveis (PreToolUse, PostToolUse, SessionStart) que Codex NÃO tem equivalente direto. Se seu workflow depende muito de hooks, mantenha Claude pra esse caso ou modele como skill invocåvel.

📚 Resumo do Módulo

✓
.claude/ tem skills, agents, hooks, settings
✓
.codex/ tem config.toml + agents/*.toml
✓
Skills moram em .agents/skills/ (padrĂŁo aberto)
✓
Markdown (Claude) vs TOML (Codex) — mesma informação
✓
Global vs projeto: projeto sobrescreve
✓
Hooks nĂŁo tĂȘm paridade — Ășnico ponto sem conversĂŁo

PrĂłxima Trilha:

T2 Dicas Práticas — começa convertendo um projeto Claude → Codex de verdade

← Módulo anterior Próxima trilha: Dicas Práticas →