Sesión 2 de 5 · Manos a la obra

Ecosistema Claude
+ Claude Code

Hoy sales con la herramienta funcionando en tu máquina

DARATEL TIC | 15 JUL 2026 | 3 horas
Dónde estamos

Segunda de cinco

S1
KickOff
Hecho ayer.
HOY
S2
Ecosistema + Claude Code
Instalación y primeros prompts.
S3
Portal de gestión IP
Cada uno, un módulo real.
S4
Agente multicanal
Conectado al portal.
S5
Despliegue y roadmap
A producción.
Agenda

Tres horas

Una hora de concepto y luego las manos en el teclado hasta el final. El concepto no es relleno: es lo que hace que lo demás funcione. Sin él, esto es un juguete caro.

17:30Por qué la IA te falla en redesEmpezamos con una frase que escribió uno de vosotros ayer
17:50Cómo funciona esto de verdadContexto, la ventana, y por qué se inventa cosas
18:05El ecosistema: qué uso y cuándoWeb, escritorio, terminal, Cowork, API. Qué modelo usar. Y si ya tenéis ChatGPT, ¿para qué esto?
18:23Qué es Claude CodeCLAUDE.md, MCP, y por qué esto responde a la queja de Ángel
18:35Comprobación — todos a la vezSalimos de aquí con claude --version y python --version respondiendo. Los ocho
19:05PausaY aquí rescatamos al que se haya quedado atascado
19:15Primeros pasos, permisos y secretosCómo se le habla. Y qué NO se le pega jamás
19:30Ejercicio: caza el solapamientoQuince redes de cliente. Cuatro tienen un problema. Encuéntralos
20:10Tu caso y el puente a la S3Cada uno por su ruta. Y qué construimos la próxima

«La IA, sobre todo en el contexto de redes, no está fina del todo. Recomienda cosas que no son adecuadas.»

Ángel Ramos · ayer, en la encuesta, contestando a "¿cuál es tu mayor fricción hoy?"

El problema real

Ángel tiene razón

Y en la misma respuesta añadió la mitad que falta: "en programación cada día lo hace mejor, no tengo queja". Ahí está la pista entera.

Le preguntas de redes

  • No sabe qué clientes tenéis
  • No sabe vuestro direccionamiento
  • No sabe qué FortiGate hay en cada sede
  • Contesta de redes en general

Le preguntas de código

  • El código está delante
  • Lo lee entero
  • Ve nombres, estructura y errores
  • Tiene el contexto dentro

La diferencia no es el tema. Es el contexto. No es que sepa de programación y no de redes: es que del código le dais todo y de vuestra red no le dais nada.

Cómo funciona

No consulta. Predice.

Esto es lo único de teoría que hace falta hoy, y explica el 90% de lo que os va a sorprender después.

Lo que NO es

Un buscador

No va a una base de datos a mirar la respuesta. No hay tabla que consultar. Si esperáis Google, os va a decepcionar.

Lo que SÍ es

Un predictor

Calcula qué palabra encaja mejor después de las anteriores. Millones de veces por respuesta. Nada más — y nada menos.

La consecuencia

Siempre contesta

No tiene un "no lo sé" nativo. Si no tiene con qué predecir, predice igual. Eso, visto desde fuera, se llama inventarse las cosas.

Traducido a vuestro día: si le preguntáis por una red que nunca ha visto, no os va a decir "no la conozco". Os va a dar una respuesta con toda la seguridad del mundo. La seguridad con la que contesta no mide si acierta.

Contexto

Todo lo que le des cabe en una ventana

El "contexto" es literalmente todo lo que el modelo tiene delante cuando contesta: tu pregunta, la conversación, y los ficheros que le hayas dado. Fuera de esa ventana, no existe.

Sin contexto"¿Qué máscara le pongo a la red de un cliente con 20 puestos?" → te contesta de manual. Genérico. Puede que sirva, puede que no.
→
Con contexto"Aquí está el CSV de mis 14 redes de cliente. El de Taller Ruiz tiene 22 puestos. ¿Choca con algo?" → ahora sí puede acertar, porque le has dado con qué.

