Construyendo con Claude Code
Escribir código que llama a la API de Claude a mano funciona bien, pero hay un camino aún más rápido: que Claude lo escriba por ti. En esta lección, usaremos Claude Code para completar una integración de API a partir de un archivo con código de relleno — usando las mismas primitivas que has aprendido a lo largo de este curso.
Empezando desde un código de relleno
El proyecto es simple: un archivo TypeScript que obtiene el clima. Contiene dos códigos de relleno:
- getWeather — acepta una ciudad y devuelve la temperatura y las condiciones.
- run — una función que debería usar el ejecutor de herramientas y el SDK de TypeScript de Claude.
El ejecutor de herramientas es la pieza que maneja el uso de herramientas y el bucle del agente por ti, para que no tengas que conectar eso manualmente.
La skill de la API de Claude
Claude Code viene con una skill integrada llamada Claude API. Puedes invocarla directamente con /claude-api, o Claude Code la invocará automáticamente cuando detecte que estás usando el SDK de TypeScript.
Un prompt, código funcional
Abre la carpeta del proyecto en tu terminal y lanza Claude Code.
A partir de ahí, solo se necesita un único prompt. Un buen prompt hace tres cosas:
- Nombra el archivo que quieres cambiar.
- Nombra el patrón que quieres usar.
- Nombra el estado final que esperas.
Claude Code entonces completa getWeather y run según los tipos, añade una llamada al final del archivo, ejecuta el script y reporta el resultado. Si algo falla, lee el mensaje de error y corrige el código en el lugar.
Lo que produjo Claude Code
En esta ejecución, Claude Code creó una herramienta Zod que analizó la entrada y devolvió la salida según el tipo de ciudad. También creó el ejecutor de herramientas y la función run que pedimos, e imprimió los resultados finales del bucle del agente.
El patrón que hay que recordar
La mayor parte de lo que escribes contra la API de Claude tiene una forma familiar:
- Define una herramienta.
- Entrégala a un ejecutor.
- Devuelve el resultado.
No necesitas escribir eso de memoria cada vez. En su lugar, crea el código de relleno del archivo, entrégalo a Claude Code y simplemente revisa el diff.
Resumen
- Claude Code es un agente que edita archivos y ejecuta comandos dentro de tu terminal.
- La skill integrada de Claude API se carga automáticamente cuando Claude Code detecta el SDK de TypeScript, o puedes invocarla con
/claude-api. - Dale un prompt que nombre el archivo, el patrón y el estado final — escribe el código, lo ejecuta y corrige errores en el lugar.
- El código de la API de Claude sigue una forma familiar: define una herramienta, entrégala a un ejecutor, devuelve el resultado. Crea el código de relleno, delégalo, revisa el diff.