Mis mejores prácticas con Claude Code

Después de usar Claude Code de forma continua para programación con AI, he desarrollado un flujo de trabajo de desarrollo eficiente. Estas mejores prácticas de Claude Code cubren aspectos fundamentales como la gestión de sesiones, el modo de planificación, el control de versiones, la garantía de calidad y la revisión de código.

Técnicas clave de Claude Code

Completa una tarea por sesión; al terminar cada tarea, usa /clear para evitar la compresión del contexto.
Salvo modificaciones simples en un solo archivo, usa siempre el modo plan. Para tareas más complejas, utiliza el enfoque basado en especificaciones.
Usa think, think hard, ultrathink para que Claude dedique más tiempo a pensar en problemas complejos.
Gestiona cada cambio con Git, crea una rama para cada tarea y haz merge al terminar.
Usa Claude Code Hooks y herramientas como pre-commit para garantizar la calidad del código; no dependas de Claude para verificar el formato.
Si después de varios intercambios el problema no se resuelve, abre una nueva sesión y empieza de nuevo.
Si una tarea presenta problemas graves, ejecuta git checkout . para volver al último commit y empezar de cero.
Usa worktree para manejar múltiples tareas simultáneamente y deja que Claude Code las fusione. Sin embargo, lo más común es abrir varias ventanas para trabajar en varios proyectos a la vez (por ejemplo, el frontend y el backend de una misma funcionalidad).
Claude Code no solo sirve para programar, también es útil para organizar y recopilar información y materiales.
Usa directamente claude --dangerously-skip-permissions para darle todos los permisos; hasta ahora no he tenido ningún problema.
Después de completar cada tarea, abre una nueva ventana y usa el Subagent de revisión de código para hacer code review.

Guía completa de comandos slash de Claude Code

Los comandos slash que ofrece Claude Code son herramientas clave para mejorar la eficiencia en la programación. A continuación, te presento los comandos slash más utilizados en Claude Code y sus usos:

`/init`

Inicializa el archivo CLAUDE.md, registrando el contexto del proyecto, requisitos, restricciones, etc.
Personalmente, espero a que el proyecto esté en marcha un tiempo antes de usar este comando.

`/memory`

Consulta y gestiona la memoria general personal o del proyecto, es decir, gestiona el contenido del archivo CLAUDE.md.
Puedes invocarlo rápidamente en la terminal usando # al inicio.
Cada vez que durante el desarrollo encuentres algo que pueda servir como restricción general, agrégalo. Puedes pedirle a Claude que lo agregue después de cada cambio.

`/add-dir`

Agrega todos los archivos de un directorio especificado al contexto de Claude, permitiendo la interacción entre múltiples proyectos.
Personalmente, prefiero copiar la ruta en la terminal y decirle a Claude que vaya a ese directorio. Casi no uso este comando, porque así puedo forzarlo a que lo revise.
Si frecuentemente necesitas interacción entre proyectos, puedes escribir las rutas directamente en CLAUDE.md; así la memoria se conserva después de cada /clear.

`/clear`

Limpia el contexto de la sesión actual y comienza una nueva tarea.
Usa este comando cada vez que termines una tarea; no dejes que el contexto crezca demasiado para evitar la compresión automática.
No te preocupes por perder información. Si es importante, debería estar en CLAUDE.md. Al fin y al cabo, cada sesión es para una sola tarea.

`/compact`

Comprime el contexto de la sesión actual, conservando los puntos clave para continuar con la tarea.
Casi nunca lo uso activamente, porque la compresión pierde información detallada y afecta la calidad de las respuestas posteriores.
Si una tarea es demasiado grande, lo recomendable es dividirla, no comprimir el contexto.

`/mcp`

Controla y gestiona MCP.
Los MCP más utilizados son Context7 y chrome-devtools-mcp.

`/agent`

Consulta y gestiona el uso de Subagent.
Puedes usar agents predefinidos en repositorios de Agents en GitHub.
El SubAgent más utilizado es /code-review-ai:ai-review, principalmente para revisión de código.

`/hooks`

Consulta y gestiona los Claude Code Hooks.

Por ejemplo, formatear automáticamente el código después de cada ejecución.

{
  "hooks": {
    "Stop": [
      {
        "hooks": [
          {
            "type": "command",
            "command": "cd \"$CLAUDE_PROJECT_DIR\" && make format",
            "timeout": 60
          }
        ]
      }
    ]
  }
}

Por ejemplo, notificaciones del sistema después de cada mensaje.

{
  "hooks": {
    "Notification": [
      {
        "matcher": "",
        "hooks": [
          {
            "type": "command",
            "command": "terminal-notifier -title '🚀 通知' -subtitle '需要你的指令' -message 'Claude 正等待下一步操作' -sound 'Pop' -execute '/usr/local/bin/code /Users/wyx/code'"
          }
        ]
      }
    ],
    "Stop": [
      {
        "matcher": "",
        "hooks": [
          {
            "type": "command",
            "command": "terminal-notifier -title '✅ 通知' -subtitle '任务已完成' -message '当前任务已完成' -sound 'Pop' -execute '/usr/local/bin/code /Users/wyx/code'"
          }
        ]
      }
    ]
  }
}

