Solución de problemas básicos y actualizaciones

Esta lección todavía está en pruebas: mejora con los comentarios de quienes la siguen. Si algo no está claro, hay que corregir la lección, no a ti.

Al final de esta lección, sabrás

aplicar 4 reflejos en orden cuando algo se bloquea;
reconocer los bloqueos más frecuentes y su solución;
encontrar la versión de tu app y de Claude Code, y actualizar;
pedir ayuda con la información adecuada.

Por qué te interesa

Un bloqueo técnico desanima más rápido que una dificultad de aprendizaje. Sin embargo, la mayoría se resuelven en dos minutos: una carpeta equivocada, un modo que no es el correcto, una sesión que hay que volver a abrir, un límite de uso. Esta lección te da autonomía en estos casos, y te dice cuándo pedir ayuda.

Antes de empezar


Necesitas	La app Claude con la pestaña Code, tu carpeta mon-espace-ia y tu carpeta de pruebas mon-espace-ia-essais (lección 4)
Costo	Suscripción a Claude Pro como mínimo: 18 € al mes sin IVA, precio mostrado en Francia a fecha de 24/10/2026
Duración	35 minutos
Recordatorio	No muestres nunca una contraseña, ni en un mensaje ni en una captura

Entenderlo en 3 minutos

Los 4 reflejos, en orden:

Leer el mensaje entero, y copiarlo tal cual.
Comprobar los 3 elementos de configuración: la carpeta abierta, el modo, la cuenta conectada.
Reiniciar: salir por completo de la app, volver a abrirla, abrir una nueva sesión.
Actualizar la app y luego abrir una nueva sesión.

Los bloqueos más frecuentes, según la documentación de Claude Code (24/10/2026) y la experiencia de las lecciones anteriores:

Lo que ves	Lo que haces
Error 403 o problema de autenticación en la pestaña Code	Cerrar sesión y volver a iniciarla desde el menú de la app (la solución más frecuente); comprobar que tu suscripción de pago está activa; si el problema sigue, y sobre todo si la terminal funciona pero la app no, salir por completo de la app, volver a abrirla e iniciar sesión de nuevo
«Authentication required · Sign in again to continue»	Volver a iniciar sesión desde la app
Pantalla en blanco o bloqueada al iniciar	Reiniciar la app; en Mac y Windows, se actualiza al abrirse
«Failed to load session»	Puede que la carpeta elegida ya no exista (movida, con otro nombre): vuelve a elegir tu carpeta, o reinicia la app
«You’ve hit your session limit · resets…» o «…weekly limit…»	Has alcanzado tu límite de uso: espera a la hora indicada, o cambia de plan. Lo que usas en claude.ai, en Claude Code y en la app cuenta en el mismo límite
«API Error: 500» o «Repeated 529 Overloaded errors»	Un problema temporal de Anthropic, no tuyo: espera un minuto y luego vuelve a enviar tu mensaje; el estado del servicio está en status.claude.com. Un error 529 no cuenta en tu límite
Claude no encuentra `CLAUDE.md` o el recorrido	Está abierta la carpeta equivocada: abre una nueva sesión en mon-espace-ia
Claude modifica archivos sin preguntarte	El modo no es Manual: cámbialo en el selector, debajo de la zona de texto
Rechazaste un permiso por error	No se ha roto nada: dilo, y Claude te hace una nueva propuesta

Hagámoslo juntos

1Paso 1: Anotar tus versiones

Versión de la app: en Mac, menú Claude y luego Acerca de Claude; en Windows, menú Ayuda y luego Acerca de Claude (en inglés: Help, About Claude; etiquetas en español tomadas de los archivos de traducción de la app para Mac, sin captura).
Versión de Claude Code en la pestaña Code: en una sesión, escribe /status y lee la línea «Claude Code».

Anota las dos en tu ficha de solución de problemas (recurso más abajo).

2Paso 2: Buscar actualizaciones

En Mac: menú Claude y luego Buscar actualizaciones… (en inglés, Check for Updates…); en Windows: Ayuda y luego Buscar actualizaciones…. Después, abre una nueva sesión: según la documentación, la pestaña Code usa su propia copia de Claude Code, que la app descarga y actualiza, y una nueva sesión toma la nueva versión.

