Clase 05 · Módulo 02
Claude Code: instalación y primera sesión
Claude Code: instalación y primera sesión
Qué logras en esta clase
Claude Code queda funcionando en tu terminal y en VS Code, y haces un primer cambio que revisas antes de guardar.
- Instalas y compruebas la herramienta.
- Abres una sesión dentro de tu proyecto.
- Lees un diff y decides si aceptas.
- Sabes retroceder si el cambio no sirve.
02
Lo que ya viste y lo que suma esta clase
En «Claude de verdad», módulo 7, conociste qué es Claude Code e hiciste una primera sesión. Aquí no se repite.
Esta clase lo deja armado para construir una web: dentro de VS Code, al lado de tus archivos, con Git como red y con un ciclo de trabajo que repetirás en todo el curso.
Si no hiciste ese módulo, puedes seguir igual: los pasos están completos.
03
Dónde puede correr
| Lugar | Qué es | En este curso |
|---|---|---|
| Terminal | El comando claude | Sí |
| VS Code | Extensión con panel de chat y diffs visuales | Sí, es la vía principal |
| App de escritorio | Pestaña Code de la app de Claude | Alternativa válida |
| Web y celular | claude.ai/code | Para tareas a distancia |
Es el mismo Claude Code en todos. Cambia la interfaz, no lo que sabe hacer.
04
Lo que necesitas antes
- Un plan de Claude que lo incluya: Pro, Max, Team o Enterprise. También sirve una cuenta de Console, que cobra por uso.
- VS Code 1.94.0 o posterior para la extensión.
- Las tres bases de la clase 1 instaladas.
05
Instalar el comando claude
La instalación nativa es la recomendada: no depende de Node y se actualiza sola. Usa el comando de tu terminal:
# macOS, Linux o WSL
curl -fsSL https://claude.ai/install.sh | bash# Windows, en PowerShell
irm https://claude.ai/install.ps1 | iexEn Windows no pide permisos de administrador. El instalador no muestra avance mientras descarga: espera a que termine.
06
Comprobar la instalación
Abre una terminal nueva y ejecuta:
claude --version
claude doctorEl primero responde con un número de versión seguido de (Claude Code). El segundo hace un diagnóstico de solo lectura y te avisa si algo quedó mal configurado.
Para actualizar a mano existe claude update, aunque la instalación nativa lo hace en segundo plano.
07
Si el comando no aparece
Y el clásico de Windows: el comando que empieza con irm es de PowerShell. Pegado en CMD falla. Mira si tu indicador muestra PS antes de pegar.
08
Instalar la extensión de VS Code
- Abre la vista de extensiones:
Ctrl+Shift+Xen Windows y Linux,Cmd+Shift+Xen Mac. - Busca «Claude Code».
- Comprueba que el editor sea Anthropic.
- Instala.
09
Abrir el panel de Claude
Tres formas, la que te quede más a mano:
- El ícono Spark arriba a la derecha del editor. Solo aparece cuando tienes un archivo abierto.
- ✻ Claude Code en la barra de estado, abajo a la derecha.
- La paleta de comandos (
Ctrl+Shift+PoCmd+Shift+P), escribiendo «Claude Code» y eligiendo Open in New Tab.
Con Ctrl+Esc o Cmd+Esc alternas entre el editor y Claude.
10
Extensión y comando son dos instalaciones
La extensión trae su propia copia de Claude Code para el panel de chat. No instala el comando claude en tu terminal.
Por eso en esta clase instalaste ambos: el panel para trabajar con diffs visuales y el comando para cuando prefieras la terminal integrada. Comparten cuenta, configuración y memoria del proyecto.
11
Siempre dentro del proyecto
Claude Code trabaja sobre la carpeta donde lo abres. Ábrelo en la carpeta de tu web, nunca en tu carpeta de usuario.
12
Iniciar sesión
- Abre tu carpeta de proyecto en VS Code.
- Abre el panel de Claude, o escribe
claudeen la terminal integrada. - La primera vez te pide entrar: se abre el navegador.
- Entra con la cuenta que tiene tu plan y autoriza.
- Vuelve a VS Code.
Las credenciales quedan guardadas. Para cambiar de cuenta más adelante, escribe /login dentro de la sesión.
13
Primero pregunta, después pide
Antes de cambiar nada, haz que Claude lea. No necesitas indicarle archivos: los abre según los necesita.
Sirve para dos cosas: confirmas que está parado en la carpeta correcta y aprendes cómo describe tu proyecto, que es como lo va a entender cuando le pidas cambios.
14
El modo en que parte: Auto
Desde la versión 2.1.283, las sesiones de terminal y de VS Code parten en modo Auto: Claude actúa sin preguntarte y un clasificador automático revisa cada acción.
Para aprender conviene Manual: solo lee sin permiso y pregunta antes de editar o ejecutar.
- En VS Code: el indicador de modo al pie del cuadro de texto.
- En la terminal:
Shift+Tabrecorre los modos.
La clase 6 los explica todos.
15
El ciclo de un cambio revisado
Es el mismo ciclo para cambiar una palabra o construir una sección entera. Lo que cambia es el tamaño del pedido, no los pasos.
16
Tu primer cambio
- Confirma con
git statusque no hay cambios pendientes. - En modo Manual, pide algo pequeño y verificable.
- Claude muestra el cambio y pide permiso.
- Lee lo que propone y acepta si corresponde.
- Abre el archivo y comprueba el resultado.
- Haz commit.
17
Cómo leer un diff
Un diff es la comparación entre el archivo antes y después. En VS Code se ve lado a lado o en línea:
- Rojo: líneas que salen.
- Verde: líneas que entran.
- Sin color: contexto que no cambia.
No necesitas entender cada línea de código. Pregúntate tres cosas: ¿tocó solo los archivos que esperaba?, ¿el tamaño del cambio calza con lo que pedí?, ¿borró algo que yo no pedí borrar?
18
Si el resultado no sirve
Claude Code guarda un punto de control cada vez que envías un mensaje.
| Dónde | Cómo retrocedes |
|---|---|
| VS Code | Pasa el cursor sobre tu mensaje y usa el botón de retroceso (Rewind code to here) |
| Terminal | /rewind, o Esc dos veces con el cuadro vacío |
El menú de la terminal permite restaurar el código, la conversación o ambos.
19
Tú apruebas, tú respondes
Claude propone y ejecuta. La decisión de aceptar es tuya, y también la responsabilidad de lo que queda publicado.
20
Pedido chico contra pedido gigante
El pedido gigante produce cientos de líneas que no podrás revisar y decisiones que no tomaste. El chico produce un diff que lees en un minuto.
Los pedidos grandes existen, pero pasan primero por el modo plan (clase 6).
21
Panel de VS Code o terminal
| Panel de VS Code | Terminal | |
|---|---|---|
| Diffs | Visuales, junto a tus archivos | En texto |
| Referir archivos | @ y selección con Alt+K u Option+K | @ |
| Varias conversaciones | En pestañas | Una por terminal abierta |
| Conviene si | Estás aprendiendo y quieres ver todo | Ya te manejas y prefieres teclado |
Empieza por el panel. Cambiar después no cuesta nada.
22
Dos errores del primer día
El segundo: no hacer commit entre pedidos. Si encadenas cinco cambios sin guardar y el quinto rompe algo, no puedes volver solo al cuarto. Un commit por cada cambio que funciona.
23
Lo que te llevas
- Claude Code exige plan de pago; el plan gratis no lo incluye.
- Comando y extensión se instalan por separado y comparten cuenta y configuración.
- Se abre siempre dentro de la carpeta del proyecto.
- Parte en Auto; mientras aprendes, trabaja en Manual.
- Ciclo fijo: commit, pedido chico, leer el diff, probar, commit.
24
Hazlo ahora
En 15 minutos, en tu carpeta practica:
- Comprueba
claude --versione instala la extensión en VS Code. - Abre el panel, inicia sesión y cambia a modo Manual.
- Pregunta qué hay en el proyecto.
- Pide un cambio pequeño en
notas.txt, lee el diff y acéptalo. - Pide otro, y esta vez retrocede con el botón de tu mensaje.
- Haz commit del cambio que conservaste y
git push.
Clase terminada
Sigue con la próxima.
Fuentes · revisadas el 18 de noviembre de 2026
- Claude Code: instalación y requisitoscode.claude.com ↗
- Claude Code: inicio rápidocode.claude.com ↗
- Claude Code en VS Codecode.claude.com ↗
- Claude Code: modos de permisoscode.claude.com ↗
- Claude Code: puntos de control y rewindcode.claude.com ↗
- Claude Code: solución de problemas de instalacióncode.claude.com ↗
- Claude: planes y preciosclaude.com ↗