Claude Code sin saber programarinstálalo, conéctalo a tu negocio y hazle tu primera tarea real en 30 minutos

01 el punto de partida

Dos programas, una frase cada uno

La razón de usar los dos juntos y no la terminal: en VS Code ves la carpeta a la izquierda, el chat a la derecha, y cada archivo que Claude propone cambiar aparece con los cambios marcados en color y un botón para aceptar o rechazar. En la terminal ves lo mismo, pero en texto plano y sin botones. Para alguien que empieza, la extensión quita el noventa por ciento del miedo.

02 antes de instalar nada

Chat, Cowork o Claude Code: cuál toca para qué

Con una sola cuenta de Claude tienes tres maneras distintas de trabajar, y la mitad de las frustraciones del primer mes vienen de usar la equivocada. No compiten: cada una resuelve un tipo de tarea, y con el tiempo vas a combinarlas.

03 paso 1 · 10 minutos

Instalar VS Code y la extensión

Instalar VS Code

1. Entra a code.visualstudio.com/download y baja el instalador de tu sistema. Es gratis y no pide cuenta.
2. Mac: abre el archivo .dmg que bajaste y arrastra 'Visual Studio Code' a la carpeta Aplicaciones. Ábrelo desde Aplicaciones o con Spotlight (lupa arriba a la derecha).
3. Windows: ejecuta el archivo .exe y dale Siguiente a todo. Al terminar, abre VS Code desde el menú Inicio.
4. La primera pantalla es una bienvenida con opciones de tema y colores. Ciérrala o ignórala; nada de eso importa para esta guía.

Instalar la extensión de Claude Code

1. Con VS Code abierto, presiona Cmd+Shift+X (Mac) o Ctrl+Shift+X (Windows). Se abre a la izquierda la vista de Extensiones, que es la tienda de complementos de VS Code.
2. En el buscador de arriba escribe 'Claude Code'. La extensión correcta es la de Anthropic (el publicador aparece debajo del nombre). Dale al botón azul Install.
3. Si al terminar no aparece nada nuevo, cierra y vuelve a abrir VS Code. Es normal la primera vez.
4. Busca el ícono de Claude Code (una chispa, parecida a un asterisco) en la barra vertical de la izquierda. Haz clic: se abre el panel de Claude.

Iniciar sesión

1. La primera vez el panel te muestra una pantalla con un botón Sign in. Haz clic; se abre tu navegador con la página de Claude.
2. Entra con la misma cuenta que usas en claude.ai. Necesitas un plan de paga: Pro, Max, Team o Enterprise. El plan gratuito no incluye Claude Code. No necesitas ninguna 'API key' ni nada parecido.
3. Autoriza y regresa a VS Code. El panel ahora muestra una caja de texto abajo para escribirle a Claude y una lista corta llamada Learn Claude Code. Puedes cerrarla con la X.

04 si no quieres VS Code

Otras puertas al mismo agente

Claude Code es uno solo; lo que cambia es desde dónde le hablas. Esta guía usa la extensión de VS Code porque es la que más se parece a un programa normal, pero conviene que sepas que existen otras tres puertas, por si alguien te recomienda una o por si un día la necesitas.

05 paso 2 · 3 minutos

Abrir una carpeta del negocio como proyecto

Para Claude Code, un proyecto es simplemente una carpeta. Todo lo que está adentro lo puede leer sin preguntarte; lo que está afuera, no lo ve. Por eso el primer día conviene empezar con una carpeta de prueba, no con la raíz de Documentos.

1. Crea una carpeta nueva en tu escritorio, por ejemplo 'Prueba Claude', y copia adentro una carpeta real que quieras ordenar: unos 20 contratos en PDF, o una carpeta de fotos y documentos mezclados, o un archivo de texto con tus preguntas frecuentes. Copia, no muevas: si algo sale mal, los originales siguen donde estaban.
2. En VS Code, menú File (Archivo) → Open Folder (Abrir carpeta), elige 'Prueba Claude' y acepta.
3. VS Code te pregunta si confías en los autores de esta carpeta (Do you trust the authors). Es tu propia carpeta: dale 'Yes, I trust the authors'.
4. A la izquierda aparece el explorador con tus archivos. Haz clic en uno para verlo. Ese es el ícono que más vas a usar: el primero de la barra vertical, dos hojas de papel.
5. Abre el panel de Claude (la chispa). La primera vez que Claude trabaje en una carpeta nueva también puede pedirte confianza sobre ella, con una lista de lo que va a activar. Acepta.

