Instalar Claude Code y hacer la primera ejecución: preguntar antes de cambiar código
Comprobamos el comando de instalación de Claude Code y las condiciones de cuenta según el sistema operativo, y comenzamos la primera sesión en una carpeta ficticia de práctica. En lugar de generar código de inmediato, hacemos solo tres preguntas para leer la carpeta y el CSV en modo plan y después cerramos la sesión de forma segura.
Contenido revisado 2026.09.22Instrucciones para copiar
Ver el índice
Para quién esUsuarios de Windows, macOS, Linux o WSL que instalan Claude Code por primera vez y quieren practicar primero la lectura y las preguntas antes de modificar archivos
Preparación
Poder abrir una terminal o PowerShell
Preparar una cuenta compatible o un método de pago que pueda usarse con Claude Code
Usar el expenses.csv ficticio en lugar de datos personales reales
Los usuarios de Windows nativo deben revisar la recomendación de instalar Git for Windows
01Comprobar la cuenta y el alcance de práctica antes de instalar
Claude Code no debe explicarse suponiendo que su uso es gratuito. La documentación oficial utilizada para este artículo presenta como vías de cuenta una suscripción Claude Pro, Max, Team o Enterprise, créditos prepagados de API en Claude Console o un proveedor de nube compatible. Antes de instalar, hay que comprobar en la documentación oficial y en la pantalla real de la cuenta cuál de estas opciones corresponde. Este artículo no inventa precios ni números de versión concretos.
Preparación
Qué comprobar
Elección en este artículo
Cuenta
La vía correspondiente entre suscripción Claude compatible, Console o proveedor de nube
No se supone que sea gratuito
Carpeta de práctica
Separada de la carpeta de trabajo real
Usar vibe-expenses
Datos
Archivo ficticio sin datos personales
Usar expenses.csv
Permisos
Al principio, priorizar lectura y planificación sobre modificación
Se recomienda el modo plan
En Windows nativo se recomienda instalar Git for Windows. Si no está instalado, Claude Code puede usar PowerShell como herramienta de shell. El uso de Git se verá en el artículo 6, así que aquí nos centramos solo en el entorno de instalación y la primera sesión.
02Usar el comando oficial de instalación correspondiente al sistema operativo
El comando de instalación nativa recomendado depende del sistema operativo. Antes de copiar los comandos siguientes, comprueba qué shell y sistema operativo utilizas. La documentación oficial indica que la instalación nativa usa actualizaciones automáticas en segundo plano, mientras que las instalaciones con Homebrew y WinGet no se actualizan automáticamente.
Conviene usar los comandos de instalación tal como aparecen en la documentación oficial y no mezclarlos con scripts modificados arbitrariamente encontrados en Internet. Antes de ejecutarlos, vuelve a comprobar en la documentación oficial si han cambiado los requisitos actuales o los entornos compatibles de cada método de instalación.
03Comprobar la versión sin fijar un número concreto como valor esperado
Al terminar la instalación, abre una terminal nueva y comprueba con `claude --version`. Según la documentación oficial, se muestran el número de versión y «(Claude Code)». Como el número de versión puede cambiar con el tiempo, este artículo no fija una cifra concreta.
Instrucción
claude --version
Si aparece un mensaje indicando que no se encuentra el comando, en lugar de adivinar una ruta conviene revisar otra vez el paso de instalación y la guía de resolución de problemas de la documentación oficial. Como este texto no ejecutó realmente Claude Code, no afirma haber reproducido una pantalla concreta de error o de éxito.
04Crear una carpeta de práctica separada en lugar de usar un proyecto real
Es más seguro no hacer la primera ejecución directamente en una carpeta de investigación o en un repositorio de trabajo, sino crear una carpeta de práctica vacía. Aquí usamos solo una carpeta llamada vibe-expenses y el expenses.csv ficticio. Después de crear la carpeta, guarda el contenido CSV definido en el artículo anterior.
Guarda el archivo en UTF-8. En este paso no creamos summarize.py. El objetivo de la primera sesión no es «hacer que la IA programe de inmediato», sino practicar cómo leer y explicar la carpeta actual antes de que el usuario decida qué cambiar.
05Empezar en modo plan e iniciar sesión por primera vez
Claude Code puede iniciarse con `claude` dentro de la carpeta del proyecto y, en la primera ejecución, puede abrir el inicio de sesión en el navegador. Para un principiante, sin embargo, recomendamos empezar en modo plan en lugar de comenzar directamente con un flujo que permita modificar archivos. El modo plan es un modo de permisos orientado a lectura para revisar análisis y planes, y desde la línea de comandos puede iniciarse así.
Instrucción
claude --permission-mode plan
En la primera ejecución puede aparecer el proceso de inicio de sesión en el navegador. Si necesitas cambiar de cuenta, puedes usar `/login` dentro de la sesión. El modo de permisos predeterminado puede variar según la cuenta y el entorno, por lo que este artículo no afirma que «siempre sea Manual». Según la documentación oficial consultada el 2026-09-22, el modo inicial predeterminado de la terminal interactiva para los planes Pro, Max y Team es auto, mientras que para otros planes es Manual.
Ejemplo editorial
[Ejemplo editorial · no es una respuesta real]
En la primera ejecución pueden aparecer indicaciones sobre el inicio de sesión en el navegador o los permisos. El texto y el orden reales de la pantalla pueden variar según el momento de instalación y la cuenta, así que compruébalos con la pantalla actual y la documentación oficial.
06Hacer tres preguntas de solo lectura antes de cambiar archivos
Cuando comience la sesión, no pidas de inmediato «créame el programa». Primero comprueba hasta qué punto entiende correctamente la carpeta actual. Claude Code puede leer por sí mismo los archivos que necesite y puede solicitar aprobación antes de modificar archivos o ejecutar comandos. En esta práctica no pedimos ninguna modificación; solo hacemos preguntas.
Instrucción
Indícame qué archivos hay en esta carpeta. No modifiques ningún archivo.
Explica los nombres de las columnas de expenses.csv y qué parece significar cada una. No modifiques ningún archivo.
Si fueras a crear una herramienta para calcular el total mensual de amount con este CSV, resume en tres puntos qué habría que comprobar antes de implementarla. Todavía no escribas código.
En la respuesta, comprueba como mínimo que no se haya interpretado mal el nombre del archivo actual ni las columnas del CSV. Si la IA menciona un archivo que no existe o propone una modificación o instalación no solicitada, pregunta primero por el motivo. Como las frases concretas de Claude Code pueden cambiar según el modelo y el momento, aquí no inventamos un diálogo correcto y lo presentamos como si fuera una salida real.
Pregunta
Punto principal que debe comprobar la persona
Si hay un problema
Qué hay en la carpeta
Si reconoce expenses.csv como archivo real
Si menciona un archivo inexistente, volver a pedir la base de la lista
Cuáles son las columnas del CSV
Si lee exactamente date, category, amount
Si adivina nombres de columnas, compararlos con el original
Qué comprobar antes de implementar
Si revisa primero entrada, salida y restricciones
Si intenta modificar de inmediato, pedir solo un plan
07Cerrar la sesión y pasar al siguiente artículo
Una vez alcanzado el objetivo de la primera sesión, ciérrala sin haber creado código. Dentro de la sesión se puede usar `/exit`, y también se puede salir pulsando Ctrl+D dos veces. `/help` muestra la lista de comandos; existen además comandos como `/clear`, `/resume`, `/compact` y `/rewind`, pero aquí solo comprobamos sus nombres sin ampliar la práctica.
Instrucción
/exit
Se comprobó la instalación con claude --version.
Se usó la carpeta de práctica vibe-expenses, no una carpeta real de trabajo.
expenses.csv contiene únicamente datos ficticios.
Se hicieron tres preguntas en modo plan sin modificar archivos.
La generación real de código se dejó para el siguiente artículo.
En el siguiente artículo usaremos los requisitos y esta carpeta de práctica para crear realmente summarize.py. Entonces incluiremos en una sola solicitud el ejemplo de entrada, la salida esperada y la restricción de usar solo la biblioteca estándar, y ejecutaremos por separado el código Python generado para verificar el resultado.
Qué comprobar por tu cuenta
Redactado con base en la documentación oficial de Claude Code (consultada el 2026-09-22) · Claude Code no se ejecutó realmente · No hay código Python para ejecutar
Comprobar que los comandos de instalación nativa para macOS·Linux·WSL, Windows PowerShell y Windows CMD coincidan con la documentación oficial
Comparar con la documentación oficial los comandos alternativos de instalación con Homebrew y WinGet y la diferencia de actualización automática
Comprobar que la notación de claude --version, claude --permission-mode plan, /login y /exit coincida con la documentación oficial
Comprobar que no se afirme que el uso es gratuito y que solo se indiquen las vías de cuenta compatibles
Comprobar que el ejemplo editorial correspondiente a la pantalla o respuesta de Claude Code empiece por '[Ejemplo editorial · no es una respuesta real]'
Comprobar que, al no incluir código Python para ejecutar, no se afirme por error haber verificado resultados de Python
Límites de la verificación
Durante la redacción de este artículo no se instaló ni ejecutó Claude Code. Los comandos de instalación y las descripciones de funciones siguen la documentación oficial de Claude Code consultada el 2026-09-22; al instalarlo realmente, hay que volver a comprobar en la documentación oficial los entornos compatibles, las condiciones de cuenta y el texto de pantalla vigentes.
Entendemos el vibe coding no como «decírselo con palabras y dejar que la IA lo haga todo», sino como una forma de trabajo en la que la persona define los requisitos y los criterios de comprobación y después revisa el resultado generado por la IA. Con una herramienta ficticia para sumar un CSV de gastos domésticos, organizamos en una sola nota la entrada, la salida, lo que no debe hacerse y cómo verificar el resultado.
Practicamos el flujo para crear una primera herramienta pequeña en Python usando el expenses.csv ficticio y la nota de requisitos preparados antes. La solicitud incluye un ejemplo de entrada, la salida esperada y las restricciones, y después ejecutamos el summarize.py terminado en la herramienta Python del chat de GPT, no en Claude Code, para comprobar el resultado.
Organizamos de forma breve en el CLAUDE.md del proyecto el comando de ejecución, las reglas de datos, las prohibiciones y la forma de comprobar resultados que antes se repetían en cada solicitud. Distinguimos la función de `/init` para crear un borrador y el propósito de cada ubicación de archivo, y terminamos un archivo de reglas de 35 líneas adaptado al ejemplo del CSV de gastos.
A partir del ejemplo de añadir la opción `--by-category` a una herramienta ya funcional que suma gastos por mes, aprenderás a revisar primero el plan de cambios en el modo plan de Claude Code. Antes de implementar, fijarás el alcance de la modificación y el formato de salida; después de aprobar el plan, ejecutarás el código final para comprobar tanto los totales mensuales existentes como los totales por categoría.
Aprenderás un flujo mínimo para dejar un punto de referencia con git antes de que Claude Code modifique archivos y, después del trabajo, revisar los cambios reales con `git status` y `git diff`. Puedes pedir a la IA que explique el diff, pero el proceso se basa en que una persona compruebe el diff y los resultados de ejecución antes de hacer staging y commit directamente.
En lugar de limitarte a decirle a la IA que «da error», practicarás un flujo en el que primero reproduces el problema con la misma entrada, acotas la causa a partir del mensaje de excepción real y solicitas solo el cambio mínimo. Usaremos un CSV cuyo amount contiene una coma para reproducir un ValueError en Python y volveremos a ejecutar el código corregido para comprobar el resultado.
Partiendo de que Claude Code puede leer y modificar archivos y ejecutar comandos, este artículo reúne las comprobaciones de seguridad que una persona principiante debe hacer antes, durante y después del trabajo. Conecta en una sola lista las diferencias entre modos de permiso, los cambios que los checkpoints no pueden restaurar, la diferencia de función respecto de git y la regla de no introducir información secreta.