La mayoría de las guías "primeros pasos con Claude Code" se quedan en npm install. Eso no es empezar. Eso es solo instalar un binario.

La verdadera pregunta es: ¿cómo configuras tu terminal para que darle un objetivo a un agente sea más fácil que escribir el código tú mismo?

A eso lo llamo el flujo antigravedad. Una vez lo tienes, dejas de buscar el autocompletado. La delegación se vuelve la opción por defecto.

Paso 1 — Instalar (30 segundos)

# Requiere Node.js >= 18
npm install -g @anthropic-ai/claude-code

# Verificar
claude --version

Eso es todo. Sin panel SaaS, sin baile de OAuth, sin extensión de IDE que depurar. La primera vez que ejecutas claude en un proyecto, te pide tu API key de Anthropic y la guarda en ~/.claude/.

Paso 2 — Inicializar el proyecto

En la raíz de tu proyecto:

cd my-project
claude

# Dentro del prompt de Claude
> /init

/init crea una carpeta .claude/ con:

• settings.json — modelo, max tokens, permisos de herramientas.
• CLAUDE.md — el "system prompt" del proyecto (se lee en cada sesión).
• agents/ — definiciones de sub-agentes que vas creando con el tiempo.

Esa carpeta es la funcionalidad más infrautilizada de Claude Code. La mayoría deja CLAUDE.md vacío. Es el equivalente a contratar a un ingeniero senior y olvidarte de contarle qué hace tu producto.

Paso 3 — Escribir un CLAUDE.md de verdad

Un buen CLAUDE.md es más corto de lo que crees. Tres secciones:

# Contexto del proyecto
- Qué es el producto, en 2 frases.
- Stack: framework, versión del lenguaje, librerías clave.
- Dónde se despliega (Vercel / AWS / on-prem).

# Convenciones
- Comando de tests: `pnpm test`
- Comando de lint: `pnpm lint`
- "Nunca modificar archivos en `app/_generated/`."

# Definition of done
- Todos los tests pasan, lint limpio, sin `console.log` en producción.

Claude Code lee este archivo al inicio de cada sesión. En el fondo estás enviando una ventana de contexto permanente.

Paso 4 — El hábito antigravedad

Este es el cambio de flujo que me llevó de "la IA es un juguete" a "la IA entrega features":

El cambio clave: la terminal es el IDE. Lo que revisas es el diff, no el archivo. Dejas de leer código de arriba abajo; lees diffs.

Paso 5 — Los permisos que sí quieres

Por defecto Claude Code pregunta antes de ejecutar comandos shell. Tras tu primera sesión te tentará poner --yes a todo. No lo hagas.

En su lugar, edita .claude/settings.json:

{
  "tools": {
    "shell": {
      "allow": [
        "pnpm test",
        "pnpm lint",
        "pnpm build",
        "git status",
        "git diff *",
        "ls *",
        "rg *"
      ],
      "deny": [
        "rm -rf *",
        "git push *",
        "npm publish *"
      ]
    }
  }
}

Este es el punto dulce: el agente ejecuta cualquier cosa no destructiva sin preguntar, pero nunca toca lo irreversible.

Paso 6 — Slash commands que deberías tener desde el día uno

De serie tienes /init, /agents, /compact, /clear, /help. Los dos que más uso:

• /compact — cuando la ventana de contexto empieza a hincharse, reescribe el resumen manteniendo intactas las decisiones. Es la diferencia entre una sesión de 4 horas y una sesión de 4 mensajes.
• /agents — abre el selector de sub-agentes. Profundizamos en esto en el artículo 5.

Añade tus comandos personalizados en .claude/commands/ más adelante en la serie — la mayoría de equipos acaban construyendo al menos un /review, un /test-and-fix y un /release-notes cuando ya tienen soltura.

Qué significa "antigravedad" de verdad

El nombre lo tomé de un amigo que dijo: "Una vez Claude Code está bien configurado, el trabajo no me cae encima. Flota."

En concreto, eso se traduce en tres cosas:

• Dejas de microgestionar. Das un objetivo, no una lista de pasos.
• Confías en el bucle. Leer, planear, escribir, testear, iterar — lo dejas correr.
• Solo intervienes en puntos de decisión. Arquitectura, naming, diseño de contratos.

Todo lo demás — boilerplate, refactors, fontanería de tests, gestión de dependencias — ya es problema del agente.

---

Próximo artículo: Escribir prompts que funcionan. Porque "házlo mejor" no es un prompt. Veremos la estructura en cuatro partes que hace que Claude Code termine de verdad lo que le pides.