Plan de Proyecto:
ABAP AI Coder
con Claude Code
Guía definitiva paso a paso para construir desde CMD el mejor asistente de programación SAP posible. Cubre todos los objetos ABAP, Code Review, integración con documentación SAP, prompts de persistencia profesionales y la hoja de ruta de evolución del sistema.
Estructura del Plan de Proyecto
8 fases ordenadas por dependencia. Completa cada fase antes de continuar.
Prerrequisitos y Software Necesario
Verifica que dispones de todo antes de ejecutar el primer paso.
"Verifica Node.js, Git, npm y conexión SAP en https://mi-sap:44300" — diagnosticará todo y te indicará qué falta.Preparar el Entorno Local
Verificación, estructura de directorios y configuración inicial de Claude Code para SAP.
Verificar prerrequisitos desde CMD REQUERIDO CMD
Abre CMD o PowerShell como administrador. Todos estos comandos deben responder sin error antes de continuar.
Node.js versión menor a 18 — BLOQUEANTE
MCP Server y Claude Code requieren Node 18+. En Windows: desinstala y reinstala desde nodejs.org. En Linux/Mac: usa nvm install 20 && nvm use 20.
Windows: "curl no reconocido" en CMD clásico Usa PowerShell en su lugar, o instala curl desde curl.se/windows. Alternativa inmediata: abre la URL del ADT en el navegador con tus credenciales.
Crear estructura de directorios del proyecto REQUERIDO
Estructura estándar del proyecto ABAP AI Coder. Organiza el servidor MCP, configuración de Claude Code y salidas ABAP.
Crea .gitignore inmediatamente — CRÍTICO
El archivo .env contendrá tu contraseña SAP. Crea .gitignore ahora con: .env y node_modules/ en líneas separadas. Si subes credenciales accidentalmente, cámbialas en SAP de inmediato.
Crear CLAUDE.md con estándares SAP completos REQUERIDO
Memoria persistente de Claude. Se carga automáticamente en cada sesión y define el contexto SAP, convenciones, restricciones y catálogo completo de objetos.
Activar y Configurar ADT en SAP
Configuración del sistema SAP para exponer la API REST de ADT. Requiere acceso Basis o SAP_ALL.
Activar servicio ADT en SICF SAP GUI
El servicio ADT REST debe estar activo en el Internet Communication Framework. Ejecuta como Basis con rol S_ICF_ADM.
Puerto varía según la instalación SAP
Instancia 00 → 44300, instancia 01 → 44301. HTTP no seguro: 8000. S/4HANA cloud: 443. Consulta el número de instancia con Basis: SM51 o variable SAPSYSTEMNAME.
| Código HTTP | Causa | Acción |
|---|---|---|
| 200 OK | Conexión perfecta | Continuar |
| 401 Unauthorized | Credenciales incorrectas | Verificar usuario en SU01 |
| 403 Forbidden | Sin autorización ADT | Asignar SAP_ADT_DEVELOPER_USER |
| 404 Not Found | Servicio ADT no activo | Ejecutar este paso (activar SICF) |
| Connection refused | Puerto cerrado / firewall | Consultar Basis — verificar puerto |
| SSL error | Certificado inválido | Usar -k para diagnóstico → Paso 1.4 |
Configurar roles del usuario de desarrollo SU01 / PFCG
El usuario que Claude Code utilizará para conectarse necesita roles específicos. Crea un usuario técnico dedicado.
Usuario técnico dedicado recomendado Crea usuario CLAUDE_DEV tipo Dialog o System, sin expiración de contraseña. Esto evita interrupciones por rotación de contraseñas y facilita auditoría de los cambios que realiza Claude en el sistema.
Pruebas de conectividad ADT desde CMD CMD
Diagnostica problemas de red, SSL y autenticación de forma independiente antes de configurar el MCP server.
Gestión de certificados SSL FRECUENTE
La mayoría de SAP on-premise tienen certificados auto-firmados. Sin gestionar esto, el MCP server fallará con error SSL.
Opción A — Importar certificado SAP en Node.js (recomendado)
Opción B — Deshabilitar SSL (solo POC/desarrollo)
NUNCA en producción — Solo para pruebas iniciales en entorno de desarrollo aislado.
Instalar y Configurar el Puente SAP-Claude
El MCP Server traduce las instrucciones de Claude en llamadas REST hacia la ADT API de SAP.
Clonar e instalar el MCP Server ABAP CMD
Usamos mario-andreschak/mcp-abap-abap-adt-api: soporte completo de lectura y escritura vía ADT REST API.
npm install falla con proxy corporativo
Configura: npm config set proxy http://PROXY:PUERTO y npm config set https-proxy http://PROXY:PUERTO. Con autenticación: incluye USER:PASS@ antes del host del proxy.
Configurar el archivo .env con credenciales SAP CRÍTICO
Plantilla completa con todas las variables posibles. Edita con tus datos reales.
SAP_CLIENT — Mandante de desarrollo ÚNICAMENTE Si apuntas al mandante de producción, Claude podría crear o modificar objetos activos que afecten a usuarios reales. Usa siempre el mandante de desarrollo o sandbox.
Prueba manual del servidor MCP CMD
Verifica que el servidor arranca y conecta al SAP antes de integrarlo con Claude Code.
Crear el archivo .mcp.json CONFIG
Le dice a Claude Code cómo arrancar y conectarse al servidor MCP ABAP. Guárdalo en la raíz del proyecto.
Múltiples sistemas SAP Añade bloques adicionales en mcpServers para QA, sandbox o BTP. Claude Code los mostrará como herramientas independientes y podrás especificar cuál usar en cada prompt.
Instalar y Configurar Claude Code
El CLI que integra todo: recibe instrucciones en lenguaje natural, usa el MCP ABAP para operar en SAP y genera código.
Instalar Claude Code CLI globalmente CMD
Configurar API Key de Anthropic CONFIG
Control de costos API Cada sesión de desarrollo consume entre $0.10 y $2 USD según volumen de código. Para refactorizaciones masivas, configura un límite de gasto mensual en console.anthropic.com → Usage Limits antes de empezar.
Scripts de arranque rápido CMD
Crea estos scripts en la raíz del proyecto para lanzar el sistema con un solo comando.
Instalar SAP Skills para Claude Code RECOMENDADO
35 instrucciones especializadas para Claude que mejoran la calidad del código ABAP generado.
5 Tests de Verificación End-to-End VERIFICACIÓN
Ejecuta estos tests desde Claude Code para confirmar que el sistema completo funciona.
Sistema operativo — Puedes continuar a Fase 4 Con los 5 tests verdes, Claude Code puede leer, crear, activar y analizar cualquier objeto ABAP del sistema SAP desde tu terminal.
Generación de Todos los Objetos ABAP
Workflows y prompts para cada tipo de objeto del repositorio SAP. Usa el catálogo para saber qué puede hacer Claude con cada uno.
Catálogo completo de objetos SAP y soporte Claude NUEVO
Referencia rápida de todos los objetos ABAP y qué puede hacer Claude con cada uno. Verde = generación completa, Amarillo = generado con guía manual, Morado = con asistencia.
Tablas Z — Workflow completo con verificación previa BASE
Claude siempre verifica si existe una tabla SAP estándar equivalente antes de crear una Z. Si es necesaria, propone la estructura y espera confirmación.
ABAP Clásico — Reports, Clases, Módulos de Función WORKFLOW
Screen Painter (Dynpro) — Código + Guía visual SE51 GUIADO
Claude genera el código ABAP completo (PBO, PAI, includes, GUI status). El diseño visual de la pantalla se crea en SE51 con instrucciones precisas de Claude.
Web Dynpro ABAP — Mantenimiento, creación y migración LEGACY
RAP Business Object — App Fiori completa end-to-end MODERNO
Formularios SAP — Smartforms y Adobe Forms GUIADO
Claude genera la capa ABAP completa (módulo de función de impresión, lógica de datos, estructuras). El diseño visual del formulario requiere las herramientas SAP respectivas.
Workflows ABAP — Business Objects y lógica de aprobación GUIADO
Claude genera el Business Object ABAP, métodos de tarea y lógica de decisión. El diseño del grafo del workflow se realiza en SWDD con instrucciones de Claude.
Clean Core y Claude Code Review
Auditoría automática, refactorización hacia Clean Core y configuración de Code Review para pull requests ABAP.
Auditoría Clean Core automática por paquete PROCESO
Workflow de refactorización segura PROCESO
Claude Code Review — Configuración y uso para ABAP NUEVO · Code Review
Claude Code Review (lanzado marzo 2026) es un sistema multi-agente que revisa pull requests automáticamente. Aunque está orientado a GitHub, se puede integrar con el flujo de desarrollo ABAP.
Hay dos formas de usar Code Review con código ABAP:
Opción A: GitHub + Code Review nativo
Si tu equipo ya usa GitHub para versionar el ABAP (con abapGit), Claude Code Review se integra directamente. Revisa cada PR con múltiples agentes especializados en bugs, seguridad y rendimiento.
Opción B: Revisión manual desde CMD
Sin GitHub, usa Claude Code directamente para revisar el código ABAP exportado o leído del SAP antes de activarlo. Mismo resultado, diferente interfaz.
Documentación SAP, Prompts de Persistencia y el Experto Humano
La clave para que Claude mejore continuamente con tu contexto SAP específico. Cómo combinar el conocimiento de Claude con el expertise del equipo ABAP.
¿Necesitas subir documentación SAP? — Claude ya sabe buscar IMPORTANTE
Esta es una de las preguntas más frecuentes. La respuesta depende del tipo de información.
Qué SÍ debes proporcionar a Claude para máxima efectividad:
Prompts de persistencia y contexto acumulativo AVANZADO
Claude no tiene memoria entre sesiones. Esta sección cubre cómo construir un sistema de contexto acumulativo que mejore con cada sesión de desarrollo.
El modelo Experto SAP + Claude — División del trabajo óptima ESTRATÉGICO
Claude Code no reemplaza al desarrollador ABAP experto — lo amplifica. Aquí está la división de trabajo que maximiza el resultado.
| Tarea | Quién lidera | Colaboración |
|---|---|---|
| Generación de artefactos estándar (RAP, CDS, tablas) | Claude Code | Desarrollador revisa y aprueba |
| Diseño de arquitectura de solución | Experto SAP | Claude proporciona opciones y pros/contras |
| Lógica de negocio compleja y edge cases | Experto SAP | Claude traduce la lógica a código ABAP correcto |
| Refactorización mecánica (C→A Clean Core) | Claude Code | Experto valida equivalencia funcional |
| Debugging de errores en tiempo de ejecución | Experto SAP | Claude analiza el dump y propone correcciones |
| Configuración SAP (Customizing, Basis) | Experto SAP | Claude documenta y guía si se lo describes |
| Code Review de calidad y seguridad | Claude Code | Experto decide qué correcciones aplicar |
| Conocimiento de SAP Notes y OSS | Experto SAP | Claude busca en help.sap.com para ampliar |
| Gestión de transportes y releases | Experto SAP | Claude genera la documentación técnica |
| Diseño visual (Screen Painter, WD, Forms) | Experto SAP | Claude genera la lógica ABAP + guía paso a paso |
CAP BTP, Automatización y Troubleshooting
Extensiones BTP, scripts de generación batch y solución de los errores más frecuentes.
Generar proyectos CAP para extensiones BTP BTP
Scripts de generación en batch AUTOMATION
Troubleshooting — Tabla de errores frecuentes REFERENCIA
| Error | Causa | Solución |
|---|---|---|
| MCP server no arranca | Error TypeScript o .env mal formado | npm run build. Verificar .env sin espacios alrededor del = |
| "No tools available" | Ruta incorrecta en .mcp.json | Verificar que ./mcp-server/dist/index.js existe |
| 401 en SAP | Contraseña expirada o incorrecta | Actualizar SAP_PASSWORD. Verificar bloqueo en SU01 |
| Error sintaxis ABAP | Claude generó código con bug | "Corrige el error de sintaxis en línea X" — Claude puede leerlo y autocorregir |
| Claude inventa APIs inexistentes | Versión SAP no especificada | Añadir versión exacta de S/4HANA al CLAUDE.md y al prompt |
| Costos API elevados | Sesiones largas o código extenso | Usar --print para sesiones cortas. Límites en console.anthropic.com |
| Timeout en activación | Objetos complejos tardan en activar | Aumentar timeout en MCP server. Activar manualmente en ADT |
| CLAUDE.md no se carga | No está en el directorio de trabajo | Ejecutar siempre claude desde C:\Projects\abap-ai-coder |
Roadmap del Proyecto ABAP AI Coder
Hoja de ruta para evolucionar de un asistente de codificación a un sistema de desarrollo inteligente completo.
Roadmap de evolución en 4 horizontes
El sistema evoluciona en capas. Cada horizonte añade valor acumulativo al anterior.
Horizonte 1 — Fundación (Meses 1-2) · Lo que acabas de construir
Servidor MCP conectado a SAP, Claude Code generando todos los tipos de objeto ABAP, CLAUDE.md con estándares corporativos, tests de verificación pasando, primeras generaciones de RAP y tablas Z.
Completar este planHorizonte 2 — Especialización (Meses 3-6)
Construir un catálogo de prompts especializados por dominio funcional (SD, FI, MM). Registrar en z-object-registry.md todos los objetos Z existentes. Crear templates de generación específicos para los patrones de código más usados en tu empresa. Integrar con abapGit + GitHub para Code Review automático en PRs.
Planificar con el equipoHorizonte 3 — Contexto Rico (Meses 6-12)
CLAUDE.md con documentación de todos los objetos Z críticos. Base de conocimiento de decisiones arquitectónicas pasadas. Métricas de cobertura Clean Core por módulo. El experto SAP actúa como "arquitecto prompt" que refina continuamente las instrucciones basándose en los patrones de error y calidad del código generado.
Requiere experto SAP dedicadoHorizonte 4 — Sistema Autónomo (Mes 12+)
Pipeline CI/CD completo: Claude Code genera código → abapGit exporta → GitHub PR → Claude Code Review revisa → desarrollador aprueba → transporte automático a QA. Auditorías Clean Core programadas semanalmente. Dashboard de KPIs: objetos generados, nivel Clean Core por módulo, tiempo ahorrado, issues detectados por Code Review.
Objetivo ambiciosoSistema Completamente Operativo
Marca cada ítem. Cuando todos estén verdes, el ABAP AI Coder está listo para producción.
Fase 0 · Entorno Base
Fase 1 · SAP Configurado
Fase 2 · MCP Server Operativo
Fase 3 · Claude Code Activo
Fase 4 · Generación Validada
Fases 5-8 · Operación Avanzada
ABAP AI Coder · Plan de Proyecto v2.0 · Generado con Claude · Marzo 2026
MCP ABAP ADT · SAP Skills · Claude Code Docs · SAP ABAP Cloud · SAP Community