`/tasks`

Lista y gestiona las tareas en segundo plano; puedes usar ! para activarlas rápidamente.
Rara vez lo activo manualmente; prefiero abrir una nueva ventana para ver el estado de ejecución y copiar los errores manualmente.

`/export`

Exporta el contenido de la sesión actual.
Útil cuando necesitas analizar el contenido con otra AI; puedes exportarlo y copiarlo a otras herramientas de AI.

Comandos personalizados para compartir

Claude Code soporta comandos personalizados. Solo necesitas crear archivos md y colocarlos en el directorio ~/.claude/commands/.

`/commit`

# Commit Message 生成规范

你是一位资深的软件工程师和代码审查专家，专注于生成高质量、符合 Git Conventional Commits 规范的提交信息，并且执行git add和git commit命令，不执行git push操作。

## 核心任务

根据用户提供的代码变更（diff）或暂存区内容，执行以下分析并生成提交信息：

1. **原子性分析 (Atomic Check)**:
    * 首先分析代码变更是否过于复杂或包含多个不相关的改动。
    * 如果包含多个逻辑独立的改动（例如同时修改了 UI 和后端 API，且两者无直接依赖），**请优先建议用户拆分提交**，并给出拆分建议。
    * 如果改动是原子的（Atomic），则继续生成提交信息。

2. **生成提交信息 (Commit Generation)**:
    * 严格遵循 **Conventional Commits** 格式。
    * **语言要求**: 提交信息的标题（Subject）和正文（Body）必须使用**中文**。
    * **最后说明**：这个commit是谁提交的，例如"由Claude AI助手生成"。

    * **格式结构**:

        ```text
        <emoji> <type>(<scope>): <subject>

        <body>
        ```

## 详细规则

### 1. Header 格式

* **Emoji**: 根据改动类型选择最准确的表情符号（见下表）。
* **Type**: 使用标准的英文类型（如 `feat`, `fix`），保持工具兼容性。
* **Scope** (可选): 用英文括号包裹，简短说明改动影响的模块或文件名。
* **Subject**: 简练的**中文**描述，不超过 50 个字符，不要以句号结尾。

### 2. Body 内容 (至关重要)

正文部分必须清晰分段，包含以下两部分：
* **What (做了什么)**: 使用无序列表 (`- `) 详细列出具体的代码改动点。
* **Why (为什么做)**: 解释改动的动机、解决的问题或带来的优化。

### 3. 类型映射表 (Type/Emoji Mapping)

| Type | Emoji | 含义 | 适用场景 |
|:---|:---|:---|:---|
| **feat** | ✨ | 新功能 | 引入新特性或功能 |
| **fix** | 🐛 | 修复 Bug | 修复生产环境或开发中的错误 |
| **docs** | 📝 | 文档 | 仅修改文档 (README, API doc) |
| **style** | 💄 | 格式/样式 | 代码格式化、UI 微调 (不影响逻辑) |
| **refactor** | ♻️ | 重构 | 代码结构调整，既不修 Bug 也不加功能 |
| **perf** | ⚡️ | 性能 | 提升性能的改动 |
| **test** | ✅ | 测试 | 增加或修改测试代码 |
| **build** | 📦 | 构建 | 构建系统或外部依赖变动 |
| **ci** | 👷 | CI/CD | CI 配置文件或脚本变动 |
| **chore** | 🔧 | 杂项 | 其他琐碎改动 |

## 输出示例

**输入**: 用户修改了登录逻辑，增加了验证码校验，并修复了一个空指针报错。

**输出**:

✨ feat(auth): 增加登录时的验证码校验机制

- 在 `LoginController` 中集成验证码服务
- 更新前端登录表单，增加验证码输入框
- 🐛 fix: 修复 `UserParams` 解析时的空指针异常

**原因 (Why):**
为了防止暴力破解攻击，提高账户安全性，因此引入强制验证码流程。同时顺带修复了测试中发现的潜在崩溃问题。

---

**注意**:
*   你可以执行提交commit的命令，但是最终的git push操作由用户执行，因为最终的提交信息需要用户确认。
*   最终输出只需包含建议的 Commit Message 内容，不需要额外的寒暄。

***

Para terminar

Actualmente, estas mejores prácticas de Claude Code están basadas principalmente en experiencia de desarrollo backend. Las estrategias de optimización para el frontend aún están en exploración.

Si quieres profundizar en cómo garantizar la calidad del código con programación asistida por AI, puedes consultar "Control de calidad en programación con AI: 5 capas de defensa para asegurar la calidad del código", donde se detallan las 5 capas de defensa de calidad en la programación con Claude Code.

Estas técnicas y prácticas de Claude Code están en constante evolución; seguiré actualizando este artículo.

Lecturas recomendadas

"Arquitectura completa de Claude" -- Comprende a fondo los componentes detrás de Claude Code: MCP, Skills, Subagents, Hooks y más
"Que son los Claude Skills" -- Conoce los principios fundamentales y casos de uso de Skills
"Guia completa de Claude Subagent" -- Domina el uso y la personalizacion de Subagents
"De Eclipse a Zed: la evolucion de editores de un desarrollador" -- Mi recorrido por las herramientas de desarrollo