Herramientasclaude
Cómo programar con Claude: del prompt a las pruebas
Aprende a programar con Claude con un CSV ficticio: define la tarea, pide código y pruebas, revisa el resultado y corrige errores paso a paso.
- Autor: humAIns
- 11 min de lectura
índice · 7 apartados
Para programar con Claude, convierte una necesidad concreta en criterios comprobables, solicita una solución pequeña y pídele pruebas para entradas válidas y defectuosas. En este ejemplo ficticio limpiarás un CSV de campañas: indicarás qué columnas conservar, qué errores detectar y qué salida esperas. Después revisarás el código y ejecutarás las pruebas tú mismo, sin datos de clientes ni secretos.
Puedes seguir el ejercicio en el chat de Claude, copiando el código a una carpeta de prueba, o con Claude Code, que trabaja sobre archivos del proyecto con permisos configurables. Si buscas la puesta en marcha de la herramienta, consulta cómo configurar Claude Code en terminal; para usar su panel dentro del editor, está la guía de Claude Code en VS Code. Este artículo se centra en el trabajo posterior a la configuración, no en instalar el editor.
Claude chat y Claude Code: qué hace cada uno y cuándo utilizarlo
En el chat puedes explicar un problema, recibir una propuesta de código y pedir que la explique. Tú decides dónde guardarla, qué comandos ejecutar y cómo comprobar el resultado. No confundas una respuesta convincente con un programa ejecutado: si no has iniciado una herramienta de ejecución, el chat no ha validado localmente ese archivo.
Claude Code trabaja con los archivos de una carpeta de proyecto. La guía oficial describe cómo explorar, proponer cambios y escribir pruebas. Las acciones dependen de la interfaz y los permisos: en modo Manual, las modificaciones y comandos Bash requieren aprobación, salvo excepciones de solo lectura. Revisa cada acción antes de autorizarla.
| Necesidad | Claude chat | Claude Code |
|---|---|---|
| Entender una idea o pedir un ejemplo | Explica el objetivo y pega solo un fragmento ficticio o no sensible | También puedes preguntar por archivos de una carpeta de trabajo |
| Crear un archivo | Copia el código a un archivo tú mismo | Puede proponer cambios en el proyecto; revisa el diff y los permisos |
| Ejecutar pruebas | Ejecuta tú el comando en tu entorno | Puede solicitar ejecutar comandos; comprueba y aprueba solo lo que entiendas |
| Empezar con menor configuración | Adecuado para un ejemplo autocontenido | Requiere preparar el acceso y el entorno según la guía oficial |
La página oficial de precios y planes de Claude diferencia las funciones del chat de Claude Code: a la fecha consultada, la tabla indica Claude Code en planes Pro, Max y superiores, no en Free; también lista creación de archivos y ejecución de código en Claude en varias modalidades. La disponibilidad y límites pueden cambiar, así que consulta tu cuenta y condiciones actuales. No presupongas que cualquier función está disponible en cada conversación.
Del objetivo al prompt: entradas, salida, restricciones y criterios
Antes de pedir código, escribe cuatro decisiones en lenguaje corriente:
- Entrada: qué columnas contiene el archivo y si hay encabezado.
- Salida: qué archivo o resultado quieres obtener y qué columnas conservar.
- Reglas: cómo tratar espacios, campos vacíos, duplicados y valores desconocidos.
- Aceptación: qué debe ocurrir en un caso normal y ante cada error.
En el ejercicio ficticio hay tres campos: campaña, canal e inversion_eur. Queremos eliminar espacios sobrantes, conservar las filas válidas, normalizar el texto de canal a minúsculas y separar las filas inválidas en un informe. No deduplicaremos: dos campañas con el mismo nombre podrían ser registros legítimos. La regla es deliberadamente explícita para que el modelo no invente una decisión de negocio.
Puedes usar este prompt como punto de partida:
Quiero un programa Python sencillo para limpiar un CSV ficticio de campañas.
El archivo tiene encabezados: campaña, canal, inversion_eur.
Conserva esas columnas, quita espacios al principio y al final de los textos,
convierte canal a minúsculas y valida que inversion_eur sea un número no
negativo. No elimines duplicados ni cambies el separador sin preguntarme.
Escribe las filas válidas en campañas_limpias.csv y las inválidas en
incidencias.csv indicando el número de fila y el motivo. Usa solo la biblioteca
estándar, no accedas a internet, no añadas dependencias y no uses datos reales.
Antes del código, explica el algoritmo en cinco pasos y enumera los supuestos.
Después propone pruebas para un registro normal, una fila sin canal y una fila
malformada. No afirmes que has ejecutado el programa ni las pruebas.
El prompt prohíbe la red y las dependencias de terceros como requisito del programa solicitado; no es una garantía técnica sobre cómo funciona el servicio o tu entorno. Si trabajas con información de empresa, sigue la política de tu organización y no pegues credenciales, datos personales o código confidencial en una cuenta no autorizada.
Crear una primera versión y revisarla antes de ejecutar
Pide primero pseudocódigo: una secuencia breve de pasos permite detectar reglas ambiguas antes de que se conviertan en código. Para este caso podría describir abrir el CSV, comprobar encabezados, recorrer cada fila, validar campos y escribir dos salidas. Pregunta qué considera «fila malformada»: por ejemplo, una fila con menos columnas que el encabezado. Decide además cómo tratar una fila con columnas de más; no dejes esa decisión implícita.
Luego solicita Python sencillo, sin dependencias externas. La biblioteca estándar csv de Python permite leer y escribir datos tabulares; documenta DictReader y DictWriter para trabajar con encabezados y recomienda abrir archivos CSV con newline="". Las filas se reciben como texto, por lo que el programa debe convertir y validar expresamente inversion_eur. No hace falta instalar un paquete para este ejercicio básico.
Antes de ejecutar, inspecciona el código y contesta estas preguntas:
- ¿Lee exactamente el archivo indicado y escribe únicamente las dos salidas solicitadas?
- ¿Comprueba que existan los tres encabezados, sin asumir que están presentes?
- ¿Qué hace si la inversión está vacía, no es numérica o es negativa?
- ¿Registra el número de fila y la causa de rechazo de manera comprensible?
- ¿Añadió paquetes, accesos a red, borrados o comandos que no pediste?
- ¿Sobrescribe un archivo existente? Si sí, ¿has preparado una carpeta desechable?
No ejecutes comandos generados hasta entenderlos. Comprueba que la versión de Python y los nombres de archivos se ajustan a tu equipo; las instrucciones concretas de ejecución pueden variar por sistema y configuración. Mantén una copia del CSV de entrada y trabaja en una carpeta temporal sin datos reales.
Pedir y ejecutar pruebas con tres casos
Pide a Claude que describa los resultados esperados antes de generar los casos de prueba. Así tendrás una referencia independiente y no aceptarás como correcto cualquier resultado que produzca el programa.
| Caso | Entrada ficticia | Resultado esperado |
|---|---|---|
| Normal | Lanzamiento, Email, 125.50 | Una fila válida; canal queda como email y la inversión como valor numérico válido |
| Campo ausente | Lanzamiento, , 125.50 | La fila va a incidencias con un motivo que identifique canal vacío |
| Fila malformada | Una línea con menos campos que los encabezados | No se acepta silenciosamente; se registra la fila y el motivo o se detiene de forma explícita según la regla acordada |
Escribe esos registros en un CSV de demostración pequeño. Añade un encabezado correcto y guarda también una copia de la salida esperada; no introduzcas nombres de campañas reales. Si el caso malformado puede tratarse de más de una forma, elige y documenta una regla antes de ejecutar: separar la fila como incidencia o parar el procesamiento con un error claro.
Ejecuta el programa en tu propio entorno únicamente después de revisar el comando. Comprueba tanto el contenido de campañas_limpias.csv como el de incidencias.csv; verifica que no haya filas duplicadas eliminadas ni cambios inesperados en la entrada. Repite el ejercicio con un archivo vacío y con una inversión no numérica si quieres ampliar cobertura. El módulo csv de Python se ocupa de la lectura y escritura tabular, pero las reglas de validación y qué hacer ante cada anomalía las defines tú.
Claude Code puede proponer o solicitar ejecutar comandos según la interfaz y permisos. La guía oficial de Claude Code Quickstart presenta tareas como pedir cambios y pruebas; la de permisos explica que hay controles por tipo de acción. Eso no sustituye tu revisión: comprueba el comando y el directorio, y no concedas acceso a archivos ajenos al ejercicio.
Depurar y mejorar sin perder el control
Si aparece un error, copia el mensaje después de quitar rutas personales, nombres internos, tokens, claves y cualquier dato de cliente. Añade qué comando ejecutaste, qué esperabas y qué ocurrió, usando el CSV ficticio. Pide una explicación de la causa antes de solicitar cambios; así distingues un defecto de código de una expectativa que nunca especificaste.
Limita la corrección a una modificación verificable: «corrige la lectura de filas con columnas ausentes; no cambies el formato de salida ni toques otros archivos». En Claude Code, compara el diff y verifica que la edición afecte solo a lo acordado. En el chat, compara la versión nueva con la anterior antes de sustituir el archivo. Después repite los tres casos originales, no solo el que falló, porque un arreglo puede romper una ruta que antes funcionaba.
La IA puede proponer una API inexistente, asumir una convención incorrecta o introducir una vulnerabilidad. Confirma los nombres de módulos y funciones en documentación primaria, revisa las dependencias y no ejecutes una solución que no puedas explicar. Si el programa va a procesar información real o integrarse en un proceso de negocio, solicita una revisión técnica adecuada y aplica las normas internas antes de desplegarlo.
Para comparar otro flujo de conversación y programación, consulta nuestra guía de ChatGPT para programar. No es una recomendación de que una herramienta sea universalmente mejor: compara la tarea, los permisos disponibles y cómo puedes verificar la salida.
Privacidad, coste y límites
Usa datos sintéticos. El CSV de este ejemplo no debe contener nombres de clientes, presupuestos reales, identificadores, secretos ni rutas internas. No pegues claves de API en prompts o archivos de prueba. Si necesitas trabajar con código o datos de tu organización, confirma qué servicios y cuentas están autorizados, qué condiciones de tratamiento aplican y qué políticas de retención y acceso corresponden.
El coste depende de la modalidad y la cuenta. La página de planes de Claude publica funciones y precios, pero límites e impuestos pueden cambiar. Claude Code requiere una modalidad compatible; no infieras que está incluido porque puedas abrir el chat. Verifica tu cuenta y facturación antes de empezar.
Una prueba pequeña no acredita seguridad ni idoneidad para producción. Conserva el original y no conectes el programa a sistemas reales hasta validar requisitos y controles.
Si quieres llevar el uso de la IA a tareas de tu trabajo, puedes conocer el enfoque general del curso de IA para marketing; no es un curso específico de programación. Y si aún no tienes claro tu siguiente paso, completa el test ¿Cuánto te queda?.
Preguntas frecuentes
¿Puedo programar con Claude sin usar Claude Code?
Sí. En Claude chat puedes pedir código y explicaciones, guardarlos tú en un archivo y ejecutar las pruebas en tu entorno. Claude Code resulta útil cuando quieres que el agente trabaje sobre una carpeta; consulta el acceso y los permisos disponibles para tu cuenta.
¿Necesito saber Python?
No hace falta dominar el lenguaje para empezar con un ejercicio pequeño, pero sí aprender a leer el código y entender sus efectos. Pide explicaciones, valida cada supuesto y evita ejecutar cualquier comando que no comprendas.
¿Claude ejecuta el código por sí solo?
No lo presupongas. En el chat, el flujo descrito aquí consiste en copiar y ejecutar el código tú. Claude Code puede solicitar acciones sobre el proyecto según la interfaz y los permisos; revisa cada solicitud en vez de asumir ejecución automática.
¿Cómo compruebo que el código funciona?
Ejecuta los casos normal, campo ausente y fila malformada con archivos ficticios, compara las dos salidas con los resultados esperados que definiste y repite las pruebas tras cada cambio. Una respuesta o una prueba propuesta por Claude no es evidencia de que se haya ejecutado.