🟢 Básico e instalación

🟢 Qué es

O Claude Code es el agente de codificación de Anthropic que se ejecuta en tu terminal. No es autocompletado ni chat: lee tu proyecto, planifica, edita archivos, ejecuta comandos y pruebas, usa git y navega por la web — siempre pidiendo tu aprobación. Tú hablas en portugués; él ejecuta.

💡 Por qué aprender

A diferencia de pegar código desde un chat, Claude Code trabaja dentro del repositorio real — entiende todo el contexto mediante CLAUDE.md, respeta tu stack y funciona en cualquier sistema. Es la base de todo lo que viene en las próximas rutas.

🔑 Dónde puedes usarlo

🟢 Qué es

Instalación vía npm. Requisitos previos: Node.js 18+ y, en Windows, Git Bash. El inicio de sesión es por suscripción (Pro/Max mediante el navegador) o por API key de Anthropic.

💡 Por qué aprender

Una versión desactualizada de Node causa fallas silenciosas. En Windows, Claude Code no funciona sin Git Bash: es el error n.º 1 de quienes empiezan. Seguir el orden correcto evita el 90% de los problemas de instalación.

🔑 Paso a paso (orden correcto)

# 1. Instale o Git (inclui o Git Bash) → git-scm.com/download/win
# 2. Instale o Node.js LTS → nodejs.org
# 3. Confira:
node -v
npm -v
# 4. Instale o Claude Code:
npm install -g @anthropic-ai/claude-code
# 5. Rode:
claude

brew install node
npm install -g @anthropic-ai/claude-code
claude

sudo apt update && sudo apt install -y nodejs npm
npm install -g @anthropic-ai/claude-code
claude

# Dentro do claude, rode:
/login        # abre o navegador → conta Pro/Max (recomendado)

# OU, via API key (pague por uso):
setx ANTHROPIC_API_KEY "sk-ant-..."   # Windows
export ANTHROPIC_API_KEY="sk-ant-..." # macOS/Linux

🟢 Qué es

Tú ejecutas claude dentro de la carpeta del proyecto y escribe la solicitud en lenguaje natural. Propone ediciones como diffs que apruebas o rechazas. @ hace referencia a archivos y # guarda algo en la memoria.

💡 Por qué aprender

El miedo a que «desordene mi código» desaparece cuando entiendes el ciclo de aprobación: nada cambia sin que veas el diff. Esc interrumpe de inmediato si toma un rumbo equivocado.

🔑 Conceptos clave

cd meu-projeto
claude                          # abre o modo interativo
claude "corrija o bug do login" # pedido direto
claude -p "resuma o README"     # print mode: responde e sai (scripts)

🟢 Qué es

Comandos que empiezan con / controlan la sesión (no el proyecto). Escribe / y mira la lista. Los más usados administran el contexto — el recurso más escaso de una sesión.

💡 Por qué aprender

/clear e /compact son lo que mantiene la sesión rápida y económica. Sin ellos, el contexto se llena, Claude se vuelve lento y «olvida» el comienzo. (La ruta 3 profundiza en esto.)

🔑 Los esenciales

🟢 Qué es

Presionando Shift+Tab tú alternas entre los modos de la sesión. En modo de planificación (plan mode), Claude investiga y propone un plan — pero no edita nada hasta que tú lo apruebes.

💡 Por qué aprender

En tareas grandes o arriesgadas, dejar que "se ponga a editar" es una receta para tener que rehacer el trabajo. Planificar primero ayuda a definir el camino. El preset opusplan usa Opus (más potente) para planificar y Sonnet (más económico/rápido) para ejecutar: calidad donde importa, ahorro en el resto.

🔑 Los 3 modos (Shift+Tab los recorre)

/model opusplan   # Opus planeja, Sonnet executa

🟢 Qué es

O CLAUDE.md es un archivo en la raíz del proyecto con el contexto permanente: cómo ejecutarlo, convenciones, reglas, qué no hacer. El comando /init genera uno para ti analizando el repo. La carpeta .claude/ guarda ajustes, comandos, agentes y skills.

💡 Por qué aprender

Sin CLAUDE.md, Claude empieza desde cero en cada sesión y repite los mismos errores. Con él, respeta tu stack y estilo desde el primer prompt. Es la inversión de 5 minutos que mejora todas las sesiones siguientes.

🔑 Jerarquía de la memoria

# Projeto X
- Stack: Next.js + TypeScript + pnpm
- Rodar: `pnpm dev` · Testar: `pnpm test`
- Convenção: componentes em PascalCase, sem default export
- NUNCA commitar direto na main

Atajo: escribe # sua regra en la sesión para adjuntar algo al CLAUDE.md en el momento.

🟢 Qué es

De forma predeterminada, Claude pide permiso antes de editar archivos o ejecutar comandos. Tú defines listas de allow / deny e o modo de permiso. El comando /permissions administra todo.

💡 Por qué aprender

El permiso es tu cinturón de seguridad. Permite comandos seguros (p. ej.: npm test) reduce los clics; pero nunca usa bypass en máquinas con datos sensibles o en producción.

🔑 Modos de permisos

/permissions          # abre o gerenciador
# em .claude/settings.json:
# "permissions": { "allow": ["Bash(npm test)"], "deny": ["Bash(rm -rf *)"] }

🟢 Qué es

Tú usas Claude Code mediante suscripción (Pro/Max — uso incluido) o por API (paga por token). /cost muestra el gasto de la sesión. La elección del modelo es lo que más influye en el costo y la velocidad.

💡 Por qué aprender

Usar Opus para todo es caro e innecesario. Sonnet resuelve el día a día; Opus, lo difícil; opusplan combina los dos. Junto con /compact e /clear, tú controlas el gasto.

🔑 Modelos: cuándo usar cada uno

/cost                       # gasto da sessão
/model sonnet               # troca pro Sonnet
claude --model "opus[1m]"   # abre com contexto de 1M