Curso
Claude Code 101
3 h
28.3K
Usar la API de Claude de Anthropic te permite ir más allá de simplemente chatear con un bot. Te da el poder de integrar todas las capacidades de Claude IA en tus aplicaciones.
Anthropic dejó boquiabierto al mundo de la IA con el lanzamiento de Fable 5, un modelo tan capaz que llevó al gobierno de EE. UU. a restringir temporalmente su acceso poco después de su lanzamiento. Aunque el acceso ya se ha restablecido a nivel mundial, ha cambiado la forma de acceder a él.
Anthropic ahora limita Fable 5 exclusivamente al acceso vía API con créditos de uso medido (con la restricción efectiva tras una breve ampliación de cinco días).
Esto implica repensar cómo interactuamos con la IA. Los modelos de altas prestaciones y las herramientas de codificación automatizada requieren muchos más recursos de computación de los que pueden ofrecer los planes de consumo con tarifa plana.
En este tutorial te prepararé para esta nueva realidad explicando cómo usar la API de Claude.
Te enseñaré exactamente cómo configurar Claude Code con la API para desarrolladores de Anthropic. Al pasarte hoy mismo al modelo de pago por uso, asegurarás un acceso ininterrumpido a modelos de vanguardia como Fable 5, eliminarás límites invisibles de uso y aprenderás a ejecutar sesiones de codificación complejas directamente desde tu terminal.
Si buscas una referencia rápida, te recomiendo consultar el cheat sheet de la API de Claude en Python.
Por qué necesitas la API de Claude en lugar de una suscripción a Claude Pro
Para muchos, el plan mensual de Claude Pro por 20 $ era la forma ideal de acceder a una IA de primer nivel. Ofrecía un precio fijo y acceso estable.
Sin embargo, el auge de las herramientas de codificación automatizada ha cambiado por completo la ecuación. Los flujos de trabajo con agentes requieren muchos más recursos de los que puede proporcionar una suscripción estándar, lo que convierte a la API de Claude en la única opción viable para desarrolladores serios.
A continuación tienes tres razones principales para dejar la suscripción y usar Claude Code directamente a través de la API.
Agotamiento de tokens con herramientas agenticas
Los planes estándar sufren con herramientas como Claude Code por cómo funcionan estas herramientas.
A diferencia de un simple chat web, una herramienta de desarrollo automatizada debe escanear constantemente todo nuestro proyecto para entender en qué está trabajando.
Cada vez que le damos una tarea, pasa por varias etapas: leer archivos, comprobar estructuras y ejecutar pruebas. Esto exige enviar una gran cantidad de datos de un lado a otro para mantener a la IA al día del estado actual de nuestro código.
Este proceso consume tokens muy rápido. Con una suscripción Pro, estos flujos de trabajo complejos pueden agotar nuestro límite de uso de varias horas en solo unos minutos, deteniendo el trabajo en seco.
Protege tu capacidad diaria de uso
Las cuentas de Claude Pro comparten un mismo pool de recursos. Si usamos nuestra cuenta principal para codificar desde el terminal, esas tareas automatizadas tan pesadas restarán capacidad a lo que tenemos disponible en el navegador o la app móvil.
No queremos quedarnos sin poder mantener una conversación sencilla porque una tarea de codificación en segundo plano alcanzó nuestro tope. Enrutar tus herramientas de desarrollo a través de la API de Claude mantiene tu trabajo de programación profesional totalmente separado de tu uso cotidiano de la IA.
Acceso exclusivo a modelos de alta exigencia
A medida que Anthropic lanza modelos diseñados específicamente para ingeniería intensiva y trabajo autónomo, como Claude Fable 5, se está alejando de los planes de tarifa plana.
Como Fable 5 requiere una potencia de cómputo enorme, Anthropic ha confirmado que este modelo en concreto acabará requiriendo facturación por uso para gestionar los altos costes operativos.
Esta restricción es un adelanto de lo que viene. Si te quedas en una suscripción de consumo, acabarás perdiendo acceso a los motores de razonamiento más potentes de Anthropic, por lo que tener una cuenta de la API de Claude será imprescindible para mantenerte a la vanguardia.
API de Claude vs suscripción a Claude
La diferencia entre una suscripción de consumo y la API para desarrolladores se reduce a un equilibrio entre costes previsibles y acceso ininterrumpido.
Una suscripción a Claude nos da una tarifa mensual fija.
Podemos usarlo de forma intensiva un tiempo y, finalmente, alcanzaremos un tope de uso dinámico según la carga del servidor. Cuando Claude Code se topa con este muro invisible a mitad de proyecto, deja de funcionar por completo.
Nos obliga a esperar varias horas a que el límite se restablezca antes de que el agente pueda terminar de escribir nuestro código.
La API de Claude quita estas rueditas. No hay topes horarios de mensajes, ni límites de ancho de banda compartido, ni periodos de espera. Si queremos que Fable 5 refactorice una base de código masiva durante ocho horas seguidas, la API ejecutará cada comando sin interrupciones.
Ahora bien, esta libertad introduce un peligro importante: desbordes de presupuesto. Usar una suscripción puede ser frustrante al chocar con el límite, pero al menos sabemos exactamente cuánto pagaremos a fin de mes.
Esto es especialmente delicado con modelos caros como Fable 5.
Gestión de costes y control de presupuesto en la API de Claude
Hay dos formas de controlar el presupuesto al usar la API.
La primera es asegurarte de que la recarga automática esté desactivada. La recarga automática permite a Claude comprar créditos automáticamente cuando se agotan.
Dado que el consumo de tokens con Claude Code es muy impredecible, te recomiendo encarecidamente no activarla.
La segunda es seleccionar con cuidado qué modelo se usa.
Fable 5 es extremadamente capaz resolviendo tareas complejas e implementando aplicaciones sofisticadas. Sin embargo, a menudo es excesivo para tareas sencillas.
Personalmente prefiero usar los modelos más económicos y pasar a otros más caros solo cuando los baratos no logran resolver una tarea tras varios intentos. El modelo que más uso, de hecho, es Haiku 4.5.
Para seleccionar el modelo, usa el comando /model.
Configuración paso a paso de la API de Claude (con Fable 5)
Si buscas un tutorial específico de la API de Claude Fable 5, te recomiendo consultar nuestra guía aparte.
Para empezar, inicia sesión en la plataforma web de Claude y configura la facturación. Después, abre un terminal e instala Claude Code con el comando:
npm install -g @anthropic-ai/claude-codeUna vez instalado, podemos ejecutarlo escribiendo claude en el terminal. La primera vez que se ejecute, nos pedirá configurarlo. Asegúrate de seleccionar «API usage billing» durante la configuración:
Finalmente, Claude abrirá el navegador y pedirá permiso para vincular nuestra cuenta y crear una clave de API. Haz clic en «Authorize» y la cuenta se vinculará automáticamente.
Con la configuración completada, ya estamos listos para empezar a crear con Claude Code:
En mi caso, Claude Code ya está ejecutándose con Fable 5. Si no es así, podemos seleccionar el modelo usando el comando /model y eligiendo Fable 5 en el menú.
Cambiar Claude Code de suscripción a API
Si ya has estado usando Claude Code con una suscripción y quieres pasar a la facturación por uso de la API, el proceso es sencillo.
- Cierra sesión con el comando
/logout. - Vuelve a ejecutar Claude Code con el comando
claudey selecciona el método de acceso «Anthropic Console account · API usage billing».
Si en algún momento nos quedamos sin créditos mientras Claude Code está en medio de implementar una funcionalidad, se detendrá y te avisará para que añadas créditos.
Tras añadir créditos, si Claude sigue encendido, solo tienes que pedirle que continúe con un prompt y retomará donde lo dejó. Si no está en ejecución, usa el comando claude --continue.
Crear un proyecto real con la API de Claude
El objetivo de este tutorial es aprender a configurar Claude Code con la API, más que ofrecer una guía detallada de uso de Claude Code.
Si quieres profundizar, te recomiendo apuntarte a nuestro curso Claude Code 101.
Descripción del proyecto
La meta de este proyecto es crear una app en Python que permita a los usuarios localizar fácilmente fotos en su ordenador.
Hoy en día, la gente hace muchísimas fotos y a menudo acaban desordenadas y repartidas en varios sitios. En mi caso, como fotógrafo, suele ser un dolor de cabeza localizar una foto meses después de haberla tomado.
La idea de la app es que los usuarios puedan encontrar sus fotos describiendo lo que aparece en la imagen o proporcionando una captura de pantalla o una imagen de referencia.
Este segundo modo me resulta especialmente útil porque suelo publicar mi trabajo en redes sociales, así que me permitiría simplemente hacer una captura de la publicación y localizar el archivo original en alta calidad.
Podríamos dejar que Claude Code defina la arquitectura del proyecto y haga toda la implementación. Probablemente funcionaría bien.
Pero, por motivos didácticos, quise definir yo mismo la arquitectura del proyecto y dejar que Claude Code se centrase en la implementación.
Arquitectura del proyecto con CLAUDE.md
Para crear esta app, preparé un archivo CLAUDE.md describiendo la arquitectura del proyecto.
Un archivo CLAUDE.md es una configuración Markdown específica del proyecto que Claude Code lee al inicio de cada sesión para establecer una memoria persistente de tu arquitectura, estándares de código y preferencias de trabajo.
La app tiene dos componentes principales:
- Un proceso de ingesta de fotos que permite al usuario seleccionar una carpeta con imágenes, convertir esas imágenes en vectores y almacenarlas en una base de datos vectorial.
- Una entrada multimodal que permite al usuario buscar en la base de datos.
Para codificar imágenes en vectores, usamos el modelo CLIP. Para la base de datos, usamos ChromaDB, que se ejecuta localmente y es gratis.
La intuición de cómo funciona es que el modelo CLIP está entrenado para convertir texto e imágenes en vectores (una representación numérica de los datos) de modo que las imágenes que se parecen o contienen conceptos similares queden cerca en este mapa, mientras que las no relacionadas se alejan entre sí.
Cuando queremos localizar una imagen, también convertimos la consulta en un vector de búsqueda y usamos ChromaDB para encontrar los vectores más cercanos a dicho vector de consulta.
Si quieres saber más sobre bases de datos vectoriales, echa un vistazo a este tutorial de ChromaDB: guía paso a paso.
El prompt
Con la arquitectura definida en el archivo CLAUDE.md, abrí un terminal en esa carpeta y le di a Claude Code, ejecutando el modelo Fable 5, el siguiente prompt:
Build a desktop graphical app for my photography search engine with Python.
First, plan the application architecture exactly as outlined in the CLAUDE.md file, ensuring the GUI can handle both folder ingestion and searching.
Create a virtual environment, install the necessary dependencies (including customtkinter and raw image processing libraries), and save them to requirements.txt.
Write the application logic, paying special attention to background threading for the ingestion process. El resultado
Envié el prompt y dejé que Claude Code hiciera su magia. En unos siete minutos, había terminado.
Ejecuté la app y así es como se veía:
Subí algunas imágenes que hice este año y luego fui a Instagram e hice una captura de una publicación mía para usarla como imagen de referencia.
Incluí a propósito toda la interfaz para que a la app le resultara más difícil encontrar la imagen original. Esto es lo que obtuve:
He de decir que funciona bastante bien y la interfaz es exactamente lo que tenía en mente. También lo probé con búsqueda por texto intentando encontrar fotos del Taipei 101, el edificio más alto de Taiwán.
Estos son los resultados:
Uso de tokens de la API de Claude y costes reales
En total, crear este proyecto costó 3,65 $ en tokens de API. Podemos obtener un desglose detallado del coste de una sesión con el comando /cost:
Curiosamente, vemos que también usó claude-haiku-4.5 para parte del trabajo.
Esto demuestra que Fable 5 es bastante caro.
Una sesión de siete minutos en un proyecto en blanco ya nos costó 3,65 $.
Así que solo puedo imaginar cuánto costaría usar Fable 5 en un proyecto existente con cientos de archivos de código.
Por supuesto, en el mundo real, al crear una aplicación que también genera ingresos, estos costes deben evaluarse de forma distinta, pues pasan a ser una inversión.
Funciones avanzadas de la API de Claude que deberías conocer
Pasarte a la API te da acceso a herramientas que Claude.ai no ofrece: caché de prompts, procesamiento por lotes y uso de herramientas.
Si usas Claude Code, enrutas volúmenes altos de llamadas a la API o construyes sistemas agenticos que interactúan con servicios externos, estas son las funciones que más impactan en tu coste y latencia.
1. Caché de prompts (reducción de costes)
La caché de prompts almacena en el servidor las partes estáticas de tu ventana de contexto entre llamadas a la API, para que dejes de pagar por reprocesar lo mismo en cada petición.
Si trabajas con Claude Code, probablemente estés enviando el mismo contexto grande en cada llamada (un archivo CLAUDE.md, un resumen de la base de código o un prompt de sistema largo). Según la documentación de caché de Anthropic, los prefijos en caché reducen los costes de entrada hasta un 90% y acortan el tiempo hasta el primer token, ya que el prefijo evita la reingesta.
La primera petición paga el precio completo de entrada. Cada llamada posterior que use el mismo prefijo de caché se factura a la tarifa reducida.
2. La Batch API (procesamiento asíncrono)
La Batch API gestiona cargas de trabajo que no requieren respuestas en tiempo real.
Procesar 10.000 tickets de soporte, generar documentación para una base de código completa o ejecutar evaluaciones sobre un conjunto de pruebas grande: todo ello es adecuado para lotes. Anthropic cobra las solicitudes por lotes al 50% del coste estándar de tokens de entrada y salida, y puedes enviar todo el trabajo en una sola llamada a la API sin tener que gestionar una cola.
La limitación es que los trabajos por lotes pueden tardar hasta 24 horas en completarse y los resultados llegan de golpe, no en streaming. Perfecto para pipelines offline, pero inadecuado para interfaces de cara al usuario.
3. Uso de herramientas y Model Context Protocol (MCP)
El uso de herramientas (a veces llamado function calling) permite a Claude invocar funciones externas durante la generación e incorporar los resultados en su respuesta.
Defines las herramientas disponibles en formato de esquema JSON; Claude decide cuándo llamarlas, qué argumentos pasar y qué hacer con la salida. Así, Claude puede consultar una base de datos, llamar a una API REST o ejecutar un script de Python sin que tengas que indicar el punto exacto de invocación en tu prompt.
El Model Context Protocol (MCP) amplía esto con una interfaz de servidor estandarizada: en lugar de definir herramientas por proyecto, Claude se conecta a un servidor MCP local que expone acceso a archivos, ejecución de código o lecturas de base de datos.
La Computer Use API funciona de forma distinta. Claude interpreta una captura de pantalla y emite eventos de teclado y ratón, navegando por interfaces sin acceso programático a la API de la aplicación subyacente.
Conclusión
Pasarte a la API de Claude es un paso necesario para ejecutar herramientas de desarrollo automatizadas, pero exige cambiar cómo gestionamos nuestros proyectos.
Fable 5 es, sin duda, un modelo de codificación sobresaliente, capaz de generar aplicaciones complejas y funcionales a partir de un único prompt.
Su capacidad de razonamiento puede convertir una visión arquitectónica en una realidad funcional en minutos, algo realmente impresionante.
Sin embargo, usar la API de Claude para alcanzar este nivel de potencia tiene un precio. Dado que modelos como Fable 5 son muy caros de operar, es crucial ser estratégico al seleccionar el modelo.
Te recomiendo apoyarte en modelos más económicos y eficientes para tareas rutinarias y reservar Fable 5 para cuando te encuentres verdaderos bloqueos o retos arquitectónicos complejos que requieran un razonamiento más profundo.
Como vimos en nuestro proyecto, incluso en una aplicación relativamente sencilla de un solo archivo, los costes en tokens de la API pueden acumularse rápido. Protege tu bolsillo vigilando de cerca tu uso y, sobre todo, desactiva la recarga automática para que una sesión de codificación automatizada no se lleve por delante tu presupuesto.
Si quieres conocer más sobre el ecosistema de Claude, te recomiendo nuestro curso Claude 101.
