GUÍA PRÁCTICA PARA DESARROLLADORES
Cómo usar Claude en desarrollo: Claude Code, la API y flujos de agentes
La terminal es el nuevo IDE, y el diff sigue siendo la unidad de confianza.
Los desarrolladores usan Claude de Anthropic de tres formas distintas: como interlocutor de chat para planificar y revisar, como Claude Code ejecutándose directamente en la terminal, y como el modelo detrás de sus propios productos basados en la API. Esta página recorre cómo usar Claude en desarrollo en cada modo, con prompts reales para revisión de código, escritura de tests y tool use, además de los hábitos que mantienen seguro el código generado por IA antes de que llegue a producción.
Cómo usar Claude en desarrollo se reduce a tres superficies: la interfaz de chat de Claude AI para planificar y revisar código, Claude Code para desarrollo agéntico nativo de terminal que lee tu repositorio y edita archivos directamente, y la API de Anthropic para integrar tool use y flujos de agentes en tus propios productos. La mayoría de los desarrolladores empiezan en el chat, trasladan la edición y las pruebas repetitivas a Claude Code, y recurren a la API cuando están lanzando una función impulsada por Claude. Los hábitos que mantienen seguro el código generado por IA son los mismos que mantienen seguro cualquier código: diffs pequeños, tests y revisión antes de fusionar.
Publicado · Última revisión
Lección gratis · sin crear cuentaLas Tres Formas de Usar ClaudeLos Tres Modos5 minEmpezar la lección gratisPuntos clave
- Claude en desarrollo abarca tres superficies: el chat para planificar y revisar código, Claude Code para trabajo en terminal, y la API de Anthropic para construir tus propias funciones de tool use y agentes.
- Claude Code lee tu repositorio, edita archivos en toda la base de código, ejecuta tu suite de tests y puede hacer commit de los cambios, todo desde una sesión de terminal normal.
- Tool use permite que Claude llame a funciones que tú defines, de modo que puede consultar una base de datos, llamar a una API interna o ejecutar un script como parte de la respuesta a una solicitud.
- La revisión de código funciona mejor cuando le señalas a Claude un diff concreto y un estándar concreto contra el cual revisar, no un vago 'mira mi código'.
- Claude puede escribir y ejecutar tests, pero el hábito que mantiene seguro el código generado es el mismo que mantiene seguro el código de cualquier colaborador: diffs pequeños, una suite de tests en verde y revisión humana antes de fusionar.
- Empieza con un archivo CLAUDE.md: una columna vertebral breve del proyecto que le indica a Claude tu stack, tus comandos y tus convenciones para que deje de adivinar.
Claude AI vs. Claude Code vs. la API de Anthropic
| Superficie | Mejor para | Dónde se ejecuta |
|---|---|---|
| Claude AI (chat) | Planificación, discusión de arquitectura, revisar un diff o un stack trace pegado | Navegador o app de escritorio |
| Claude Code | Ediciones en varios archivos, ejecutar tu suite de tests, trabajo autónomo sobre tu repositorio real | Tu terminal, dentro del directorio del proyecto |
| API de Anthropic | Integrar una función o agente impulsado por Claude en tu propio producto, con tool use | El código de tu aplicación, invocado por HTTPS |
Copiar y pegar
Prompts que puedes usar hoy
Revisar un diff de pull request contra un estándar concreto
Estás revisando el diff de un pull request de un servicio Python con FastAPI. Revisa específicamente el riesgo de inyección SQL, la falta de validación de entrada en los cuerpos de las peticiones y cualquier consulta a la base de datos que no esté parametrizada. Enumera cada problema con el archivo y la línea, explica por qué es un problema y propón la solución. No comentes sobre formato ni estilo.
Cambia el lenguaje, el framework y los riesgos concretos que quieras señalar según tu propio stack.
Escribir tests que coincidan con tu estilo existente
Mira los tests existentes en tests/test_orders.py y replica exactamente su estructura, sus fixtures y sus convenciones de nombres. Escribe tests unitarios para la nueva función refund_order en orders/service.py, cubriendo un reembolso exitoso, un intento de reembolso sobre un pedido ya reembolsado y un reembolso que supera el importe original del cargo. Usa pytest y los patrones de mock existentes.
Apúntalo a tu archivo de tests real y a tu framework, ya sea pytest, Jest o Vitest.
Depurar un test inestable con contexto completo
Este test está fallando de forma intermitente en CI pero pasa en local: [pega el nombre del test y el error]. Aquí está el archivo del test, la función que ejercita y los últimos tres logs de fallos de CI. Recorre las posibles causas de la inestabilidad antes de proponer una solución, y dime explícitamente de qué sigues sin estar seguro.
Pega logs y contenido de archivos reales en lugar de describir el bug de memoria.
Diseñar una función de tool use para la API de Anthropic
Estoy construyendo un agente con la API de Anthropic que necesita consultar el estado del pedido de un cliente en nuestra API REST interna. Redacta la definición de la herramienta, incluyendo el JSON schema para sus parámetros de entrada, y muéstrame el código Python que gestiona el bloque tool_use resultante y envía un tool_result de vuelta a Claude.
Sustituye la API interna y los parámetros por la forma de tu propio servicio.
Redactar un CLAUDE.md para un proyecto nuevo
Revisa el package.json, el README y la estructura de carpetas de este repositorio, y luego redacta un archivo CLAUDE.md que documente nuestro stack tecnológico, los comandos para ejecutar los tests y el servidor de desarrollo, nuestras convenciones de nombres para las rutas de la API, y cualquier otra cosa que un nuevo colaborador necesite saber antes de hacer su primer cambio.
Ejecuta esto una vez al inicio de un proyecto, y actualízalo cada vez que cambien las convenciones.
Planificar un refactor multiarchivo antes de tocar el código
Quiero extraer la lógica de pagos que ahora está repartida entre tres controladores en una única clase PaymentService. Antes de escribir código, enumera cada archivo que actualmente contiene lógica de pagos, propón los métodos públicos de la nueva clase, y señala cualquier diferencia de comportamiento entre las tres implementaciones actuales que el refactor deba preservar.
Pide primero el plan en cualquier cambio que afecte a más de dos o tres archivos.
Empieza Aquí
Las lecciones gratuitas con las que todo desarrollador debería empezar
Tres lecciones breves te llevan de saber que Claude existe a ejecutar una sesión real de Claude Code con una columna vertebral de proyecto en su lugar, lo cual es suficiente para empezar a usarlo en trabajo real el mismo día.
Las Tres Superficies
Cómo usan Claude realmente los desarrolladores
Claude en desarrollo no es una sola herramienta. Son tres, y saber cuál se ajusta a la tarea que tienes delante es casi toda la habilidad.
Chat de Claude AI
Útil para discusiones de arquitectura, revisar un diff o un mensaje de error pegado, y pensar un diseño antes de comprometerte a escribir código.
Claude Code
Un agente nativo de terminal que lee tu repositorio, edita archivos en toda la base de código, ejecuta tu suite de tests y puede hacer commit de los cambios cuando tú lo indiques.
API de Anthropic
El modelo más tool use, para integrar Claude en tu propio producto: un bot de soporte que consulta tu base de datos, un asistente dentro del IDE, o un pipeline que se ejecuta sin supervisión.
Flujos de agentes
Combina tool use con un bucle: Claude decide qué herramienta llamar, lee el resultado y decide el siguiente paso, repitiendo hasta que la tarea termina.
Claude Code
¿Qué es Claude Code y cómo empiezo a usarlo?
Claude Code es la herramienta de línea de comandos de Anthropic para trabajar con Claude directamente dentro de tu base de código. En lugar de copiar código a una ventana de chat y pegar de vuelta la respuesta, lo ejecutas desde el directorio de tu proyecto y lee tus archivos, tu historial de git y tu configuración de tests como contexto para lo que le pidas.
Una sesión típica funciona así: abres una terminal en tu repositorio, inicias Claude Code y describes una tarea en lenguaje llano, como añadir rate limiting a tus endpoints POST. Lee los archivos relevantes, propone y aplica las ediciones en todos los archivos que toca el cambio, ejecuta tu suite de tests, y te informa de qué cambió y si los tests pasaron.
Lo que hace a Claude Code distinto de un plugin de editor es que opera sobre la tarea completa, no solo sobre la siguiente línea. Puede planificar un cambio de varios pasos, ejecutar cada paso, notar cuándo falla un test e intentar una corrección, todo dentro de una sola instrucción tuya. Tú te mantienes en el bucle leyendo el plan antes de que se ejecute y revisando el diff antes de hacer commit.
Lo primero que vale la pena configurar es un archivo CLAUDE.md en la raíz de tu proyecto. Es un archivo breve y en lenguaje llano que le indica a Claude tu stack, tus comandos de build y test, tus convenciones de nombres, y cualquier otra cosa que un nuevo colaborador necesitaría saber desde el primer día. Una vez que existe, Claude Code lo lee automáticamente al inicio de cada sesión en lugar de adivinar.
Trabajo Real
Flujos de trabajo que los desarrolladores ejecutan esta semana
Revisión de código centrada en seguridad
Señálale a Claude un diff y una clase concreta de riesgo (bypass de autenticación, inyección, entrada no validada) en lugar de pedir una revisión general.
Escribir y ejecutar tests
Claude lee tus patrones de tests y tu framework existentes, escribe tests que coinciden con tu estilo, los ejecuta e itera sobre los fallos.
Refactorizar entre archivos
Para cualquier cosa que toque más de un par de archivos, pide primero un plan: qué archivos cambian, cómo queda la nueva estructura, qué comportamiento no debe cambiar.
Depurar un bug difícil de reproducir
Dale el test que falla, la función bajo test y logs reales del fallo, y luego pídele que razone sobre las causas antes de proponer una solución.
Orientarse en una base de código desconocida
Pídele a Claude que siga una petición a través de la base de código y explique el flujo, lo cual suele ser más rápido que leer el código en frío.
La API de Anthropic
Tool use, agentes y cómo construir con la API de Anthropic
La API de Anthropic es cómo integras Claude dentro de tu propio producto en lugar de usarlo a través de una ventana de chat. Envías una solicitud con tu prompt y recibes una respuesta, la misma forma que cualquier API HTTP, lo que significa que se integra en cualquier stack de backend que ya uses, ya sea un servicio en Python, una app en Node, o algo completamente distinto.
Tool use es la función que convierte una simple llamada de solicitud-respuesta en algo más parecido a un agente. Describes las herramientas a las que Claude tiene acceso, cada una una función con un nombre, una descripción y un JSON schema para sus entradas, como una función lookup_order que recibe un ID de pedido. Cuando Claude decide que necesita esa herramienta para responder a una pregunta, devuelve un bloque tool_use en lugar de una respuesta directa. Tu código ejecuta la llamada real a la función, lo que sea que eso signifique en tu sistema: una consulta a la base de datos, una llamada a una API, un script, y envía el resultado de vuelta a Claude como un tool_result. Claude lee ese resultado y continúa.
Un agente, en el sentido práctico, es simplemente este bucle ejecutado más de una vez: Claude elige una herramienta, tú la ejecutas, Claude lee el resultado y elige la siguiente, hasta que la tarea está terminada o tiene suficiente información para responder. El Model Context Protocol es un estándar para describir esas herramientas y conexiones de forma consistente, de modo que las mismas definiciones de herramientas puedan funcionar en distintos clientes en lugar de tener que montarse desde cero en cada proyecto.
El streaming es la otra pieza que vale la pena conocer: en lugar de esperar la respuesta completa, la API puede enviar tokens a medida que se generan, que es lo que hace que las interfaces de chat y las sugerencias de código en vivo se sientan fluidas en lugar de lentas.
Mantenerlo Seguro
Cómo mantener seguros los cambios de código de Claude
Nada de esto es específico de la IA. Es la misma disciplina que mantiene seguro el código de cualquier colaborador, aplicada de forma consistente.
Mantén los diffs pequeños
Pide un cambio a la vez. Un diff de cinco archivos se revisa en diez minutos; un diff de cincuenta archivos se aprueba de forma automática, que es justo cuando se escapan los bugs.
Tests antes de fusionar, no después
Haz que Claude escriba o actualice tests como parte de la misma tarea, y exige que pasen antes de considerar terminado el diff.
Lee el diff tú mismo
Claude puede explicar qué cambió y por qué, pero la persona que hace commit del código sigue siendo responsable de haberlo leído realmente.
Nunca pegues secretos en un prompt
Las claves de API, las credenciales y los datos de clientes no tienen más cabida en el historial de chat o en sesiones de Claude Code que en un mensaje de Slack.
Enséñale tus convenciones una vez
Un archivo CLAUDE.md con tu stack, tus comandos y tu guía de estilo reduce las correcciones de ida y vuelta que consumen una sesión.
Por Dónde Empezar
La ruta de inicio para desarrolladores
Si eres nuevo usando Claude como desarrollador, la forma más rápida de entrar son tres lecciones breves, en orden. Empieza con Las Tres Formas de Usar Claude en el curso Los Tres Modos, que plantea la misma distinción entre chat, Claude Code y API cubierta arriba, para que sepas a qué superficie recurrir antes de abrir una terminal.
A partir de ahí, pasa a Claude Code: Construir con Palabras, también dentro del curso Los Tres Modos. Recorre cómo es una sesión real de Claude Code: describir una tarea en lenguaje llano, ver cómo lee tu repositorio y aplica ediciones, y revisar el resultado antes de que se publique.
La tercera parada es CLAUDE.md: la columna vertebral de tu proyecto, del curso La Configuración del Practicante. Aquí es donde aprendes a escribir el archivo que evita que Claude vuelva a adivinar tu stack, tus comandos y tus convenciones en cada sesión, que es el hábito que hace que cada sesión posterior sea más rápida.
Una vez hechas esas tres, el resto del curso La Configuración del Practicante cubre hooks y automatización, conectar Claude a tu stack mediante servidores MCP, y construir un flujo de trabajo semanal de operador, que es donde realmente se multiplica el lado del hábito diario de usar Claude como desarrollador.
Límites
En qué se equivoca Claude, y dónde sigue siendo tu responsabilidad
Claude puede equivocarse con seguridad. Puede proponer una corrección que pasa los tests que le diste mientras pasa por alto un caso límite que no se te ocurrió probar, o usar una función de una librería que no existe. Trata su salida como un borrador sólido de un colaborador rápido y bien informado, no como una decisión ya tomada.
El código generado necesita la misma revisión de seguridad que el código escrito por humanos, y posiblemente más atención las primeras veces que trabajas con él, hasta que hayas calibrado dónde tiende a equivocarse en tu base de código específica. No te saltes una revisión centrada en seguridad en nada que toque autenticación, pagos o datos de usuarios solo porque salió de una herramienta que escribe código fluido.
El código fuente confidencial, los datos de clientes y las credenciales no deberían entrar en ninguna herramienta de IA sin comprobar antes la política de tu organización. Si trabajas en algún sitio con una política de manejo de datos o una obligación de confidencialidad con el cliente, esa obligación no cambia porque el revisor sea un modelo en lugar de una persona.
Por último, la autonomía es un dial, no un interruptor. Claude Code puede ejecutar tests e incluso hacer commit por su cuenta si lo dejas, pero el hábito profesional es mantener un paso de revisión humana antes de que algo llegue a una rama compartida o a producción, la misma barrera que querrías en el primer mes de pull requests de un nuevo integrante.
Empieza la lección gratuita que explica las tres formas de usar Claude
Leer sobre cómo usar Claude en desarrollo y realmente ejecutar Claude Code en tu propia terminal son cosas distintas. El plan de estudios de Nightschool AI es práctico desde la primera lección, empezando con la misma distinción entre chat, Claude Code y API cubierta en esta página.
Preguntas frecuentes
¿Cómo usan Claude los desarrolladores?
Los desarrolladores suelen usar Claude en tres superficies: la interfaz de chat de Claude AI para planificar, discutir diseño y revisar código pegado; Claude Code para trabajo nativo de terminal donde Claude lee y edita un repositorio real; y la API de Anthropic para integrar Claude, incluyendo tool use y bucles de agentes, en sus propios productos.
¿Qué es Claude Code y cómo empiezo a usarlo?
Claude Code es una herramienta de línea de comandos que ejecuta Claude directamente dentro de tu proyecto. La inicias desde el directorio raíz de tu repositorio y describes una tarea en lenguaje llano; lee tus archivos y tu CLAUDE.md, hace las ediciones, ejecuta tus tests e informa el resultado. Configurar primero un archivo CLAUDE.md, describiendo tu stack y tus comandos, hace que las primeras sesiones sean mucho más precisas.
¿Es Claude bueno para la revisión de código?
Sí, especialmente cuando le das un diff concreto y un estándar concreto que revisar, como problemas de seguridad, falta de validación de entrada, o adherencia a las convenciones de tu equipo. Rinde mucho mejor cuando se le pide revisar algo concreto que cuando se le da un vago 'revisa mi código', igual que un revisor humano hace mejor trabajo con criterios de revisión claros.
¿Cómo uso la API de Anthropic?
Envías una solicitud HTTP con tu prompt y recibes una respuesta de texto, la misma forma que cualquier llamada a una API, que puedes invocar desde Python, Node, o cualquier backend que uses. Para construir algo más que una simple pregunta y respuesta, añades tool use, dándole a Claude funciones que puede llamar, y gestionas el intercambio resultante de tool_use y tool_result en tu propio código.
¿Qué es tool use en Claude?
Tool use te permite describir funciones que Claude puede llamar, como buscar un pedido o consultar una base de datos, cada una con un nombre y un JSON schema para sus entradas. Cuando Claude decide que necesita una herramienta, devuelve una solicitud tool_use en lugar de una respuesta directa; tu código ejecuta la función real y envía el resultado de vuelta para que Claude continúe, lo cual es la base de la mayoría de los flujos de agentes.
¿Puede Claude escribir tests para mi código?
Sí. Claude puede leer tus patrones de tests y tu framework existentes, ya sea pytest, Jest o Vitest, y escribir tests unitarios, de integración o de extremo a extremo que coincidan con tu estilo. En Claude Code, también puede ejecutar los tests que escribe y corregir los fallos de forma iterativa, en lugar de entregarte tests que luego tienes que depurar tú mismo.
¿Cómo mantengo seguros los cambios de código de Claude?
Mantén la misma disciplina que querrías de cualquier colaborador: pide diffs pequeños en lugar de cambios masivos, exige tests en verde antes de que algo se fusione, lee el diff tú mismo antes de hacer commit, y nunca pegues secretos o datos de clientes en un prompt. Un archivo CLAUDE.md reduce los errores que vienen de que Claude adivine tus convenciones.
¿Con qué lenguajes de programación trabaja Claude?
Claude trabaja con lenguajes mayoritarios incluyendo Python, TypeScript, JavaScript, Go, Rust, Java, C/C++, Ruby y PHP, y entiende patrones de framework comunes para herramientas como React, Next.js, Django y FastAPI. Claude Code funciona con cualquier lenguaje que se ejecute en una terminal, ya que opera directamente sobre tus archivos y comandos de shell en lugar de a través de un plugin específico de lenguaje.
¿Es gratis instalar Claude Code?
Claude Code en sí es gratis de instalar. Usarlo requiere, o bien una clave de API de Anthropic, facturada por token, o un plan de suscripción de Claude que incluya acceso a Claude Code. No hay una tarifa de licencia adicional por encima de eso para la herramienta de línea de comandos.
Lecturas relacionadas
Pasa de leer sobre Claude a ejecutarlo en tu terminal
La primera lección toma minutos; el hábito es lo que compensa.