En vuestro idioma: la ventana de contexto es la MTU. Hay un tamaño máximo de lo que entra de una vez. Si le metes de golpe más de lo que cabe, no te avisa con un error bonito: se pierde por el camino y tú te enteras por el resultado raro. Igual que un paquete que no cabe.

La regla de hoy: no busquéis el prompt mágico. No existe. Lo que existe es dar contexto. El 80% de la diferencia entre "esto es un juguete" y "esto me ahorra la tarde" es cuánto contexto le diste.

Dónde se rompe

Por qué se inventa cosas

Se le llama "alucinar" y suena a fallo raro. No lo es: es el comportamiento normal de un predictor al que le falta con qué predecir.

Causa

Le falta el dato

No lo tiene y no puede decir "no lo sé", así que rellena el hueco con lo que estadísticamente encajaría.

Síntoma

Suena perfecto

Lo inventado y lo cierto salen con el mismo tono. No hay señal de aviso. Es lo que lo hace peligroso.

Antídoto

Dale el dato

Un modelo con vuestro CSV delante no se inventa vuestras redes. Se las lee. La alucinación se combate con contexto, no con insistir.

Y aun así, se equivoca. Por eso ninguna de estas 5 sesiones va de "confía y pega". Firmáis vosotros. La herramienta propone, vosotros validáis. Volvemos a esto cuando lleguemos a los permisos.

PARTE 01

El ecosistema

Claude no es un sitio: son cuatro. Y usar el equivocado es la razón número uno por la que la gente dice que "no le sirve".

Ecosistema

Cuatro puertas, un motor

Detrás es el mismo modelo. Lo que cambia es qué puede tocar. Y eso lo cambia todo.

claude.ai

El chat, en el navegador

Escribes y contesta. Puedes subirle ficheros sueltos. No toca tu ordenador. Para preguntar, redactar y pensar.

Escritorio

El mismo chat, en app

Lo mismo pero sin navegador, y puede conectarse a herramientas externas. Cómodo si vives en él.

Claude Code

En tu terminal

Este es el de hoy. Ve tus ficheros, los edita, ejecuta comandos. Deja de ser un chat y pasa a ser alguien trabajando en tu carpeta.

API

Para construir

Cuando lo que quieres no es hablar con Claude, sino meterlo dentro de un programa tuyo. Aquí llegamos en la S4, con el agente.

El error más común: pegar medio manual en el chat web, pelearse una hora, y concluir que la IA no vale. Era la puerta equivocada.

Decisión

Si quieres esto → usa esto

Pegadlo en la pared. Es la chuleta que evita el 90% de la frustración.

ChatEntender algo, redactar un email, preparar una explicación para un clienteNada que tocar en tu máquina → claude.ai
CodeTrabajar con ficheros tuyos: configs, CSVs, manuales, scriptsTiene que ver y tocar cosas de tu disco → Claude Code
CodeRepetir una tarea que haces cada semanaSi es repetitiva, se automatiza → Claude Code
APIQue funcione solo, sin ti delanteUn agente que responde tickets a las 3 de la mañana → API (S4)
NingunoDecidir qué se cambia en la red de un cliente en producciónEso lo decide una persona. Siempre.
Comparativa

¿Y Cursor? ¿Y Copilot?

Prometimos comparativa honesta, así que va honesta: los tres son buenos y los tres usan modelos parecidos. No os vendemos que uno sea mágico.

GitHub Copilot

Autocompletar mientras escribes

Nació para sugerir la línea siguiente dentro del editor. Brillante si ya sabes programar y escribes código todo el día. En esta sala, eso es Ángel.

Cursor

Un editor entero con IA dentro

Muy bueno. Pero es un editor de código: te pide vivir dentro de él. Si no eres desarrollador, te obliga a aprender una herramienta de desarrollador.

Claude Code

Le pides en español, en tu terminal

No hay editor que aprender. Describes lo que quieres y lo hace. Por eso es el de esta formación: 5 de los 8 no programáis, y aquí no hace falta.

