Introducción a Claude Code

Claude Code (CC) es un agente de IA a nivel de sistema desarrollado por Anthropic, diseñado para automatizar tareas complejas mediante comandos en lenguaje natural, superando las limitaciones de herramientas de desarrollo tradicionales.

Capacidad	Descripción
Acceso al Sistema	Permite ejecutar operaciones de archivos, gestionar procesos y ejecutar comandos con permisos elevados.
Contexto Ampliado	Soporta ventanas de contexto de hasta 200,000 tokens para procesar proyectos de gran escala.
Extensibilidad Modular	Compatible con MCP, Skills, Plugins y Hooks para personalizar flujos de trabajo.
Colaboración Multiagente	Facilita la ejecución paralela de subtareas mediante subagentes especializados.
Interacción Intuitiva	Interpreta instrucciones en lenguaje natural sin necesidad de sintaxis compleja.

Instalación y Configuración del Entorno

Requisitos Previos

Recurso	Función	Enlace de Instalación
Node.js	Entorno de ejecución	https://nodejs.org
Git	Control de versiones	https://git-scm.com
Clave API	Acceso a modelos de IA	Plataformas como ZhipuGLM, Moonshot o Qwen

Verificar la instalación con comandos alternativos:

# Confirmar versión de Node.js
node --version

# Revisar disponibilidad de Git
git --version --abbrev=0

Instalación de Claude Code

Instalación global mediante NPM:

npm install -g claude-code-suite

Validar la instalación:

claude-code --version --verbose

Configuración de Modelos de IA

Método Manual (Universal)

Configurar variables de entorno para modelos compatibles con la API de Anthropic:

En sistemas Windows:

setx CLAUDE_ENDPOINT "URL_del_modelo"
setx CLAUDE_AUTH_KEY "tu_clave_api"
setx CLAUDE_MODEL_ID "nombre_del_modelo"

En sistemas macOS/Linux:

export CLAUDE_ENDPOINT=URL_del_modelo
export CLAUDE_AUTH_KEY=tu_clave_api
export CLAUDE_MODEL_ID=nombre_del_modelo

# Persistir configuración (agregar a ~/.bashrc o ~/.zshrc)
echo 'export CLAUDE_ENDPOINT=URL_del_modelo' >> ~/.zshrc
echo 'export CLAUDE_AUTH_KEY=tu_clave_api' >> ~/.zshrc
echo 'export CLAUDE_MODEL_ID=nombre_del_modelo' >> ~/.zshrc
source ~/.zshrc

Ejemplos de Configuración para Modelos Populares

Modelo	URL del Endpoint	ID del Modelo	Obtener Clave API
Zhipu GLM-4.7	https://open.bigmodel.cn/api/claude	glm-4-7	https://open.bigmodel.cn/
Moonshot K2	https://api.moonshot.cn/claude	kimi-k2-preview	https://platform.moonshot.cn/
Tongyi Qwen	https://dashscope.aliyuncs.com/claude	qwen-coder-v2	https://bailian.console.aliyun.com/

Configuración de ejemplo para Zhipu GLM:

export CLAUDE_ENDPOINT=https://open.bigmodel.cn/api/claude
export CLAUDE_AUTH_KEY=mi_clave_glm
export CLAUDE_MODEL_ID=glm-4-7

Nota: Reiniciar la terminal o ejecutar source ~/.zshrc para aplicar los cambios.

Conceptos Clave para el Uso Avanzado

Skills (Paquetes de Habilidades)

Skills son flujos de trabajo predefinidos que encapsulan funcionalidades específicas, diseñados para ser reutilizables y eficientes en el uso de recursos.

Tipo de Skill	Descripción	Ejemplo de Uso
User Skills	Habilidades personalizadas almacenadas localmente.	Automatización de tareas de usuario.
Plugin Skills	Habilidades proporcionadas por complementos instalados.	Optimización de interfaces front end.
Built-in Skills	Habilidades integradas en Claude Code.	Revisión de código o gestión de commits.

Instalación de habilidades oficiales:

npx skills-manager install @anthropics/claude-code/frontend-optimizer --client claude-code

Estructura para crear habilidades personalizadas:

mi-habilidad/
├── metadata.json          # Metadatos de la habilidad
├── documentacion.md       # Documentación de uso
├── apis/                  # Definiciones de API (opcional)
└── herramientas/          # Herramientas personalizadas (opcional)

Hooks (Ganchos de Eventos)

Hooks son scripts que se ejecutan automáticamente al ocurrir eventos específicos, útiles para validar operaciones o personalizar comportamientos.

