Herramientasclaude code
Cómo actualizar Claude Code: guía por instalación
Cómo actualizar Claude Code si usas instalación nativa, Homebrew o WinGet: identifica tu método, comprueba la versión y resuelve fallos habituales.
- Autor: humAIns
- 8 min de lectura
índice · 6 apartados
Actualizar Claude Code no siempre significa ejecutar el mismo comando: el método depende de si instalaste la versión nativa, el paquete de Homebrew o WinGet. Primero identifica qué ejecutable está usando tu terminal; después aplica la actualización correspondiente y confirma la versión. Esta guía se ha comprobado el 14 de noviembre de 2026 con la documentación oficial de Anthropic.
Antes de actualizar: versión activa y método de instalación
Empieza por anotar la versión que realmente se ejecuta:
claude --version
El comando imprime un número de versión. No lo confundas con una versión disponible en una página o con la de una instalación que no está en tu PATH: si hay varias copias del programa, la primera que encuentra el terminal puede ser otra.
Para revisar el diagnóstico de instalación y el resultado del intento de actualización registrado, ejecuta:
claude doctor
La documentación describe claude doctor como una comprobación de solo lectura de la instalación, los ajustes y posibles avisos. No actualiza el programa por sí solo.
Si no recuerdas cómo lo instalaste, comprueba los ejecutables visibles en el PATH y compáralos con el gestor que usaste. En macOS o Linux, which -a claude muestra las rutas encontradas. En Windows PowerShell, usa where.exe claude. Más de una ruta es una señal para investigar, no una invitación a borrar archivos al azar: puede haber una instalación nativa junto a Homebrew, WinGet o una instalación npm anterior.
| Instalación | ¿Se actualiza sola por defecto? | Actualización manual | Cómo comprobar |
|---|---|---|---|
| Nativa (macOS, Linux, WSL o Windows) | Sí, en segundo plano | claude update | claude --version y claude doctor |
| Homebrew, cask estable | No | brew upgrade claude-code | claude --version |
| Homebrew, cask latest | No | brew upgrade claude-code@latest | claude --version |
| WinGet | No | winget upgrade Anthropic.ClaudeCode | claude --version |
Los comandos y comportamientos de la tabla corresponden a la guía oficial de instalación y actualización de Claude Code. No ejecutes varios métodos de actualización para probar suerte: actualiza con el gestor que instaló la copia activa.
Actualizar según tu instalación
Instalación nativa
La instalación nativa se actualiza en segundo plano: Claude Code busca actualizaciones al inicio y periódicamente mientras está abierto. La actualización se descarga en segundo plano y se aplica la próxima vez que inicies el programa. Si quieres aplicarla sin esperar al siguiente chequeo, ejecuta desde el terminal:
claude update
Después abre una sesión nueva y consulta claude --version. Para saber si el último intento automático falló, revisa claude doctor; si aparece un error de actualización, sigue el diagnóstico oficial en vez de reinstalar repetidamente.
Homebrew
Homebrew no actualiza Claude Code automáticamente por defecto. Actualiza el cask que instalaste:
brew upgrade claude-code
Si instalaste el cask claude-code@latest, utiliza ese mismo nombre:
brew upgrade claude-code@latest
La elección del cask también determina el canal: claude-code sigue stable, mientras que claude-code@latest sigue latest. La documentación de Anthropic caracteriza stable como un canal normalmente alrededor de una semana más antiguo que latest, que recibe las versiones cuando se publican; stable puede omitir versiones con regresiones importantes. Ejecutar la actualización equivocada puede no encontrar el paquete esperado: no cambies de cask solo para hacer desaparecer un mensaje de error.
WinGet
Las instalaciones con WinGet tampoco se actualizan automáticamente por defecto. En PowerShell, solicita la actualización con:
winget upgrade Anthropic.ClaudeCode
WinGet puede no completar la sustitución mientras Claude Code está abierto, porque Windows bloquea el ejecutable. Cierra las sesiones activas e inténtalo de nuevo; si Claude Code te indica el comando manual, sigue ese aviso. No abras una consola como administrador salvo que el administrador de tu equipo o la política de la organización lo requiera.
¿Y si mi instalación es con npm o un gestor de Linux?
El brief se centra en nativa, Homebrew y WinGet, pero quizá tu instalación antigua se hizo con npm o con apt, dnf o apk. No apliques a esas copias los comandos de Homebrew o WinGet. La documentación de Anthropic mantiene instrucciones separadas para gestores de paquetes de Linux y npm; sigue las indicaciones de tu gestor y evita sudo npm install -g, que Anthropic desaconseja por problemas de permisos y seguridad.
Comprobar que se aplicó y resolver problemas
Tras actualizar, cierra y vuelve a abrir Claude Code y ejecuta claude --version. Si sigues viendo una versión anterior, revisa estas posibilidades en orden:
- Estás ejecutando otra copia. Usa
which -a claudeen macOS/Linux owhere.exe claudeen PowerShell para localizar duplicados. Mantén una instalación coherente y consulta cómo detectar instalaciones en conflicto antes de retirar ninguna. - El terminal conserva un PATH antiguo. Abre una terminal nueva; si trabajas desde una terminal integrada en un editor, reinicia también el editor. El terminal puede seguir encontrando el ejecutable anterior aunque ya se haya actualizado otro.
- Falta el comando.
command not foundo «no se reconoce» no demuestra que Claude Code no esté instalado: puede que la carpeta de instalación no esté en PATH. La documentación oficial explica cómo comprobarlo y añadir la ruta para cada sistema en solución de problemas de instalación. - Hay un problema de permisos. No intentes resolverlo instalando con privilegios elevados ni cambiando permisos de forma amplia. Comprueba qué directorio señala el error y sigue la guía oficial de errores de permisos; en un equipo de empresa, consulta al área de TI antes de cambiar permisos administrados.
- La descarga o conexión falla. Revisa el mensaje exacto y la conexión al servicio de descargas. Un proxy o filtro corporativo puede bloquear la descarga; no desactives el antivirus, la verificación de firma ni las protecciones de red. Consulta la guía oficial para problemas de conexión durante la instalación o actualización.
Anthropic indica que, en ocasiones, puede avisar de una versión antes de que esté disponible en Homebrew o WinGet. Si el gestor no encuentra la actualización, espera un poco y vuelve a intentarlo en lugar de recurrir a un instalador de terceros.
Canales y políticas de actualización
En instalaciones nativas, el ajuste autoUpdatesChannel permite escoger latest o stable. latest es el valor predeterminado y da acceso a novedades al publicarse; stable sigue una versión normalmente más probada y puede llevar retraso. Se configura desde /config o en el archivo de ajustes, siguiendo la referencia oficial de canales.
Homebrew elige el canal por el nombre del cask, no por ese ajuste. En organizaciones, Anthropic documenta ajustes administrados que pueden fijar el canal y límites de versión. También existe CLAUDE_CODE_PACKAGE_MANAGER_AUTO_UPDATE=1 para que Claude Code ejecute en segundo plano la actualización del paquete Homebrew o WinGet; no es el comportamiento predeterminado. En WinGet puede fallar si la aplicación está abierta. Antes de cambiar ajustes de equipo, confirma la política con la persona administradora: una configuración central puede prevalecer sobre tus preferencias.
Preguntas frecuentes
¿Cómo veo mi versión de Claude Code?
Ejecuta claude --version en el terminal. Si quieres comprobar la salud de la instalación y el último intento de actualización, añade claude doctor.
¿Por qué Homebrew no se actualiza automáticamente?
Homebrew no actualiza Claude Code de forma automática por defecto. Ejecuta brew upgrade claude-code para el cask estable o brew upgrade claude-code@latest si instalaste el canal latest.
¿Qué hago si el comando claude no aparece?
Abre una terminal nueva y verifica que la ruta de instalación esté incluida en PATH. Consulta which -a claude en macOS/Linux o where.exe claude en PowerShell para descartar que haya otra instalación. Sigue las instrucciones oficiales según tu sistema operativo.
¿Una actualización afecta mis skills?
Actualizar el ejecutable no equivale a borrar las carpetas donde guardas tus skills. Si dejan de detectarse, comprueba que sigan en la ubicación esperada y que el terminal esté usando el entorno correcto; puedes consultar nuestra guía para instalar skills en Claude Code y qué es un skill en IA.
Mantener actualizada una herramienta es también una oportunidad para revisar cómo encaja en el trabajo diario. Puedes leer cómo usar Claude en el trabajo y explorar la formación en IA para marketing, un programa general de IA aplicada, no un curso específico de Claude Code.
Fuentes y fecha de comprobación
- Configuración avanzada, instalación y actualización de Claude Code, consultada el 14 de noviembre de 2026.
- Solución de problemas de instalación e inicio de sesión, consultada el 14 de noviembre de 2026.