← Volver al listado de tecnologías ← Índice de Claude Code

Cap 20: Tips de Productividad

3 de marzo de 2026 Por: Artiko

claude-codetipsproductividadbest-practices

Checklist de configuración inicial

CLAUDE.md < 150 líneas

La regla más importante. CLAUDE.md se carga completo en cada sesión. Un archivo de 500 líneas desperdicia tokens. Sé conciso:

# CLAUDE.md
## Comandos
bun dev / bun test / bun build

## Stack
Astro 5 + React 19 + TypeScript strict + Tailwind

## Convenciones
- Commits: feat: / fix: / refactor:
- Archivos < 150 líneas
- Arquitectura hexagonal

Compact al 50%

No esperes a que el auto-compact actúe al 95%. Compacta proactivamente:

# Configurar threshold
CLAUDE_AUTOCOMPACT_PCT_OVERRIDE=50 claude

La “zona tonta del agente” ocurre cuando el contexto está casi lleno — Claude pierde información importante y comete errores.

Commits frecuentes

Cada cambio funcional = un commit. Esto proporciona:

Checkpoints para /rewind
Historial claro de qué cambió qué
Fácil revert si algo falla
Mejor colaboración con agent teams

Feature-specific sub-agents

En lugar de agentes genéricos (“code-reviewer”, “test-writer”), crea agentes específicos por feature:

<!-- .claude/agents/auth-specialist.md -->
---
name: auth-specialist
skills: ["security-rules", "auth-patterns"]
tools: ["Read", "Edit", "Bash", "Grep"]
---

Especialista en el módulo de autenticación.
Conoce OAuth2, JWT, sesiones y RBAC.

Los agentes específicos con skills precargados dan mejores resultados que agentes genéricos.

Plan mode primero

Siempre empezar con plan mode para tareas no triviales:

claude --permission-mode plan
# Investigar y planificar
# Luego cambiar a modo normal para implementar

Permisos con wildcards > bypass

Nunca uses --dangerously-skip-permissions. En su lugar, configura permisos específicos:

{
  "permissions": {
    "allow": [
      "Read", "Glob", "Grep",
      "Bash(git *)", "Bash(bun *)",
      "Edit(src/**)", "Write(src/**)"
    ]
  }
}

Variables de entorno útiles

Variable	Valor	Efecto
`CLAUDE_AUTOCOMPACT_PCT_OVERRIDE`	`50`	Compactar al 50%
`CLAUDE_CODE_EFFORT_LEVEL`	`medium`	Balance esfuerzo/velocidad
`BASH_MAX_TIMEOUT_MS`	`300000`	5 min timeout para bash
`MAX_THINKING_TOKENS`	`16000`	Tokens de razonamiento
`CLAUDE_CODE_TASK_LIST_ID`	`mi-proyecto`	Tareas compartidas entre sesiones

Output style según contexto

Situación	Estilo
Codebase nuevo	`Explanatory` — explica cada paso
Aprendizaje	`Learning` — enseña mientras trabaja
Producción	Custom conciso — solo lo necesario

Model aliases

Tarea	Modelo
Exploración rápida	`haiku`
Desarrollo diario	`sonnet`
Arquitectura compleja	`opus`
Planificar + ejecutar	`opusplan`
Codebase enorme	`sonnet[1m]`

Terminal recomendado

Usa un emulador de terminal dedicado (iTerm2, Ghostty, Alacritty) en lugar del terminal integrado del IDE. El terminal del IDE puede tener problemas con sesiones largas.

Workflow diario recomendado

Mañana: claude -c para continuar la sesión de ayer
Nueva feature: claude --permission-mode plan → investigar → planificar → implementar
Bug fix: “Reproduce el bug, investiga la causa, propón soluciones”
Review: /review-pr (command personalizado)
Final del día: commitear trabajo en progreso

Antipatrones a evitar

Antipatrón	Mejor alternativa
CLAUDE.md > 150 líneas	Separar en skills
`--dangerously-skip-permissions`	Wildcards específicos
Agentes genéricos	Agentes por feature con skills
No compactar	Compact al 50%
No commitear	Commit después de cada paso
Un solo prompt gigante	Dividir en Research → Plan → Implement
Esperar que Claude adivine	Instrucciones específicas en CLAUDE.md

Resumen: 10 reglas de oro

CLAUDE.md conciso (< 150 líneas)
Compactar al 50% del contexto
Commitear después de cada cambio funcional
Plan mode antes de implementar
Permisos con wildcards, nunca bypass
Sub-agentes específicos por feature
Skills para conocimiento reutilizable
RPI (Research → Plan → Implement) para tareas complejas
Status line para awareness de contexto
Terminal dedicado, no IDE terminal

Fin del tutorial — Volver al índice