Prueba que todo funciona con una pregunta que no toca nada. Escribe en la caja de Claude: '¿Qué hay en esta carpeta? Descríbeme los archivos en tres frases'. Si te responde con lo que realmente hay, ya estás.

06 paso 3 · la parte importante

Cómo pedirle las cosas: tarea, resultado, límites

Lo que más falla el primer día no es la instalación, es la instrucción. Un agente hace lo que le pides, no lo que querías. La fórmula que uso en cada petición tiene tres partes: una sola tarea, el resultado esperado con nombre y formato, y qué no debe tocar. Si le das las tres, el resultado sale a la primera el ochenta por ciento de las veces; si le das solo la primera, casi nunca.

git clone https://github.com/davidiriza-lab/primer-dia-claude-code.git

Tarea 1: ordenar y renombrar una carpeta

Tarea: ordena la carpeta @Documentos-2025/ que hoy tiene todo mezclado.

Resultado esperado:
- Crea subcarpetas por tipo: Facturas, Contratos, Cotizaciones, Fotos, Otros.
- Mueve cada archivo a su subcarpeta.
- Renombra cada archivo con el formato AAAA-MM-DD_tipo_descripcion-corta (ejemplo: 2025-03-14_factura_proveedor-luz.pdf). La fecha sácala del contenido del documento; si no la encuentras, usa la fecha del archivo y márcalo agregando _sinfecha al final.
- Al terminar, crea un archivo CAMBIOS.md con una tabla: nombre original, nombre nuevo, carpeta destino.

Qué no tocar:
- No borres nada. Si dudas de a dónde va un archivo, ponlo en Otros.
- No abras ni modifiques el contenido de ningún archivo; solo nombre y ubicación.
- Antes de mover nada, muéstrame la tabla completa de cambios propuestos y espera mi OK.

La última línea es la que te salva. Al pedirle que muestre la tabla y espere, conviertes una tarea de cien movimientos en una sola decisión tuya: apruebas la tabla o la corriges. Y CAMBIOS.md es tu registro para deshacer cualquier cosa después.

Tarea 2: leer 20 contratos y hacer una tabla

Tarea: lee todos los PDF de la carpeta @Contratos/ (son unos 20) y extrae de cada uno los datos clave.

Resultado esperado:
- Un archivo resumen-contratos.csv con una fila por contrato y estas columnas exactas: archivo, cliente, fecha de inicio, fecha de fin, monto total, moneda, forma de pago, penalización por cancelación, renovación automática (sí/no).
- Si un dato no aparece en el contrato, escribe "no especificado", no lo inventes.
- Además, un archivo alertas.md con la lista de contratos que vencen en los próximos 90 días contando desde hoy, y los que tienen renovación automática.

Qué no tocar:
- No modifiques ni muevas ningún PDF.
- Si un PDF no se puede leer (escaneado sin texto), no lo adivines: agrégalo a alertas.md bajo el título "No pude leer".

Dos detalles que aprendí a la mala. 'No lo inventes' hay que decirlo: sin esa línea, un campo vacío se rellena con lo que parece razonable, y en un contrato eso es un problema. Y el archivo CSV se abre directo en Excel o Google Sheets; pídelo así en vez de pedir 'una tabla' y ahorras el paso de copiar y pegar.

Tarea 3: redactar respuestas a correos desde tus preguntas frecuentes

Contexto: el archivo @preguntas-frecuentes.md tiene las respuestas oficiales de mi negocio. La carpeta @correos-pendientes/ tiene correos de clientes guardados como texto, uno por archivo.

Tarea: redacta una respuesta para cada correo de la carpeta.

Resultado esperado:
- Por cada correo, crea un archivo con el mismo nombre en la carpeta respuestas/ (créala si no existe).
- Usa SOLO la información de preguntas-frecuentes.md. Si el cliente pregunta algo que no está ahí, escribe la respuesta hasta donde alcance y agrega al final, entre corchetes, [PENDIENTE: falta dato sobre X] para que yo lo complete.
- Tono: cercano y directo, de tú, sin frases de relleno como "esperamos que este correo te encuentre bien". Máximo 120 palabras por respuesta.
- Firma siempre con "Equipo de [nombre del negocio]".

