Claude Code

Instalación y arranque

La primera vez, claude abre el navegador para iniciar sesión. Necesitas un plan Pro, Max, Ultra, Team o Enterprise, o una cuenta de Console.

Sesiones, modelo y modo no interactivo

Atajos de teclado

En macOS, los atajos con Alt requieren configurar Option como Meta en la terminal.

Prefijos en el prompt

Para guardar instrucciones permanentes usa /memory o edita CLAUDE.md directamente.

Slash commands más útiles

Configuración y extensiones (slash commands)

Memoria: CLAUDE.md

Se cargan todos (no se sobrescriben). Importa otros archivos con @ruta; las rutas relativas parten del archivo que importa y se permiten hasta 4 niveles de imports. Apunta a menos de 200 líneas por archivo.

# Project guide

@README.md
@docs/04-architecture.md

## Commands
- Install: `pnpm install`
- Test: `pnpm run test`
- Lint: `pnpm run lint`

## Rules
- Use pnpm, never other package managers.
- Conventional Commits: `feat(scope): message`.

settings.json y permisos

Precedencia (de mayor a menor): managed, --settings en la línea de comandos, local, proyecto y usuario. Las listas como permissions.allow se combinan entre archivos. Este ejemplo va en .claude/settings.json:

{
  "$schema": "https://json.schemastore.org/claude-code-settings.json",
  "permissions": {
    "allow": ["Bash(pnpm run lint)", "Bash(pnpm run test *)", "Bash(git diff *)"],
    "deny": ["Read(./.env)", "Read(./.env.*)", "Bash(git push --force *)"]
  },
  "hooks": {
    "PreToolUse": [
      {
        "matcher": "Bash",
        "hooks": [
          {
            "type": "command",
            "command": "${CLAUDE_PROJECT_DIR}/.claude/hooks/require-pnpm.sh",
            "args": []
          }
        ]
      }
    ]
  }
}

Hook PreToolUse: forzar pnpm

El hook recibe el evento en JSON por stdin (tool_input.command trae el comando). Si sale con código 2, Claude Code bloquea la herramienta y le muestra a Claude el mensaje de stderr. Requiere jq y permiso de ejecución (chmod +x).

#!/usr/bin/env bash
# .claude/hooks/require-pnpm.sh
COMMAND=$(jq -r '.tool_input.command')

if echo "$COMMAND" | grep -qE '(^|[;&|[:space:]])(npm|npx)([[:space:]]|$)'; then
  echo "Blocked by team policy: use pnpm (pnpm add, pnpm dlx, pnpm run) instead." >&2
  exit 2
fi
exit 0

Revisa los hooks activos con /hooks. Los cambios en settings se recargan sin reiniciar la sesión.

Servidores MCP

Pasa secretos con -e KEY=value o --header, nunca los escribas en .mcp.json. El transporte SSE está obsoleto: usa HTTP.

Subagentes y skills

Un subagente es Markdown con frontmatter (name y description obligatorios). Invócalo por nombre en el prompt, con @agent-code-reviewer o para toda la sesión con claude --agent code-reviewer.

---
name: code-reviewer
description: Reviews code for quality and best practices
tools: Read, Glob, Grep
model: sonnet
---

You are a code reviewer. Analyze the code and give specific,
actionable feedback on quality, security and best practices.

En una skill, $ARGUMENTS recibe el texto que escribes tras /<nombre>, y disable-model-invocation: true evita que Claude la cargue por su cuenta.

Buenas prácticas

• Empieza las tareas grandes en modo plan (Shift + Tab o /plan), revisa el plan y luego deja que edite.
• Ejecuta /init en cada repo y mantén CLAUDE.md corto: comandos, convenciones y reglas que no se deducen del código.
• Usa /clear al cambiar de tarea y /compact en sesiones largas; vigila el consumo con /context.
• Trabaja en pasos pequeños: revisa cada cambio con /diff o git diff y haz commits pequeños y frecuentes.
• Si algo sale mal, Esc Esc o /rewind restauran el código y la conversación a un punto anterior.
• Lo que nunca debe pasar se garantiza con reglas deny o con hooks; CLAUDE.md es contexto, no una regla obligatoria.
• No uses --dangerously-skip-permissions fuera de un sandbox sin acceso a internet.