Claude Code: Operaciones Básicas

Aprender a programar con asistencia de IA puede resultar abrumador al principio. Claude Code funciona como un colega experto: usted describe lo que necesita en lenguaje natural y Claude le ayuda a lograrlo. Este tutorial enseña las operaciones esenciales para el uso diario, desde iniciar conversaciones hasta gestionar su espacio de trabajo.

Conceptos Clave

Workspace - Espacio de trabajo: la carpeta desde donde inicia Claude Code; Claude lee y edita los archivos que contiene durante esa sesión
REPL (Read-Eval-Print Loop) - Sesión interactiva donde escribe comandos, Claude responde y la conversación continúa hasta que cierra la sesión
Contexto - Cantidad de código e historial que Claude recuerda; funciona como memoria de trabajo que se llena con el tiempo
Slash Commands - Comandos especiales que comienzan con / para realizar acciones específicas como limpiar el historial o mostrar ayuda

Lo Que Necesitará

Claude Code instalado desde el tutorial de Windows o Mac
Familiaridad básica con el uso de una terminal o símbolo del sistema
15-20 minutos

Paso 1: Abra Su Terminal

Windows: Presione la tecla Windows, escriba PowerShell, y presione Enter para abrir PowerShell
Mac: Presione Cmd+Space, escriba Terminal, y presione Enter

Nota: Si en el tutorial de instalación de Windows configuró la ruta opcional de WSL/Ubuntu en lugar de la instalación nativa, abra la aplicación Ubuntu y use rutas de estilo Linux (por ejemplo, /mnt/c/Users/SuNombre/...) en los pasos siguientes.

Se abrirá una ventana de texto donde puede escribir comandos.

Paso 2: Obtener los Archivos del Proyecto de Demostración

Usaremos un proyecto real de ciencia de datos para explorar las funcionalidades de Claude Code. Puede clonarlo con Git o descargarlo directamente.

Opción A: Clonar con Git (si tiene Git instalado):

git clone https://github.com/gexijin/data_projects
cd data_projects

Opción B: Descargar sin Git:

Visite https://github.com/gexijin/data_projects en su navegador web
Haga clic en el botón verde Code cerca de la parte superior derecha
Haga clic en Download ZIP
Extraiga el archivo ZIP en su carpeta Descargas. GitHub nombra la carpeta extraída data_projects-main: cámbiele el nombre a data_projects para que coincida con el resto de este tutorial. En Windows, Extraer todo puede crear una carpeta dentro de otra (data_projects-main → data_projects-main). Ábrala: si solo ve otra carpeta data_projects-main, mueva esa carpeta interior a Descargas y cámbiele el nombre a data_projects.
En su terminal, navegue a la carpeta extraída:
```
cd ~/Downloads/data_projects
```

Ajuste la ruta si lo extrajo en otro lugar.

Paso 3: Inicie Claude Code desde la Carpeta

En su terminal (asegúrese de estar dentro de la carpeta data_projects), escriba:

claude

Inicie sesión con su suscripción de Claude siguiendo el tutorial de instalación (Windows

Mac). Después de iniciar sesión, verá un mensaje de bienvenida y el prompt de Claude Code.

Paso 4: Hacer Preguntas Sobre Su Proyecto

Claude Code lee automáticamente sus archivos cuando es necesario. Pruebe estas preguntas para entender su proyecto:

Pregunte sobre la estructura de carpetas:

¿Cuál es la estructura de carpetas de este proyecto?

Pregunte sobre tecnologías:

¿Qué tecnologías y bibliotecas usa este proyecto?

Pregunte sobre cambios recientes:

¿Cuál fue el último cambio realizado en este proyecto?

Claude verificará el historial de Git (si está disponible) y le informará sobre los commits recientes.

Puede preguntarle a Claude cualquier cosa sobre su código en lenguaje natural. Claude lee los archivos necesarios para responder sus preguntas.

Paso 5: Slash Commands Esenciales

Escriba / para ver todos los comandos disponibles. Estos son los más importantes:

Ver todos los comandos:

Esto muestra un menú de todos los slash commands. Use las teclas de flecha para navegar, presione Enter para seleccionar, o presione Esc para cancelar.

Obtener ayuda:

/help

Muestra documentación sobre el uso de Claude Code.

Verificar el uso de contexto: Es importante gestionar el contexto, la “memoria de trabajo” de Claude.

/context

Limpiar el historial de conversación:

Cuando el contexto se llena, inicie una nueva conversación con /clear.

/clear

Elimina la conversación actual y comienza de nuevo. Úselo cuando desee cambiar de tema o cuando la conversación sea demasiado larga. Es esencial para gestionar el contexto.

Salir de Claude Code:

/exit

Finaliza su sesión y regresa al prompt normal de la terminal. También puede presionar Ctrl + C dos veces.

Paso 6: Aprobar Cambios y Usar Atajos