Si también usas Claude Code en la terminal (lección 2): la instalación recomendada se actualiza sola en segundo plano. Son dos copias separadas: actualizar una no actualiza la otra.

3Paso 3: Reconocer una avería sin riesgo

Abre una nueva sesión en tu carpeta de pruebas mon-espace-ia-essais, en modo Manual, y escribe:

Lee el archivo DEMARRER-ICI.md y guíame.

Claude no lo encuentra: es el síntoma de la carpeta equivocada. También puede proponer buscar en otro lugar de tu computadora: si aparece una solicitud de permiso para eso, recházala. Cierra esta sesión y luego abre una nueva sesión en mon-espace-ia. Ahora sabrás reconocer este caso en un segundo.

4Paso 4: Preparar una solicitud de ayuda

En tu ficha de solución de problemas, completa la plantilla «Para pedir ayuda» con una avería imaginaria, por ejemplo el error 403. Comprueba que no haya ni contraseña ni dirección de correo completa.

Ahora te toca a ti

Tu ficha de solución de problemas, completada y guardada:

tus versiones y tu plan;
los 4 reflejos;
la plantilla de solicitud de ayuda;
con cada nueva avería resuelta, una línea en «Mis averías ya resueltas».

Recursos para descargar

Mi ficha de solución de problemas: tu configuración, los 4 reflejos, la plantilla de solicitud de ayuda y el seguimiento de tus averías.

Comprobar

Funcionó si:

tu ficha indica la versión de tu app y la de Claude Code, con la fecha;
sabes dónde buscar las actualizaciones, en tu sistema;
reconociste el síntoma de la carpeta equivocada y luego volviste a abrir la correcta;
tu plantilla de solicitud de ayuda está lista, sin ninguna información secreta.

Errores frecuentes:

reinstalarlo todo al primer problema: empieza por los 4 reflejos;
cerrar la ventana sin salir de la app: en Windows, el icono puede quedarse cerca del reloj;
describir de memoria un error en lugar de copiar el mensaje exacto;
tomar un error 500 o 529 por un fallo tuyo: es temporal, del lado del servidor.

Guardar y retomar

Guarda tu ficha en mon-espace-ia o cerca de tu computadora.
Anota tu versión después de cada actualización importante.

Para ir más lejos

opcional

La documentación oficial, en inglés: la parte «Troubleshooting» de code.claude.com/docs/en/desktop para la app, y code.claude.com/docs/en/errors para cada mensaje de error.
En la terminal: /doctor comprueba tu instalación y propone correcciones; si claude ya no arranca en absoluto, ejecuta claude doctor desde la terminal.

Palabras nuevas

4 palabras explicadas

Palabra	Lo que significa
Versión	El número que dice qué edición de un programa estás usando
Actualización	El paso a una versión más reciente, que corrige problemas
Límite de uso	La cantidad de trabajo que permite tu plan, renovada por periodos de 5 horas y cada semana
Mensaje de error	El texto que dice lo que falló; se copia tal cual para buscar la solución

Por verificar: las etiquetas en español de los menús «Acerca de Claude» y «Buscar actualizaciones…» (captura por hacer); el comportamiento del icono cerca del reloj en Windows no se ha probado.

Fecha, versión, fuentes Redactada el 24/10/2026. Comprobaciones del 24/10/2026:

solución de problemas de la app (error 403, pantalla en blanco, «Failed to load session», versiones, actualizaciones, copia de Claude Code propia de la pestaña Code): code.claude.com/docs/en/desktop, parte «Troubleshooting»;
mensajes de error (500, 529, límites de uso, volver a iniciar sesión): code.claude.com/docs/en/errors;
/doctor y claude doctor: code.claude.com/docs/en/troubleshooting;
actualizaciones automáticas de la instalación recomendada: code.claude.com/docs/en/setup;
límites de uso comunes a claude.ai, Claude Code y la app: support.claude.com, «How do usage and length limits work?»;
precio de Claude Pro: claude.com/pricing (página mostrada en Francia).