Qué es (y qué no es) Claude Code
En el chat de Claude tú subes un archivo y recibes una respuesta. En Claude Code, Claude trabaja dentro de una carpeta de tu computador: puede leer los archivos, crear nuevos, moverlos, editarlos y ejecutar programas para lograr lo que le pides. Por eso es tan potente y por eso hay que usarlo con reglas.
| Chat de Claude | Claude Code | |
|---|---|---|
| Dónde trabaja | En la conversación | En una carpeta de tu computador |
| Archivos | Los que subes | Todos los de la carpeta |
| Puede cambiar cosas | No | Sí, con los permisos que le des |
| Ideal para | Pensar, redactar, resumir | Ordenar, transformar, analizar, construir |
Paso a paso
- 01
Elige cómo usarlo: app de escritorio o terminal
Recomendado si nunca usaste una terminal: descarga la app de escritorio de Claude (macOS o Windows). La documentación indica que la app incluye Claude Code, así que no necesitas instalar nada más.
Lo que ves en pantallaEn la parte superior central de la app hay tres pestañas: «Chat», «Cowork» y «Code». Pulsa «Code». Si te pide mejorar el plan, tu cuenta es gratuita y necesitas uno pago.
Si prefieres la terminal, el instalador nativo es la opción recomendada y se actualiza solo:
macOS / Linux (Terminal)curl -fsSL https://claude.ai/install.sh | bashWindows (PowerShell)irm https://claude.ai/install.ps1 | iexComprueba la instalación con
claude --version. En Windows, la documentación recomienda instalar también Git for Windows. - 02
Inicia sesión y abre una carpeta de prueba
Crea una carpeta llamada
prueba-claudeen tu escritorio y copia ahí (copia, no muevas) unos cuantos archivos de ejemplo: descargas viejas, un Excel de ventas, el logo de la empresa.En la app: en la pestaña Code elige el entorno local y selecciona esa carpeta como carpeta de trabajo.
En la terminal: entra a la carpeta y arranca Claude Code. La primera vez abre el navegador para que inicies sesión con tu cuenta de Claude.
Terminalcd ~/Desktop/prueba-claude claudeLo que ves en pantallaUna caja de texto donde escribes tus pedidos y, debajo, una línea de estado que indica el modo de permisos activo (por ejemplo,
⏸ manual mode ono⏸ plan mode on). - 03
Ajusta el modo de permisos antes del primer pedido
El modo de permisos define cuánto puede hacer Claude sin preguntarte. En la terminal se cambia con Shift + Tab; en la app hay un selector con los mismos modos.
Modo Qué hace Cuándo usarlo Manual Pide permiso antes de editar archivos o ejecutar comandos Tus primeras semanas Plan Analiza, propone un plan y no cambia nada hasta que lo apruebes Tareas grandes o delicadas Accept edits Edita archivos sin preguntar en cada uno Cuando ya confías en la tarea Auto Avanza sin pedirte aprobación en cada paso Con experiencia y en carpetas de prueba Revisa en qué modo arrancasEn versiones recientes, Claude Code arranca en modo automático en la terminal. Si estás empezando, pasa a modo manual o plan con Shift + Tab y verifica el modo en la línea de estado.
- 04
Primer pedido: organizar una carpeta
Pedido · ordenar archivosRevisa los archivos de esta carpeta y propón una organización en subcarpetas por año y tipo (facturas, cotizaciones, imágenes, otros). No borres nada. Antes de mover, muéstrame el plan. Al terminar, crea un archivo movimientos.csv con el nombre original y la nueva ubicación de cada archivo.
Lo que ves en pantallaClaude lista lo que encontró, propone la estructura y, en modo manual o plan, se detiene a pedir tu aprobación antes de crear carpetas y mover archivos. Al final ves las carpetas nuevas en tu explorador de archivos y el archivo movimientos.csv.
El archivo de registro es tu red de seguridad: si algo quedó en un lugar raro, sabes de dónde salió.
- 05
Segundo pedido: analizar un Excel de ventas
Pedido · análisis de ExcelAbre ventas_2026.xlsx. Primero dime qué columnas tiene y si ves datos raros (vacíos, duplicados, fechas mal escritas). Después calcula ventas por mes, por producto y por vendedor, haz un gráfico de barras por mes en un archivo PNG y escribe en resumen.md las cinco conclusiones más importantes para la gerencia. No modifiques el archivo original.
Para leer el Excel, Claude suele escribir y ejecutar un pequeño programa. Es posible que te pida permiso para instalar una librería; en modo manual verás exactamente qué comando quiere ejecutar.
Cómo verificar el resultado
- Compara un total (por ejemplo, el de un mes) con lo que te da una tabla dinámica en Excel.
- Pregunta «¿cómo calculaste X?» y pide que te muestre las filas que usó.
- Si el archivo tiene varias hojas, dile cuál usar.
- 06
Tercer pedido: crear una página sencilla
Pedido · página webCrea una página web de una sola hoja en un archivo index.html para mi empresa, Café La Montaña, que vende café de origen de Huila a tiendas y oficinas en Medellín. Secciones: qué hacemos, tres productos con precio, cómo pedir y un botón de WhatsApp al 300 000 0000. Usa logo.png de esta carpeta. Que se vea bien en celular. Todo en un solo archivo, sin dependencias externas.
Abre
index.htmlcon doble clic. Después pide cambios concretos: «el título más grande», «cambia el verde por el color del logo», «agrega una sección de preguntas frecuentes».Esto es un borradorSirve para validar una idea o mostrarle algo a tu equipo. Publicar un sitio de verdad (dominio, hosting, formularios, datos de clientes) requiere revisión técnica.
- 07
Aprende a deshacer y a dejar instrucciones fijas
Deshacer: escribe
/rewindo presiona Esc dos veces con la caja de texto vacía. Aparece un menú para restaurar el código y la conversación, solo la conversación o solo los archivos a un punto anterior.Límite importanteSegún la documentación, los puntos de control no registran los archivos modificados por comandos (por ejemplo, cuando Claude mueve archivos ejecutando un comando del sistema). Por eso los primeros pedidos se hacen sobre copias.
Instrucciones fijas:
/initcrea un archivoCLAUDE.mdque Claude lee al inicio de cada sesión en esa carpeta. Ahí puedes escribir reglas como «nunca borres archivos», «responde en español» o «los informes van en la carpeta /informes». La documentación recomienda mantenerlo por debajo de 200 líneas.Comando Para qué sirve /helpVer ayuda y comandos disponibles /clearEmpezar una conversación nueva, sin contexto anterior /rewindVolver a un punto anterior /usageVer costo de la sesión y límites de uso del plan /permissionsVer y cambiar qué está permitido, qué pregunta y qué está bloqueado /exitSalir
Buenas prácticas y riesgos
Buenas prácticas
- Trabaja en carpetas de prueba con copias hasta que conozcas bien la herramienta.
- Pide primero el plan y después la ejecución. «Muéstrame qué vas a hacer» ahorra sustos.
- Un pedido, un objetivo. Si cambias de tema, usa
/clear. - Lee lo que te pide aprobar. Si no entiendes un comando, pregúntale qué hace antes de aceptarlo.
Riesgos que debes conocer
- Borrar o sobrescribir. Claude puede modificar archivos reales. Ten copias de seguridad; los puntos de control no reemplazan un respaldo.
- Inyección de instrucciones. Un documento o página web puede traer texto escondido que intenta darle órdenes a Claude. La documentación de seguridad recomienda revisar los comandos antes de aprobarlos y no pasarle contenido no confiable directamente.
- Datos sensibles. No abras Claude Code en carpetas con nómina, historias clínicas o bases de clientes sin una política clara de la empresa.
- Modos sin permisos. El modo que salta todos los permisos está pensado, según la documentación, solo para contenedores y máquinas virtuales aisladas. No lo uses en tu computador.
Errores comunes y cómo resolverlos
✕Al pulsar Code, la app me pide mejorar el plan
Claude Code no está incluido en el plan gratuito. Necesitas Pro, Max, Team o Enterprise.
✕«claude: command not found» después de instalar
Cierra y vuelve a abrir la terminal para que tome la instalación nueva. Luego ejecuta claude --version. Si sigue fallando, claude doctor diagnostica la instalación.
✕Inicié sesión con la cuenta equivocada
Dentro de la sesión escribe /login para iniciar sesión con otra cuenta.
✕Movió archivos que no quería y /rewind no los devuelve
Los movimientos hechos con comandos del sistema no quedan en los puntos de control. Usa el archivo de registro (movimientos.csv) para pedirle que los regrese, o restaura desde tu copia.
✕Pide permiso para todo y se vuelve lento
Es el modo manual funcionando. Cuando ya confíes en un tipo de tarea, cambia a «Accept edits» con Shift + Tab o define reglas permanentes con /permissions.
Preguntas frecuentes
¿Necesito saber programar para usar Claude Code?
No para tareas como ordenar archivos, analizar hojas de cálculo o crear borradores de páginas. Sí necesitas leer con atención lo que Claude te pide aprobar y trabajar sobre copias al principio.
¿Claude Code está incluido en el plan gratuito?
No. Según la documentación oficial, requiere un plan Pro, Max, Team o Enterprise, o una cuenta de la Console de Anthropic.
¿Cuál es la forma más fácil de instalarlo?
Para quien no usa la terminal, la app de escritorio de Claude: incluye Claude Code en la pestaña Code y no requiere instalar Node.js ni la versión de línea de comandos.
¿Puedo deshacer lo que hizo Claude Code?
En buena parte sí: /rewind o Esc dos veces permiten restaurar archivos y conversación a un punto anterior. Pero los cambios hechos por comandos del sistema no quedan registrados, así que conviene trabajar con copias o con control de versiones.
¿Claude Code sube mis archivos a internet?
Claude Code envía a los servidores de Anthropic el contenido que necesita leer para responder. Por eso no debes abrirlo en carpetas con información sensible sin una política de la empresa, y debes revisar el ajuste de privacidad de tu plan.
¿Puede leer archivos de Excel?
Normalmente lo hace escribiendo y ejecutando un pequeño programa que lee el archivo. Puede pedir permiso para instalar una librería. Si da problemas, exporta la hoja a CSV.
Fuentes oficiales
Revisé cada menú, comando y precio de este tutorial contra estas páginas el 19 de octubre de 2026. Los productos de IA cambian seguido: si algo no coincide con lo que ves, manda la documentación oficial.