Las sesiones nuevas suelen comenzar en modo Auto, en el que Claude realiza ediciones y comandos rutinarios sin preguntar. Si Claude pide permiso, muestra un pequeño menú con opciones como Yes y No. Use las teclas de flecha para resaltar su elección y presione Enter. Si desea aprobar cada cambio usted mismo, presione Shift+Tab hasta que el modo debajo del prompt muestre Manual.

Algunos atajos de teclado también hacen que trabajar con Claude Code sea más rápido:

Shift+Tab - Alternar entre modos (Auto, Manual, Accept Edits, Plan); el modo actual se muestra justo debajo del prompt. El modo Plan es útil para revisar una tarea compleja antes de que Claude haga cualquier cambio
Ctrl+C - Cancelar la operación actual o la respuesta de Claude
Esc - Detener a Claude a mitad de una respuesta, o cerrar un menú
\ y luego Enter (o Ctrl+J) - Agregar una nueva línea en su mensaje sin enviarlo

Paso 7: Siempre Crear un Archivo CLAUDE.md

El archivo CLAUDE.md es el manual de instrucciones de su proyecto para Claude. Persiste entre sesiones, permitiendo que Claude recuerde el contexto importante de su proyecto.

Crear el archivo:

/init

Claude creará el archivo con un resumen de su proyecto. Este archivo permanece en la raíz de su proyecto y Claude lo lee automáticamente cada vez que inicia una nueva sesión.

Puede editar CLAUDE.md en la carpeta del proyecto en cualquier momento para agregar instrucciones específicas del proyecto, convenciones de programación o contexto importante como el propósito de los archivos.

Paso 8: Referirse a Archivos o Líneas de Código

Puede usar @ para referirse a un archivo específico:

Explica el código en @Visualization/Matplotlib/Nested_Pie_Chart.ipynb

Claude leerá el notebook y explicará qué hace, cómo funciona y qué logra el código. Esto efectivamente trae el archivo al contexto.

Si trabaja con Claude Code desde VS Code y tiene la extensión instalada, puede agregar el archivo al contexto simplemente abriéndolo. Verá Nested_Pie_Chart.ipynb en la parte inferior del cuadro del prompt de Claude Code. Así Claude sabe que está hablando de este archivo.

Además, puede seleccionar algunas líneas de código y Claude mostrará 3 lines selected. Puede pedirle a Claude que haga cambios rápidos a estas líneas o hacer preguntas sobre ellas. Por esto recomendamos usar Claude Code desde VS Code.

Paso 9: Realizar Acciones con Comandos de Terminal

Claude puede realizar acciones ejecutando comandos de terminal (Bash en Mac/Linux, Git Bash o PowerShell en Windows) de diversas formas.

Instalar software
```
Instala la biblioteca pandas
```

Iniciar control de versiones

Comienza a rastrear cambios usando Git. Mi nombre es James Bond y mi correo es bond@earth.com

Hacer commit de los cambios
```
Haz commit de estos cambios.
```

Encontrar y descargar datos

Descarga el dataset de calidad de vino de UCI. Ponlo en una nueva carpeta llamada wine.

Ejecutar código

Reescribe el código del gráfico circular anidado como un script regular de Python.
Ejecútalo y guarda el nuevo código y gráficos en la misma carpeta.

Claude instala software, soluciona errores y gestiona entornos, todo por su cuenta.

Esencialmente tiene un experto en comandos de terminal a su disposición. Mientras gestione los permisos y apruebe las acciones, puede ser muy productivo.

Próximos Pasos

Ahora que conoce lo básico, pruebe esto por su cuenta:

Pídale a Claude que explique un algoritmo de aprendizaje automático en una de las carpetas del proyecto
Solicite modificaciones a un notebook existente (como cambiar colores de gráficos o agregar nuevas características)
Cree un nuevo script de Python que use datos del proyecto
Pídale a Claude que compare dos enfoques diferentes en el código base

Solución de Problemas

Error “Command not found” - Claude Code no está instalado o no está en su PATH. Siga de nuevo el tutorial de instalación de Windows o Mac, o vuelva a ejecutar el instalador directamente: irm https://claude.ai/install.ps1 | iex (Windows PowerShell) o curl -fsSL https://claude.ai/install.sh | bash (Mac/WSL).
Claude proporciona información desactualizada - Limpie el contexto con /clear y pregunte nuevamente. Las conversaciones largas llenan la memoria de Claude.
Los cambios en archivos no funcionan - Asegúrese de tener permisos de escritura en su carpeta de proyecto. Si Claude pide aprobación, seleccione Yes en el menú que aparece.
El contexto se llena rápidamente - Use /context para verificar el uso. Cuando esté casi lleno, use /clear para iniciar una nueva conversación con contexto limpio.

Resumen del Flujo de Trabajo

Trabajar con Claude Code sigue este patrón:

Inicie Claude en su carpeta de proyecto con claude
Haga preguntas en lenguaje natural
Claude lee archivos según sea necesario y responde
Solicite cambios en el código—si Claude pide permiso, elija Yes
Use /clear al cambiar de tema o cuando el contexto se llene
Use /exit cuando termine

Creado por Steven Ge el 14 de diciembre de 2025.