Evento	Descripción	Aplicación Típica
user-input-submitted	Antes de procesar la entrada del usuario.	Validación de instrucciones.
tool-execution-start	Al iniciar una herramienta.	Verificación de permisos.
tool-execution-end	Al finalizar una herramienta.	Registro de logs o formaeto de código.

Configuración de hooks mediante archivo JSON:

{
  "hooks": {
    "input-validation": {
      "command": "node validate-input.js",
      "active": true
    },
    "code-formatter": {
      "command": "prettier --check {{file}}",
      "active": true,
      "blocking": false
    }
  }
}

Ejemplo de hook para bloquear operaciones peligrosas:

#!/bin/bash
TOOL_NAME=$(echo "$INPUT_DATA" | jq -r '.operation')
RISKY_OPS=("rm" "delete" "truncate")

if [[ " ${RISKY_OPS[@]} " =~ " ${TOOL_NAME} " ]]; then
  echo "Operación de alto riesgo detectada: $TOOL_NAME"
  read -p "¿Confirmar ejecución? (s/n): " RESP
  [ "$RESP" != "s" ] && exit 1
fi

Plugins (Paquetes de Extensiones)

Plugins agrupan múltiples recursos, como Skills, comandos, configuraciones MCP y hooks, en una solución integral.

Instalación de plugins desde repositorios:

claude-code plugin add frontend-suite

Estructura de un plugin personalizado:

mi-plugin/
├── plugin-config.json    # Configuración principal
├── habilidades/         # Directorio de Skills
├── comandos/            # Comandos personalizados
├── servidores-mcp/      # Configuraciones MCP
└── agentes/             # Definiciones de subagentes

MCP Servers (Servidores de Protocolo de Contexto)

MCP permite integrar herramientas externas, como bases de datos o servicios web, mediante servidores especializados.

Servidor MCP	Funcionalidad	Popularidad
chrome-tools-mcp	Automatización de navegador web con herramientas de desarrollo.	Alta
github-integration-mcp	Interacción directa con la API de GitHub.	Media-Alta
postgres-connector-mcp	Operaciones avanzadas en bases de datos PostgreSQL.	Media

Configuración de un servidor MCP:

claude-code mcp add browser-automation npx chrome-tools-mcp@latest

Integración en archivo de configuración:

{
  "servidoresMCP": {
    "navegador-web": {
      "comando": "npx",
      "args": ["chrome-tools-mcp@latest"],
      "activo": true
    }
  }
}

Subagents (Subagentes)

Subagentes son agentes independientes que ejecutan tareas en paralelo, cada uno con su propio contexto, optimizando procesos complejos.

Configuración de subagentes:

{
  "subagentes": {
    "analista-codigo": {
      "descripcion": "Especialista en revisión de código y mejores prácticas.",
      "modelo": "claude-opus-4-5",
      "instrucciones": "Evaluar calidad del código, seguridad y rendimiento.",
      "herramientas": ["lectura", "búsqueda", "git"]
    },
    "generador-pruebas": {
      "descripcion": "Encargado de crear suites de pruebas automatizadas.",
      "modelo": "claude-sonnet-4-5",
      "instrucciones": "Diseñar pruebas unitarias y de integración.",
      "herramientas": ["lectura", "escritura", "terminal"]
    }
  }
}

Ejemplo de uso: Asignar tareas paralelas a subagentes para desarrollar una funcionalidad completa, incluyendo revisión, pruebas y documentación.

CLAUDE.md (Archivo de Memoria del Proyecto)

Este archivo almacena información contextual del proyecto, como estructura, comandos de construcción y normas, para agilizar el trabajo del agente.

Propósito	Descripción
Repositorio de Conocimiento	Documenta arquitectura, stack tecnológico y dependencias.
Arranque Rápido	Carga automática del contexto al iniciar sesiones.
Colaboración en Equipo	Estandariza prácticas y convenciones.

Ejemplo de contenido para CLAUDE.md:

# Plataforma de Comercio Electrónico

## Visión General
Sistema basado en Node.js y React para gestión de productos, pedidos y pagos.

## Stack Tecnológico
- Frontend: React 18, TypeScript, Tailwind CSS
- Backend: Node.js 20, Express, TypeScript
- Bases de Datos: PostgreSQL 15, Redis 7
- Autenticación: JWT, OAuth 2.0

## Estructura del Proyecto
src/
├── frontend/          # Aplicación React
│   ├── componentes/   # Componentes reutilizables
│   ├── paginas/       # Páginas de la aplicación
│   └── estado/        # Gestión de estado con Redux
├── backend/           # API y lógica de negocio
│   ├── controladores/ # Manejadores de rutas
│   └── servicios/     # Servicios de dominio
└── compartido/        # Código compartido y tipos