La razón real de la elección: no es que Claude Code sea "mejor". Es que los otros dos asumen que ya sabes programar. Este no. Y ese es exactamente vuestro caso.

La pregunta honesta

«Si ya tenemos ChatGPT, ¿para qué esto?»

Es la pregunta correcta y os la contesto yo antes de que la hagáis. La diferencia no es de marketing: es de arquitectura. Es dónde trabaja cada uno.

Claude Cowork

En tu escritorio

Abre la carpeta que le digas y trabaja sobre vuestros ficheros. Sin subir nada. Mismo motor que Claude Code, sin terminal.

ChatGPT Work

En la nube

Salió hace seis días. Navegador virtual: navega, rellena formularios, busca. A vuestros ficheros llega por integraciones, no directo.

Workspace Studio

Dentro de Google

La apuesta de Gemini. Potente si vivís dentro de Workspace. Si no, no os aplica.

Traducido a vuestro trabajo: configs de FortiGate, inventarios en CSV y documentación de clientes viven en vuestro disco. Ahí gana el que toca el disco. En flujos de web y portales, gana el otro. No es fanatismo: es dónde está el fichero.

Modelos

Cuál usar y cuándo

Dentro de Claude hay varios modelos. Cambian en potencia, velocidad y coste. No hace falta que os los aprendáis: hace falta saber que se cambian y cuál toca.

Por defecto

Sonnet 5

El que os viene puesto. 1M de contexto. Para el 95% de lo que vais a hacer, es el correcto. No lo toquéis hasta tener un motivo.

Cuando aprieta

Opus 4.8

1M de contexto. Para lo gordo: decisiones difíciles, problemas largos, código que no sale. Más lento y gasta más cuota.

Cuando corre

Haiku 4.5

Tareas mecánicas. Rápido y barato — pero ojo: 200K de contexto. Es el único que no llega a 1M.

Se cambia con /model, y con /context veis cuánto lleváis gastado. Empezad siempre en Sonnet 5 y subid a Opus solo si se atasca — nunca al revés.

PARTE 02

Claude Code

Lo que convierte "un chat que sabe de redes en general" en "algo que sabe de VUESTRA red".

Claude Code

El salto que resuelve lo de Ángel

El nombre engaña: pone "Code" pero no va de programar. Va de trabajar sobre tus ficheros. Que casualmente es donde vive el contexto que le falta.

El chatLe cuentas tu problema con palabras. Él te contesta con palabras. Copias, pegas, adaptas. Tú eres el puente entre lo que dice y tus ficheros.
→
Claude CodeEstá dentro de tu carpeta. Lee tus ficheros, escribe otros, ejecuta comandos y te enseña el resultado. No hay puente: ya está al otro lado.
Lee
Tu CSV de redes, tu config de FortiGate, tus manuales
Escribe
Scripts, documentación, informes — en tu disco
Ejecuta
Lo lanza y te enseña si salió bien o si petó
La pieza clave

CLAUDE.md — el briefing del nuevo

Imaginad que entra un fichaje brillante. Sabe muchísimo de redes en general. Pero no sabe nada de vuestros clientes. ¿Qué hacéis el primer día? Le explicáis cómo se hacen las cosas aquí. Eso es un CLAUDE.md: un fichero de texto en vuestra carpeta que Claude Code lee antes de trabajar.

Qué metéis dentro

Vuestras reglas, una vez

"Usamos direccionamiento 10.x. Las VLAN de impresoras siempre son /29. Los clientes de Cornellà van en 10.20.x. Nunca proponer cambios en producción sin validación."

Qué pasa entonces

Deja de contestar "de manual"

Ya no os recomienda lo que se hace "en general". Os recomienda lo que se hace aquí. Lo escribís una vez y vale para siempre.

Ángel: esto es la respuesta a tu queja. No es que el modelo sea malo en redes — es que nadie le había contado nunca cómo son vuestras redes. Hoy no venimos a que sepa de redes. Venimos a que sepa de la vuestra.

MCP

Cuando necesita salir fuera

