Cheatsheet de Claude Code: Comandos, Slash Commands, CLAUDE.md y MCP

La referencia de Claude Code para tener abierta al trabajar: comandos diarios, slash commands esenciales, plantilla CLAUDE.md lista para copiar, configuración MCP, atajos y soluciones a los problemas comunes.

🧪

Ejecuta y Edita este Código en Vivo Sin instalaciones locales. Soporta Python 3, JS y SQL.

▶ Probar en Playground →

1. Instalación y arranque

Comando	Qué hace
`npm install -g @anthropic-ai/claude-code`	Instalación global (Node.js 18+)
`claude`	Sesión interactiva en la carpeta actual
`claude "fix the failing test in auth.py"`	Inicia con un prompt inicial
`claude -p "explain this codebase"`	Modo print: respuesta única, sin sesión (ideal para scripts)
`cat error.log \| claude -p "what caused this?"`	Entrada por tubería a una consulta única
`claude -c`	Continúa la conversación más reciente aquí
`claude --resume`	Elige una sesión anterior para retomarla
`claude mcp list`	Lista los servidores MCP configurados

2. Slash commands esenciales (dentro de la sesión)

Comando	Úsalo para
`/init`	Generar un CLAUDE.md inicial desde tu código
`/clear`	Borra el contexto: úsalo entre tareas sin relación
`/compact`	Resumir la conversación y liberar contexto
`/cost`	Consumo de tokens y coste de la sesión
`/model`	Cambiar de modelo (uno rápido y barato para tareas simples)
`/permissions`	Qué herramientas y comandos necesitan aprobación
`/memory`	Editar la memoria (CLAUDE.md y memoria automática)
`/mcp`	Estado de los servidores MCP y autenticación
`/help`	La lista completa de comandos de tu versión

3. Trucos de teclado y de prompt

Esc: detiene a Claude a mitad de acción. Esc dos veces: edita un mensaje anterior.
Mayús+Tab: alterna los modos de permisos, incluido el Plan.
@ruta/al/archivo: referencia un archivo y Claude lo lee directamente.
# tu nota al inicio del prompt: la guarda en la memoria del proyecto (CLAUDE.md).
Prefijo !: ejecutas tú un comando en la sesión (p. ej. !npm test) y su salida queda en el contexto.
"think" / "think hard" / "ultrathink": razonamiento más profundo en problemas difíciles.

4. Plantilla CLAUDE.md (copia, adapta y haz commit)

Claude lo lee en cada sesión: cada línea cuesta contexto; mantenlo corto.

CODE SNIPPET

# Project: [Name]

## What this is
One paragraph: what it does, who uses it, the stack.

## Commands
- Install: `npm install`
- Dev: `npm run dev`
- Test: `npm test` (single file: `npm test -- path/to/file.test.ts`)
- Lint/typecheck: `npm run lint && npm run typecheck`
- Build: `npm run build`

## Architecture
- Entry point: src/main.ts — keep it thin.
- Business logic in src/services/, never in route handlers.
- Data access only via src/db/ (no raw SQL in services).

## Rules
- TypeScript strict. No `any` without a comment explaining why.
- All new endpoints need a test. Run the full suite before saying "done".
- Never edit merged migrations; create a new one.
- Match the style of the file you edit; do not reformat unrelated code.

## Gotchas
- The payments webhook is fragile: read docs/payments.md first.
- .env uses staging keys. Never print secrets in output or logs.

5. Conectar servidores MCP y flujo diario

CODE SNIPPET

# Proyecto (compartido vía .mcp.json)
claude mcp add github -- npx -y @modelcontextprotocol/server-github

# Servidor remoto con cabeceras
claude mcp add --transport http sentry https://mcp.sentry.dev/mcp

# Inspeccionar y eliminar
claude mcp list
claude mcp remove github

Planifica primero: modo Plan (Mayús+Tab); aprueba el enfoque antes del código.
Bucles pequeños: una tarea, tests, diff, commit; /clear antes de la siguiente.
Muestra, no cuentes: pega el error, el log y el test que falla.
Verifica como un escéptico: que ejecute tests y linter; lee tú el diff.

6. Solución rápida de problemas

Pide permiso para todo: ajusta /permissions o permite comandos seguros en .claude/settings.json.
Respuestas genéricas: CLAUDE.md pobre o ausente; /init y añade comandos y advertencias.
El contexto se llena al instante: referencia con @, /compact y subagentes.
Un MCP no conecta: claude mcp list, prueba su comando a mano, revisa las claves del entorno.