Qué no tocar:
- No modifiques los correos originales ni el archivo de preguntas frecuentes.
- No envíes nada: solo redacta los borradores. Yo los reviso y los mando.

07 paso 4 · la red de seguridad

Qué te pregunta antes de hacer algo y qué responder

Claude Code separa lo que puede hacer en dos niveles. Leer archivos dentro de la carpeta abierta no pide permiso nunca. Crear, modificar, mover o borrar archivos, y ejecutar comandos en tu computadora, sí lo piden, según el modo en el que estés. El modo aparece como una etiqueta pequeña en la parte de abajo de la caja de texto, y haciendo clic ahí lo cambias.

Mi recomendación para el primer día: antes de pedir la primera tarea, haz clic en la etiqueta de modo y ponlo en Manual. Sí, vas a aprobar más veces. Eso es exactamente lo que quieres mientras aprendes qué hace.

Lo que ves cuando pide permiso

• Un cambio a un archivo: se abre una vista con el archivo original a un lado y el propuesto al otro, con lo nuevo marcado en color. Abajo, un botón para aceptar, uno para rechazar, y la opción de escribirle qué hacer en su lugar. Puedes incluso editar la propuesta antes de aceptarla.
• Un comando (por ejemplo, mover 40 archivos de golpe): una tarjeta con el comando exacto y tres opciones: Yes (solo esta vez), Yes and don't ask again (para este comando en esta carpeta, se guarda para siempre) y No.
• Si estás en otra pestaña de VS Code, un punto azul sobre la chispa te avisa que hay un permiso esperando; naranja significa que terminó mientras no mirabas.

08 paso 4b · el botón de pánico

Si se equivocó: deshacer con checkpoints

Cada vez que le mandas un mensaje, Claude Code guarda una foto de los archivos que ha editado en esa conversación. A eso le llama checkpoint. Si el resultado no te gustó, no hay que pedirle que 'lo regrese como estaba' y cruzar los dedos: regresas tú a la foto anterior.

Regresar a un punto anterior en VS Code

1. En el panel de Claude, pasa el mouse sobre el mensaje tuyo al que quieres volver. Aparece un botón de rebobinar (una flecha circular).
2. Elige 'Rewind code to here' para regresar los archivos a como estaban en ese punto y seguir en la misma conversación, o 'Fork conversation and rewind code' para regresar los archivos y empezar una rama nueva desde ahí.
3. Revisa en el explorador de la izquierda que los archivos quedaron como esperabas antes de pedir nada más.

09 paso 5 · 5 minutos

Un CLAUDE.md mínimo para tu negocio

CLAUDE.md es un archivo de texto que Claude lee al inicio de cada conversación en esa carpeta. Es donde escribes lo que no quieres repetir: quién eres, cómo escribes, qué no debe tocar. Sin él, cada conversación empieza de cero y a la tercera vez que le explicas tu tono te preguntas para qué sirve esto. Con él, lo explicas una vez.

Crearlo desde VS Code, sin terminal

1. En el explorador de la izquierda, haz clic derecho sobre un espacio vacío debajo de tus archivos (no sobre una subcarpeta) y elige New File (Nuevo archivo).
2. Escribe el nombre exacto: CLAUDE.md, con mayúsculas y punto md. Enter.
3. Se abre vacío a la derecha. Pega el contenido de abajo, cámbialo con tus datos y guarda con Cmd+S (Mac) o Ctrl+S (Windows).
4. Abre una conversación nueva de Claude (botón de más arriba del panel) y pregúntale: '¿Qué sabes de mi negocio?'. Si te responde con lo que escribiste, el archivo se está cargando.

# Instrucciones para Claude — [Nombre del negocio]

## Quién soy
- Soy [tu nombre], dueño de [Nombre del negocio], un [tipo de negocio: despacho contable / clínica dental / agencia de viajes] en [ciudad].
- Mis clientes son [quiénes: pequeñas empresas / familias / empresas de construcción].
- No programo. Explícame cada cosa técnica en una frase antes de usarla.