Prometimos hablar de MCP y hablamos. Es más simple de lo que suena el nombre: es el enchufe con el que Claude se conecta a otras herramientas.

El problema

Tus ficheros no son todo

Claude Code ve tu carpeta. Pero vuestros datos no viven solo ahí: viven en el ticketing, en el FortiGate, en la base de datos.

La solución

Un conector estándar

MCP es un enchufe común. Conectas Claude a una herramienta y ya puede leer de ella y actuar sobre ella. Sin programar la conexión desde cero.

Cuándo lo tocamos

En la S3 y la S4

Hoy no. Hoy os quedáis con el concepto. Cuando el portal exista (S3) y el agente tenga que hablar con él (S4), esto será la pieza.

En vuestro idioma: un conector es una regla de firewall. Vosotros decidís qué puede alcanzar y qué puede hacer cuando llegue. Claude no "entra" en vuestros sistemas: llega hasta donde le habéis abierto, y ni un salto más. Igual que cualquier otra cosa en vuestra red.

Honestidad: podríamos instalar un MCP hoy y quedaría vistoso. Pero sin el portal construido, sería un enchufe sin nada al otro lado. Lo vemos cuando sirva para algo.

PARTE 03

Comprobación

Ya lo tenéis instalado. Dos minutos para confirmar que está listo de verdad — y de paso, cómo lo instalamos nosotros y por qué.

Ahora mismo

«Instalado» no es «listo»

Lo tenéis instalado, pero eso no basta: el ejercicio de hoy necesita Python, y Claude Code puede estar instalado sin haber entrado con vuestra cuenta. Tres comandos, ahora, todos.

1

claude --version

Si devuelve un número, está instalado. Si dice que no reconoce el comando: cerrad PowerShell y abridlo otra vez. Es el fallo número uno y no es culpa vuestra.

2

python --version

Tiene que decir Python 3.x. Este es el que de verdad importa hoy: sin Python no hay Ejercicio 1.

3

claude → y que os responda

Si os pide entrar con la cuenta, entrad. Instalado sin autenticar no sirve.

El material está aquí: github.com/david-ramos-23/daratel-claude-code-s2 → botón verde Code → Download ZIP. Sin cuenta de GitHub. Si algo falla, decidlo en el chat — lo arreglamos en la pausa. La sesión no se para por una instalación.

Nuestra forma

Si mañana lo instaláis en otra máquina

Nosotros usamos el instalador nativo. Sin Node, sin WSL, sin Git, sin permisos de administrador. Se pone en vuestro perfil de usuario y se actualiza solo.

Windows

irm https://claude.ai/install.ps1 | iex

En PowerShell, no en CMD. Windows 10 (1809+) o superior, 64 bits.

macOS

curl -fsSL https://claude.ai/install.sh | bash

macOS 13.0 o superior.

Linux

curl -fsSL https://claude.ai/install.sh | bash

Ubuntu 20.04+ · Debian 10+ · Alpine 3.19+

¿No queréis terminal? Existe la app de escritorio de Claude Code: la misma potencia, con ventanas. La documentación oficial la propone como vía soportada, no como parche. claude.com/download

Checkpoint

Un pulgar a cámara si lo tienes

Este es el momento de la verdad de la sesión. Si estos dos responden, el resto es cuesta abajo.

Los dos que importan

claude --version
python --version

Los dos con número = listo. Ese es el artefacto que dice el contrato: Claude Code funcionando en tu máquina.

Si algo va raro

claude doctor

Te hace un diagnóstico y te dice qué falta. Antes de preguntar, lánzalo: la mitad de las veces la respuesta está ahí.

Contamos. Queremos ocho. Si sois ocho, hemos cumplido lo que este programa prometía para hoy — y son las siete de la tarde. Si te falta Python, dilo ahora: lo arreglamos en la pausa, no a las nueve y media.

Primeros pasos

Lo único que hay que saber

Cuatro cosas. No hay más. Todo lo demás se descubre usándolo.

