Claude Code pone el modelo de IA más capaz de Anthropic directamente en tu terminal para que escribas, edites, depures y publiques código usando lenguaje natural. Este artículo repasa la instalación, tus primeros comandos reales, las operaciones con archivos, los flujos de trabajo con git y los atajos de productividad que de verdad importan en el desarrollo diario.
Si llevas todo el último año viendo cómo se multiplican las herramientas de programación con IA en cada IDE, extensión del navegador y panel SaaS, quizá te preguntes cuál encaja de verdad con tu forma de trabajar. Claude Code es la respuesta de Anthropic a esa pregunta, y adopta un enfoque deliberadamente distinto: en lugar de vivir en una barra lateral o en una pestaña del navegador, se ejecuta directamente dentro de tu terminal. Escribes. Responde. Lee tus archivos. Escribe y edita código. Ejecuta comandos. Y hace todo esto sin que tengas que salir del entorno en el que ya haces tu mejor trabajo.
Este artículo repasa los requisitos previos, la instalación, tus primeros comandos, los flujos de trabajo del día a día y los ajustes que importan cuando vas más allá de lo básico.
En el momento en que ejecutas claude en tu terminal, la experiencia es distinta a la de una interfaz de chat. Claude Code es un asistente de programación agéntico: no se limita a responder preguntas, sino que realiza acciones. Lee archivos, escribe código, ejecuta comandos de shell y recorre la estructura de tu proyecto a partir de instrucciones en lenguaje natural.
La diferencia importa por razones prácticas. Un chatbot te da texto para copiar y pegar. Claude Code abre el archivo. Un chatbot pierde el contexto cuando pegas un fragmento. Claude Code lee toda tu base de código y la mantiene en contexto durante toda la sesión. Un chatbot espera tu siguiente mensaje. Claude Code puede encadenar varios pasos: ejecutar una prueba, leer el fallo, corregir el código y volver a ejecutar la prueba en una sola operación continua.
Esto es lo que Anthropic quiere decir con "agéntico": el modelo realiza acciones reales en un entorno real, no se limita a generar texto para que tú lo ejecutes a mano.
Claude Code tiene acceso, por defecto, a todo lo que hay en el directorio de tu proyecto. Esto es con lo que trabaja:
El modelo que impulsa todo esto es el propio Claude. Si quieres probar las capacidades de Claude en el navegador antes de llevar prompts a tu flujo de trabajo en la terminal, PicassoIA te da acceso directo a Claude Opus 4.7 y Claude 4 Sonnet.
Claude Code se ejecuta sobre Node.js. Antes de nada, comprueba tu versión:
node --version
Necesitas Node 18 o superior. Si tienes una versión anterior, actualízala con nvm, con el gestor de paquetes de tu sistema o con el instalador oficial de nodejs.org. El gestor de paquetes npm viene incluido con Node, así que ahí no hace falta nada más.
Esta es una referencia rápida:
| Requisito | Versión mínima | Comando de comprobación |
|---|---|---|
| Node.js | 18.x o superior | node --version |
| npm | 8.x o superior | npm --version |
| Acceso a la API de Anthropic | Cuenta activa | console.anthropic.com |
Claude Code se conecta a la API de Anthropic con tu cuenta. Necesitarás una credencial de API de la consola de Anthropic. Si ya usas la API de Claude en otro proyecto, la misma credencial sirve. Crear una cuenta nueva y generar un token lleva menos de cinco minutos.
💡 Nota de seguridad: guarda tu credencial de API en una variable de entorno o en el llavero del sistema. Nunca la escribas directamente en un archivo del proyecto ni la subas al control de versiones. Claude Code gestiona el almacenamiento seguro automáticamente tras el primer paso de autenticación.
La facturación se hace a través de tu cuenta de Anthropic a las tarifas estándar de la API, contabilizada por token igual que el uso directo de la API. Para la mayoría de desarrolladores que usan Claude Code en su trabajo diario, los costos son comparables a una suscripción SaaS de gama media al mes, aunque esto varía mucho según la frecuencia con la que hagas sesiones largas con varios archivos.
Instala Claude Code de forma global con npm:
npm install -g @anthropic-ai/claude-code
Esa es toda la instalación. No hay dependencias adicionales, ni paso de compilación, ni configuración de Docker. Cuando termina la instalación, el comando claude está disponible en cualquier lugar de tu sistema.
Comprueba que funcionó:
claude --version
Deberías ver una cadena con la versión en la salida. Si el comando no se encuentra, verifica que el directorio de binarios globales de npm esté incluido en tu PATH. En macOS con nvm, normalmente es ~/.nvm/versions/node/<version>/bin. En Linux con una instalación de Node del sistema, suele ser /usr/local/bin o /usr/bin.
La primera vez que ejecutes claude, te guiará por una configuración única:
claude
Se te pedirá que pegues tu credencial de API de Anthropic. Claude Code la cifra y la guarda en el almacenamiento seguro de tu sistema, así que no tendrás que volver a introducirla en las siguientes sesiones.
Tras la autenticación, llegas a un REPL interactivo con un prompt y un cursor parpadeante. Eso es todo. La herramienta está lista.
> _
Algunas opciones que conviene conocer desde el principio:
| Opción | Efecto |
|---|---|
--print | Salida de una sola vez, sin modo interactivo |
--help | Muestra todas las opciones disponibles |
--version | Muestra la versión instalada |
--dangerously-skip-permissions | Aprueba automáticamente todas las escrituras de archivos y comandos |
El punto de entrada más natural es pedirle a Claude Code que cree algo nuevo. Ve al directorio de un proyecto y abre una sesión:
claude
Después, escribe tu petición en lenguaje natural:
Create a Python script that reads a CSV file and outputs a statistical summary for each column.
Claude Code escribe el script en tu directorio de trabajo, elige un nombre de archivo razonable, añade las importaciones y el manejo de errores adecuados, y te muestra exactamente lo que ha producido. No especificaste un nombre de archivo, firmas de funciones ni formato de docstring. Lo ha inferido todo a partir del contexto y de las convenciones estándar de Python.
La naturaleza conversacional de Claude Code se ve con más claridad cuando haces seguimiento:
Now add support for reading from multiple CSV files and merging them before generating the summary.
Claude Code lee el archivo que acaba de crear, analiza la estructura existente y la amplía sin romper lo que ya funciona. Este ir y venir es lo que lo diferencia de los generadores de código de una sola pasada: cada seguimiento se apoya en el estado real de tu proyecto, no en un fragmento copiado en una ventana de chat.
En las bases de código existentes, el flujo de trabajo es igual de directo. Abre una sesión en la raíz de tu proyecto y describe el cambio:
In src/api/users.js, the getUserById function makes two separate database calls when one would be sufficient. Fix it.
Claude Code lee el archivo, localiza la función, la reescribe y te muestra un diff antes de hacer ningún cambio. Puedes aprobarlo, rechazarlo o pedir otro enfoque. El ciclo de editar y confirmar te da el control de cada modificación sin ralentizar el flujo de trabajo.
Para cambios más amplios, puedes ser menos prescriptivo con la implementación:
Refactor the authentication middleware in src/middleware/ to use async/await instead of callbacks.
Claude Code recorre el directorio, lee todos los archivos relevantes y aplica la refactorización de forma uniforme en todo, en una sola operación.
Una gran ventaja frente a las herramientas de autocompletado sencillas es la capacidad de Claude Code de trabajar con varios archivos en una misma sesión. Puedes pedirle que:
El modelo mantiene el contexto de tu base de código durante la sesión y razona de forma explícita sobre las relaciones entre archivos. No se limita a lo que tienes abierto en el editor, y no te obliga a buscar y pegar a mano los fragmentos de código relevantes en una ventana de chat.
Claude Code se integra con Git sin ninguna configuración. Dentro de una sesión, describe lo que quieres hacer y deja que se encargue de la mecánica de la shell:
Commit the changes I just made with a meaningful commit message.
Claude Code ejecuta git diff --staged, lee lo que ha cambiado, escribe un mensaje adecuado basado en el contenido real del diff y ejecuta el commit. O bien:
Create a new branch for the payment refactor and push it to origin.
Creación de ramas, cambio de rama y push, todo gestionado en secuencia sin que escribas ni un solo comando de Git.
💡 Consejo: pídele a Claude Code que explique su plan de Git antes de ejecutarlo. Escribe
explain what you're about to doantes de cualquier operación de Git para obtener una vista previa en lenguaje natural de los comandos exactos que va a ejecutar.
Esto resulta especialmente práctico para los desarrolladores que tienen claro lo que quieren conseguir pero a veces necesitan buscar la opción exacta para un caso concreto. Claude Code ya las conoce.
De forma predeterminada, Claude Code pide tu confirmación antes de escribir archivos o ejecutar comandos de shell. Cada acción potencialmente irreversible muestra un mensaje de y/n antes de ejecutarse. Este es el ajuste adecuado para bases de código de producción y para cualquier proyecto que te importe.
Cuando estás haciendo prototipos rápidos en un directorio desechable, puedes omitir esos mensajes:
claude --dangerously-skip-permissions
O conceder la aprobación automática para toda una sesión desde el propio prompt interactivo.
| Modo | Comportamiento | Ideal para |
|---|---|---|
| Predeterminado | Pide confirmación antes de todas las escrituras y comandos | Código de producción, proyectos reales |
| Aprobación automática | Se ejecuta de inmediato, sin mensajes | Prototipos, scripts desechables |
| Solo lectura | Sin escritura de archivos ni ejecución de comandos | Revisión de código, sesiones de preguntas y respuestas |
Para el trabajo diario en proyectos reales, el modo predeterminado es el correcto. Los mensajes de confirmación añaden dos segundos y te protegen de sobrescrituras accidentales o de cambios aplicados por error.
Para el prototipado rápido en un directorio temporal, la aprobación automática acelera mucho las iteraciones. Puedes repasar una docena de variaciones de un script en minutos sin interrumpir el flujo creativo.
Para leer y revisar código desconocido, merece la pena usar deliberadamente el comportamiento de solo lectura. Claude Code puede leer una base de código completa, explicar cómo funciona, responder preguntas de arquitectura y seguir los flujos de datos sin tocar ni un solo archivo de tu repositorio.
Cuando una prueba falla y la traza de la pila no es evidente de inmediato, el bucle de depuración de Claude Code reduce mucho el tiempo hasta la solución:
The test suite is failing. Read the output in /tmp/test-results.log and identify the root cause.Claude Code lee el registro, sigue los archivos de código fuente relevantes y localiza la causa del fallo. En la mayoría de los casos, también propone una corrección. La apruebas, la prueba se ejecuta de nuevo y pasa.
Lo que antes llevaba 30 minutos leyendo trazas de la pila, buscando la función relevante y siguiendo cadenas de llamadas, ahora se resuelve en unos pocos minutos de conversación.
Antes de abrir una pull request, usa Claude Code como revisor de primera pasada:
Review my changes in this branch compared to main. Focus on logic errors, missing error handling, and anything that would fail under edge cases.
Claude Code ejecuta git diff main, lee cada archivo modificado y genera una lista estructurada de problemas con referencias a líneas concretas. No detectará todo lo que detectaría un revisor humano, pero sí suele cazar los errores evidentes antes de que tus compañeros dediquen tiempo a ellos.
💡 Consejo para el prompt: pídele que sea crítico. Prueba con:
Assume this code will be reviewed by a senior engineer who values correctness and simplicity. Be specific about what is wrong and why.La calidad de la retroalimentación mejora bastante cuando el encuadre es más directivo.
Para cambios sistemáticos en toda una base de código, describe la regla y deja que Claude Code la aplique a gran escala:
We are renaming the User model to Account across the entire codebase. Update all references, including imports, variable names, type annotations, and database migration files.
Claude Code lo revisa todo, construye una lista de cambios, muestra el alcance de lo que va a modificar, espera tu confirmación y luego ejecuta. Un renombrado que en tu editor llevaría 40 minutos de buscar y reemplazar puede terminarse en menos de cinco minutos.
Lo más importante al formular peticiones de refactorización es ser específico con el alcance y la regla aplicada. Cuanto más precisamente describas qué cambia y qué se mantiene igual, con más exactitud y coherencia la aplicará Claude Code en miles de líneas.
Claude Code busca un archivo CLAUDE.md en la raíz de tu proyecto al inicio de cada sesión. Aquí guardas las instrucciones específicas del proyecto que deben aplicarse a cada interacción:
# MyProject
## Architecture
- Backend: Express.js with TypeScript
- Database: PostgreSQL via Prisma ORM
- Tests: Vitest, not Jest
## Conventions
- Use named exports, never default exports
- Error handling follows a Result type pattern, not try/catch
- All database calls go through the service layer, never directly in route handlers
Con un CLAUDE.md en su lugar, no tienes que volver a explicar las convenciones de tu proyecto al principio de cada sesión. Claude Code lee el archivo automáticamente y aplica esas reglas a cada archivo que escribe o edita durante esa sesión.
Es una de las inversiones con mayor rendimiento que puedes hacer al trabajar con Claude Code en un proyecto real. Veinte líneas de contexto del proyecto, escritas una sola vez, mejoran la calidad de cada sesión posterior. Los usuarios experimentados de Claude Code mantienen sus archivos CLAUDE.md igual que mantienen su README.md: los actualizan cada vez que cambian las convenciones y los tratan como un documento vivo.
Claude Code funciona con los modelos Claude de Anthropic, la misma arquitectura de IA creada para el razonamiento complejo, el análisis de contexto largo y la generación precisa de código. Si quieres redactar y probar prompts en el navegador, comparar las respuestas de los modelos antes de decidir un enfoque o simplemente ejecutar una tarea rápida sin abrir una sesión de terminal, PicassoIA te da acceso directo a toda la familia Claude sin necesidad de configurar nada.
Claude Opus 4.7 es la opción más capaz para el razonamiento intensivo, la planificación de arquitectura y las tareas complejas de varios pasos. Claude 4.5 Sonnet es el modelo de referencia para la programación y la escritura del día a día, con un excelente equilibrio entre velocidad y precisión. Para respuestas rápidas y tareas más ligeras, Claude 4.5 Haiku es la opción más rápida de la familia Claude.
PicassoIA también reúne en un solo lugar la gama completa de modelos de IA de vanguardia. GPT-5 para las capacidades más recientes de razonamiento y generación de OpenAI. DeepSeek R1 para el rendimiento de los modelos de pesos abiertos. Gemini 2.5 Flash para tareas multimodales rápidas. Todo ello accesible desde una única interfaz, sin configuración de API por tu parte.
Si ya usas Claude Code a diario en tu terminal, dedica quince minutos a PicassoIA. Redacta tus prompts en el navegador, prueba cómo responden distintos modelos a la misma petición y traslada a tus sesiones de terminal lo que funcione. Las dos herramientas se complementan: una para cuando estás inmerso en una sesión de programación con archivos abiertos, y otra para cuando quieres pensar un enfoque antes de comprometerte con él.
Elige tu idioma