## Cómo escribo
- Español de México, de tú, directo. Sin frases de relleno ("esperamos que este correo te encuentre bien").
- Nunca uses emojis en documentos ni correos.
- Firma de correos: "Equipo de [Nombre del negocio]".
- Las cifras de dinero siempre con moneda: $12,500 MXN.

## Cómo trabajar conmigo
- Una tarea a la vez. Antes de mover, renombrar o borrar más de 5 archivos, muéstrame la lista completa y espera mi OK.
- Nunca borres archivos. Si algo sobra, muévelo a la carpeta _Revisar/.
- Si un dato no está en los documentos, escribe "no especificado". No inventes.
- Tablas siempre como archivo .csv para abrirlas en Excel.
- Al terminar cualquier tarea que cambie archivos, deja un CAMBIOS.md con qué se hizo.

## Qué NO tocar
- La carpeta Originales/ es solo lectura: nunca modifiques ni muevas nada ahí.
- No abras ni leas la carpeta Privado/.
- No envíes correos, mensajes ni nada hacia afuera. Todo queda en borrador para que yo lo revise.

## Dónde están las cosas
- Preguntas frecuentes oficiales: preguntas-frecuentes.md
- Plantillas de cotización: Plantillas/
- Contratos vigentes: Contratos/2025/

Tres decisiones detrás de este archivo. Primero, la línea 'no programo' cambia cómo te habla en toda la conversación; vale más que cualquier otra. Segundo, 'nunca borres, mueve a _Revisar/' convierte el peor error posible en uno reversible. Tercero, es corto a propósito: las instrucciones se siguen mejor cuando son concretas y caben en una pantalla. Cuando Claude cometa el mismo error dos veces, agregas una línea. Así crece.

10 lo que le pasa a todos

Errores típicos del primer día

Y el más común de todos: esperar que adivine. Claude Code no sabe qué es importante para ti hasta que lo escribes, en el mensaje o en CLAUDE.md. Cuando algo salga distinto a lo que querías, la pregunta útil no es 'por qué hizo eso' sino 'qué línea me faltó'.

11 honestidad

Cuándo todavía no te conviene

No todo el mundo debería instalar esto hoy. Cuatro casos en los que te recomiendo esperar o usar otra cosa, y después seguimos.

12 después del primer día

Qué sigue

Con las tres tareas hechas ya tienes el ciclo completo: carpeta abierta, instrucción con sus tres partes, permisos revisados, resultado como archivo. Lo que viene son hábitos que hacen que el segundo mes sea mejor que el primero.

• Crea una carpeta por área del negocio (Clientes, Administración, Marketing), cada una con su CLAUDE.md. Abres la que toca y Claude ya sabe en qué contexto está.
• Cuando te descubras pegando la misma instrucción por tercera vez, conviértela en un comando propio: un archivo que se dispara escribiendo una barra y su nombre. Está en la guía de comandos propios.
• Cuando un proyecto dure más de un día, instala el sistema de inicio y cierre de sesión: un archivo de estado y dos comandos que te dejan retomar cualquier carpeta con un mensaje.
• Prueba el comando /usage desde la caja de texto: muestra cuánto de tu plan llevas usado en la sesión y en la semana, con cuánto falta para que se reinicie.
• Escribe /init en una carpeta nueva y Claude propone un CLAUDE.md a partir de lo que encuentra. Sirve como borrador; el que vale es el que corriges tú.
• Cuando una tarea tenga un final claro ('que no quede ningún PDF sin fila en el CSV'), prueba /goal con esa condición: Claude sigue trabajando por turnos hasta cumplirla y no se detiene a medias. Y /loop repite una instrucción cada cierto tiempo mientras la sesión esté abierta (por ejemplo, revisar cada 10 minutos si llegaron correos nuevos a la carpeta).
• Las 'skills' que vas a ver recomendadas por ahí son carpetas con instrucciones que le enseñan a Claude una rutina (por ejemplo, quitarle el tono de máquina a un texto). Se instalan copiando una carpeta; puedes pedirle a Claude mismo que lo haga. Antes de instalar una, lee su archivo SKILL.md: es texto, y ahí dice exactamente qué hará.