claudeArrancarDesde la carpeta en la que quieras trabajar. Esto importa: verá lo que hay en esa carpeta
escribirPedir en español, como se lo pedirías a un compañeroSin sintaxis, sin comandos. "Léete el CSV y dime si hay redes que se pisen"
/helpVer qué más sabe hacerLas barras son comandos de la herramienta, no peticiones al modelo
/clearEmpezar de ceroCuando cambiéis de tema. Si no, arrastra la conversación anterior y se lía

El error de novato: escribir como si fuera un buscador. "solapamiento IP". No es Google. Habladle como a un compañero nuevo que es muy listo pero acaba de entrar: contadle el problema entero.

Control

No hace nada sin que lo apruebes

Es lo primero que preocupa cuando alguien oye "ejecuta comandos en tu ordenador". Y la preocupación es sana.

Por defecto

Te pregunta

Antes de tocar un fichero o lanzar un comando, te enseña qué va a hacer y espera. Tú dices sí o no. Así vais a trabajar hoy.

Cuando cojáis confianza

Le sueltas cuerda

Se le puede autorizar por adelantado para ciertas cosas. Eso se gana con horas de vuelo, no el primer día.

Nunca

Barra libre en producción

Existe el modo "no me preguntes nada". En la red de un cliente, jamás. Ni hoy ni en la S5.

Leed lo que os pregunta. El riesgo real no es que Claude Code haga algo raro: es que le deis a "sí" catorce veces seguidas sin mirar. El botón de aprobar es vuestra firma.

Secretos

Cómo se trabaja sin que la contraseña salga de casa

Ayer lo prometimos y aquí está. Vuestras configs están llenas de PSKs, comunidades SNMP y contraseñas de admin. La pregunta correcta no es "¿puedo usar esto?" sino "¿qué le doy y qué no?".

Esto sí

  • La topología, las VLAN, el direccionamiento
  • Las reglas de firewall sin las claves
  • Un log de errores, un CSV de redes
  • Una config con los secretos tachados

Esto nunca

  • Contraseñas de admin de un equipo
  • Pre-shared keys de un túnel VPN
  • Comunidades SNMP, tokens de API
  • Certificados o claves privadas

Y el truco de fondo: no le hace falta el secreto para ayudaros. Para explicaros una regla de firewall, para escribir el manual o para encontrar el solapamiento, la contraseña es irrelevante. Si estáis a punto de pegar una clave, casi siempre es que estáis pegando de más: quitadla y funciona igual.

PARTE 04

Caza el
solapamiento

Lo que ayer visteis hacer en pantalla, hoy lo hacéis vosotros. Y no es un ejercicio de juguete: es el primer ladrillo del portal de la S3.

El caso

Quince redes. Cuatro problemas.

Son las nueve de la mañana. Entra un cliente nuevo y hay que darle un rango que no pise nada. Antes de eso, alguien tendría que haber mirado lo que ya hay. Nadie lo ha mirado.

15
Redes de cliente, con VLAN, gateway y hosts asignados
4
Problemas plantados. Tres solapamientos y una subred sin sitio
5 min
Lo que tarda León en validar una sola a mano, según nos dijo ayer

Haced la cuenta: quince redes, a cinco minutos cada una, son hora y cuarto de calculadora online. Esta sesión dura tres horas. No os decimos cuáles son los cuatro. Eso es lo que vais a averiguar.

Ejercicio 1

Cuarenta minutos

Hay checkpoints. Llegar al 3 ya es haberlo conseguido. Del 4 en adelante es propina.

1

Crea la carpeta y entra

Descargad el CSV del grupo de WhatsApp y ponedlo dentro. Arrancad claude desde ahí.

2

Pídele que lo lea y te lo explique

"Léete redes-clientes.csv y dime qué tiene." Antes de pedirle nada, comprobad que lo ve.

3

Pídele que encuentre los problemas

"¿Hay redes que se solapen entre sí? ¿Y alguna que se haya quedado sin IPs libres?" En español. Sin tecnicismos.

4

Revisa lo que te ha dicho

Este paso no es opcional. ¿Son cuatro? ¿Te ha marcado alguno que en realidad no se pisa? Comprobad un par a mano. Si no lo verificáis, no lo sabéis.

