hiddenrows

Guías prácticas para trabajar con agentes de IA, con un laboratorio al final de cada una

última edición=16 de octubre · 24 piezas · 14 breves
regla=solo lo verificado como hecho
llamadas a un modelo por visita=0

Camino al examen · Bloque 0, Dónde se trabaja

0.2 · Qué tienes instalado, en qué versión, y si se actualiza solo2026-10-02

Dónde. Terminal. Vale cualquier carpeta: estas órdenes no abren sesión ni tocan nada.

Qué vas a entender. Qué versión tienes, cómo la instalaste, y si tu instalación se pone al día sola o te toca a ti.

Por qué esto no es un trámite

Las correcciones de seguridad llegan en versiones. En las dos últimas semanas se arreglaron tres fallos del mismo terreno: la herramienta de PowerShell dejaba pasar borrados que las reglas de permisos debían frenar, un borrado recursivo podía ejecutarse sin preguntar en modo automático, y una orden peligrosa dejaba de pedir confirmación si redirigía su salida.

Si tu instalación se actualiza sola, ya los tienes. Si no, los tendrás el día que te acuerdes. Y la diferencia depende de con qué orden la instalaste hace meses, que es justo lo que nadie recuerda.

Las tres formas de instalar, y cuál se actualiza sola

Forma¿Se actualiza sola?Si no, qué se teclea
Instalación nativa, la que recomienda la documentaciónSí. Se pone al día en segundo plano VNada
Homebrew, en macOSNo Vbrew upgrade claude-code, o brew upgrade claude-code@latest según el barril que instalaras
WinGet, en WindowsNo Vwinget upgrade Anthropic.ClaudeCode

Hay además una cuarta vía en Linux, con apt, dnf o apk en Debian, Fedora, RHEL y Alpine. V

Qué hace cada una de las dos órdenes

claude --version imprime un número de versión, con la forma 2.1.211 (Claude Code). Si no imprime nada parecido, no hay instalación o no está en el camino de búsqueda del sistema. V

claude doctor va más allá: imprime un diagnóstico de solo lectura de la instalación y de la configuración, sin abrir sesión. Dice si la instalación está sana, si algún fichero de ajustes tiene errores de validación, y los avisos que haya con su arreglo sugerido. V

Que no abra sesión importa: puedes pasarlo cuantas veces quieras sin gastar nada de tu cuota.

Haz esto

  1. Mira qué versión tienes.

    Terminal, cualquier carpeta

    claude --version

    Tienes que ver: Un número con la forma 2.1.287 (Claude Code). Apúntalo: lo vas a comparar dentro de un minuto.

  2. Pásale el diagnóstico completo.

    Terminal

    claude doctor

    Tienes que ver: El estado de la instalación, los errores de validación de tus ficheros de ajustes si los hay, y los avisos con su arreglo. No abre sesión ni gasta cuota.

  3. Averigua cómo la instalaste. En Windows, pregúntale a WinGet si la conoce.

    Terminal de Windows (PowerShell o CMD)

    winget list Anthropic.ClaudeCode

    Tienes que ver: Si aparece, la instalaste con WinGet y no se actualiza sola. Si no aparece, es instalación nativa y sí se actualiza.

  4. En macOS, pregúntale lo mismo a Homebrew.

    Terminal de macOS

    brew list --cask | grep claude-code

    Tienes que ver: Si aparece, la instalaste con Homebrew y no se actualiza sola.

  5. Si no se actualiza sola, ponla al día ahora.

    Terminal

    winget upgrade Anthropic.ClaudeCode

    Tienes que ver: La versión nueva instalada. Vuelve a pasar claude --version y compara con la que apuntaste.

Si no sale

claude no se reconoce o no se encuentra.
La instalación existe pero su carpeta no está en el camino de búsqueda del sistema. Abre una ventana nueva de terminal; si sigue igual, busca «Fix your PATH» en la página de problemas de instalación.
winget no se reconoce.
Estás en una terminal que no es la de Windows, por ejemplo WSL. Las órdenes de WinGet y de Homebrew se pasan en la terminal del sistema que corresponda, no dentro de WSL.
claude doctor avisa de un error en un fichero de ajustes.
Casi siempre es una coma de más o de menos en un JSON. El propio aviso dice qué fichero. No lo dejes para después: un fichero de ajustes con error no se aplica, y las reglas de permisos que creías tener no están.

Comprobación

Instalaste Claude Code con WinGet hace tres meses y no has vuelto a tocarlo. Hoy sale una corrección de seguridad en los permisos de borrado. ¿Qué pasa?

Ver la respuesta
  1. La tendrás en unos minutos: Claude Code se actualiza solo en segundo plano.
  2. No la tendrás hasta que pases winget upgrade Anthropic.ClaudeCode a mano.
  3. La tendrás la próxima vez que abras una sesión, porque se comprueba al arrancar.
  4. Depende del plan de suscripción que tengas.

Solo la instalación nativa se actualiza sola. Las de WinGet y las de Homebrew no, y la documentación lo dice expresamente en las dos. Con esas dos formas, estar al día es una tarea tuya, y de ahí que valga la pena saber cuál tienes antes de necesitarlo. El plan de suscripción no interviene en esto.

Esta pregunta la hemos escrito nosotros a partir del temario público. No reproducimos contenido del examen.

De dónde sale todo esto

Siguiente: Con qué cuenta trabajas, qué plan tienes y adónde se va tu consumo — leerla

hiddenrows · proyecto personal de divulgación de Miguel Yepes Contenido divulgativo, puede contener errores · sin garantías · Aviso legal · Privacidad · llms.txt