5

Pídele el script

"Hazme un script que lo compruebe solo, para pasarlo cada vez que demos de alta un cliente." Ahí deja de ser una respuesta y pasa a ser una herramienta.

+

Reto libre

¿Ya lo tienes? No esperes. Pídele algo que no te hayamos pedido: un informe, un aviso de las que van por el 80%, lo que quieras romper.

Qué acaba de pasar

Eso no se tira

Lo que tenéis en la carpeta no es el resultado de un ejercicio. Es código que funciona sobre datos con la forma de los vuestros.

AyerCalculadora de redes online, cinco minutos por red, a ojo. Y un error de configuración al mes que aparece cuando ya ha dado la cara en casa del cliente.
→
AhoraUn script que revisa las quince en menos de un segundo, encuentra los cuatro problemas, y no se cansa a la novena. Y no habéis abierto la calculadora de redes.

Ojo con la conclusión fácil. El script no es listo: hace lo que le dijisteis. Si le pedís mal, os contesta mal igual de rápido. Y el tercer solapamiento —el de Badalona con Mataró— es el que enseña la lección: dos clientes en ciudades distintas con el mismo rango. No molesta a nadie… hasta el día que los unís por VPN.

PARTE 05

Tu caso

Quince minutos, cada uno por su lado. Aquí es donde esto deja de ser una formación y empieza a ser vuestro trabajo.

Ejercicio 2

Elige tu ruta

No todos hacéis lo mismo, así que no vais a practicar lo mismo. Coged la que se parezca a vuestro martes por la mañana.

Redes

Valida un plan nuevo

Entra un cliente con 40 puestos y dos VLAN. Pedidle que os proponga el direccionamiento y que compruebe que no choca con los catorce de antes.

Documentación

Config → manual

Le dais una configuración de equipo y le pedís el manual explicado para alguien que no es técnico. Guillermo, esta es la tuya.

Avanzada

Rompe algo

Ángel: arráncale un CLAUDE.md a vuestro contexto real y mira si deja de recomendarte tonterías. Es tu queja de ayer, convertida en experimento.

La consigna: no busquéis que salga bien. Buscad dónde se rompe. Lo que aprendáis de los fallos de hoy es lo que os va a ahorrar disgustos en la S5, cuando esto esté en producción.

Hasta la próxima

Deberes

Poco y concreto. Quince minutos en toda la semana. Pero hacedlos: la S3 arranca dando por hecho que están.

1

Usadlo una vez con algo vuestro de verdad

Una sola. Cualquier cosa real de vuestro trabajo. Lo que no se usa esta semana, se olvida.

2

Escribid tres líneas en un CLAUDE.md

Tres reglas de cómo hacéis las cosas aquí. Tres. En la S3 las ampliamos.

3

Traed un fallo

Algo en lo que se equivocara. Lo abrimos en la S3 entre todos. El que traiga el fallo más gordo, gana.

4

Los que faltéis: la encuesta

Solo la contestaron dos de ocho. Sin ese punto de partida no hay forma de demostrar en la S5 lo que ha mejorado. Cinco minutos.

La próxima

S3 · El portal de gestión IP

Cuatro horas. Y empieza exactamente donde hemos terminado hoy.

De dónde sale

Del script de hoy

Esa lógica de validación que acabáis de sacar es un módulo del portal. No empezamos de cero: empezamos de aquí.

Qué construimos

Un aplicativo de verdad

Con su base de datos y su interfaz. Donde el direccionamiento de los clientes deja de vivir en un Excel.

Quién lo hace

Cada uno un módulo

Ocho personas, ocho piezas del mismo portal. Nadie mira. Por eso hoy había que salir con la herramienta puesta.

Por eso hoy era la sesión bisagra. Sin Claude Code funcionando en las ocho máquinas, la S3 no se puede dar. Y funciona. Nos vemos en la próxima.

Fin de la sesión 2

Preguntas

Sobre todo las de
"esto no me ha funcionado".

S3 · Portal de gestión IP|4 h|CADA UNO UN MÓDULO
← → para navegar