Índice del artículo
- En 30 segundos
- Empieza con una página de prueba
- Antes de descargar
- Elige dónde vas a trabajar
- Instalación: Mac, Windows, escritorio o web
- Entra y comprueba la cuenta · terminal
- Una clave puede cambiar la vía de cobro
- Manual y aislamiento son controles distintos
- Del encargo al archivo revisado
- Envía tu primera tarea
- Cómo sabes que el ejercicio está bien
- Si te atascas, comprueba el síntoma
- Después de la primera prueba
- Dudas sobre instalar Claude Code, respuestas cortas
En 30 segundos
Para instalar Claude Code en Mac o Windows, usa el instalador oficial o la aplicación de escritorio, entra con una cuenta compatible y prepara una carpeta de prueba en modo Manual.
Free no incluye Code. Puedes entrar con una suscripción de pago compatible; en terminal también puedes pagar por consumo (según modelo y uso, sin suscripción) mediante una cuenta de Console, la vía de facturación de Anthropic para desarrolladores.
También hay acceso web, sin instalación local: el inicio documentado conecta un proyecto de GitHub y trabaja en la nube.
Empieza con una página de prueba
Imagina un taller de bicicletas de Valladolid que quiere preparar una página con su horario y servicios. Es un ejemplo ilustrativo con información ficticia. El objetivo del ejercicio es crear un archivo local y comprobarlo; la web del negocio queda fuera del encargo.
Claude Code es un agente de programación: un programa que usa IA para decidir pasos y utilizar herramientas sobre los archivos que le permites manejar. Si necesitas primero entender qué hace, consulta qué es Claude Code. Aquí vamos a instalarlo y preparar ese encargo pequeño.
En Ciade lo usamos a diario desde España. Para tu primera prueba, elige una vía de entrada y sigue su recorrido hasta ver la cuenta y la carpeta correctas. Instalarlo por varias vías a la vez complica saber qué estás abriendo.
Antes de descargar
- Mac, instalación de terminal
- macOS 13.0 o posterior, al menos 4 GB de RAM, procesador x64 o ARM64 y conexión a internet. La terminal es la ventana donde escribes órdenes para el ordenador.
- Windows, instalación de terminal
- Windows 10 1809 o posterior, o Server 2019 o posterior; al menos 4 GB de RAM, x64 o ARM64 e internet. Puedes instalarlo directamente en Windows.
- Carpeta del ejercicio
- Prepara una carpeta nueva con material ficticio. Si después trabajas con archivos existentes, conserva una copia independiente. Evita empezar desde la carpeta general de la empresa o con documentos de clientes.
Los requisitos de sistema anteriores corresponden al cliente de terminal. Para escritorio, elige la descarga oficial que corresponda a tu equipo.
Qué cuenta necesitas y qué se paga
Free
Acceso a Claude Code: No incluye Code.
Qué comprobar: Descargar el programa no habilita el acceso del plan gratuito.
Pro
Acceso a Claude Code: Sí. Web: 20 USD/mes o 200 USD/año por adelantado, sin impuestos.
Qué comprobar: Entrada personal con límites de uso (cupos) por ventanas de 5 horas y por semana, no uso ilimitado. Confirma el importe en euros y los impuestos al contratar.
Max y Ultra
Acceso a Claude Code: Sí. Ofrecen más capacidad de uso.
Qué comprobar: No necesitas contratarlos para instalar Code; mantienen límites.
Team
Acceso a Claude Code: Todos los puestos incluyen Code; Premium ofrece más uso.
Qué comprobar: Entra con la cuenta invitada por el administrador.
Enterprise
Acceso a Claude Code: Depende del contrato y el puesto. Los contratos antiguos pueden distinguir varios tipos.
Qué comprobar: Para nube, la guía exige Premium o Chat + Claude Code y los permisos de la organización. Confírmalo con el administrador.
Console en terminal
Acceso a Claude Code: Alternativa de pago por consumo, con facturación según modelo y uso.
Qué comprobar: Es otra vía de cobro. No presupongas que este acceso sirve también en escritorio.
Condiciones del 01-11-2026. Instalar Code no añade otra suscripción. El precio de entrada personal es el de Pro; para una comparación más amplia, consulta la ficha de Claude Code.
Elige dónde vas a trabajar
Escritorio permite empezar sin usar la terminal. La aplicación tiene una pestaña Code y deja revisar visualmente los cambios de una carpeta. La terminal permite iniciar Claude Code desde la carpeta elegida escribiendo órdenes. Ambas vías están disponibles en España, con sus requisitos de equipo y cuenta.
La web tiene otro recorrido: GitHub, el servicio donde se guarda y revisa un proyecto de código, proporciona el repositorio. Un repositorio conserva los archivos del proyecto y su historial. Si todavía no tienes uno, usa la carpeta local de este ejercicio.
Cambia de pestaña para seguir las instrucciones de tu vía. Las órdenes de instalación descargan y ejecutan un programa: compara la dirección con la guía oficial de terminal antes de pegarlas. También tienes el enlace de descarga e inicio en escritorio y el acceso a Claude Code en la web.
Instalación: Mac, Windows, escritorio o web
- TúPulsa Cmd + Espacio, escribe Terminal y pulsa Intro. Se abre una ventana donde pegar las órdenes.
- TúAbre la guía oficial de terminal. Compara la orden de Mac con esta: «curl -fsSL https://claude.ai/install.sh | bash». Pégala en Terminal y pulsa Intro. Descarga y ejecuta el instalador de Anthropic.
- ReglasDeja la ventana abierta mientras termina. La descarga puede no mostrar progreso. Espera al resultado del instalador antes de lanzar otra instalación. Si devuelve un error, ve al apartado «Si te atascas».
- TúAbre una ventana nueva de Terminal. Escribe «claude --version» y pulsa Intro. Debe devolver un número de versión: así compruebas que encuentra el programa. Todavía falta iniciar sesión.
- TúPara crear la carpeta del ejercicio, escribe «mkdir prueba-claude-code» y pulsa Intro. Después escribe «cd prueba-claude-code» y pulsa Intro. La primera orden crea la carpeta; la segunda te sitúa dentro. Continúa en «Entra y comprueba la cuenta».
Abre la terminal, instala el cliente y comprueba que el ordenador lo encuentra.
Entra y comprueba la cuenta · terminal
Arranca desde la carpeta de prueba
En la misma ventana donde has entrado en la carpeta, ejecuta «claude --permission-mode manual». Esa orden abre Code y selecciona Manual expresamente. Comprueba el indicador de modo; no des por hecho que una sesión nueva empieza con ese ajuste.
Completa el acceso en el navegador
La primera vez se abre el navegador para entrar. Elige la misma cuenta que tiene la suscripción o la que ha invitado tu empresa. Completa el acceso y vuelve a la terminal; si te pide pegar el código que devuelve el navegador, sigue esa indicación.
Revisa carpeta y método de acceso
Si aparece una petición de confianza, acéptala solo para la carpeta preparada y conocida. Dentro de Code, escribe «/status»: muestra cuenta, modelo, versión y conectividad. Si la cuenta o la vía de acceso no son las esperadas, corrígelo antes de enviar la tarea.
Una clave puede cambiar la vía de cobro
Comprueba qué acceso has autorizado
Una API es la vía por la que un programa utiliza un servicio. Una clave de API identifica ese acceso. Si tu equipo tiene configurada «ANTHROPIC_API_KEY» y apruebas utilizarla, Code puede facturar por consumo en vez de usar tu suscripción.
Comprueba el método con «/status». Si buscas usar tu plan, sigue la ayuda oficial sobre claves configuradas. No publiques la clave ni la pegues en una conversación de soporte.
Qué cambia con cada modo de permisos
Manual · default, alias manual
Cómo actúa: Permite lecturas y determinadas órdenes de lectura. Otras acciones piden permiso, salvo reglas previas.
Qué significa al empezar: Es el modo que recomendamos para el ejercicio; no pregunta por toda lectura.
Plan · plan
Cómo actúa: Analiza y prepara un plan. Puede ejecutar órdenes aprobadas por el clasificador cuando Auto está disponible.
Qué significa al empezar: No equivale a prohibir toda ejecución de herramientas.
Accept edits · acceptEdits
Cómo actúa: Aprueba ediciones y operaciones comunes de archivos.
Qué significa al empezar: Puede cambiar archivos sin preguntarte por cada edición.
Auto · auto
Cómo actúa: Un clasificador, otro sistema que evalúa acciones, revisa en segundo plano.
Qué significa al empezar: Reduce consultas; la revisión automática no sustituye tu revisión del resultado.
Don't ask · dontAsk
Cómo actúa: Permite lo autorizado y deniega lo que exigiría preguntar, con excepciones documentadas de extensiones.
Qué significa al empezar: Requiere una configuración técnica de permisos.
Bypass permissions · bypassPermissions
Cómo actúa: Omite comprobaciones de permisos, con las reglas y salvaguardas documentadas.
Qué significa al empezar: Se reserva a entornos aislados; queda fuera de esta primera prueba.
En terminal puedes cambiar de modo con Mayúsculas + Tab. Mira el indicador después: una sesión interactiva puede arrancar en Auto si está disponible, y los ajustes o las políticas pueden modificar el comportamiento.
Manual y aislamiento son controles distintos
Elegir una carpeta no encierra el programa en ella. Una orden que apruebes puede actuar con los derechos de tu usuario. El aislamiento de órdenes, llamado sandbox, añade restricciones de archivos y red: está disponible en macOS y WSL2, pero no en Windows nativo. Manual no lo activa por sí solo.
Por eso conviene leer la acción concreta antes de autorizarla. Si no entiendes una orden o alcanza algo ajeno al encargo, recházala y pide que explique qué necesita hacer. Una petición escrita limita el encargo; los permisos y la revisión controlan las acciones.
Del encargo al archivo revisado
- Carpeta ficticia
- Selecciona Manual
- Pide propuesta
- Aprueba el cambio
- Abre el archivo
Recorrido propuesto por Ciade para terminal o escritorio en Local. Antes de la aprobación, comprueba el nombre del archivo y el contenido previsto.
Envía tu primera tarea
En la sesión local, pega el encargo siguiente. HTML es el formato de una página web; aquí vas a pedir un archivo que podrás abrir en el navegador. Usa el mismo ejemplo ficticio tanto en terminal como en escritorio.
Quiero una página de prueba para una empresa ficticia de reparación de bicicletas.
Primero explícame qué archivo propones crear. No cambies nada todavía.
Después de mi aprobación, crea únicamente index.html en esta carpeta, con el
horario y los servicios inventados que yo te indique. Sin formularios, compras,
conexiones externas ni datos reales. No instales dependencias ni publiques nada.Cómo sabes que el ejercicio está bien
Comprueba la propuesta antes de crear
La propuesta debe limitarse a index.html dentro de la carpeta de prueba. Dale el horario y los servicios ficticios que quieres mostrar. Revisa las acciones que solicite y aprueba únicamente las que correspondan a ese encargo.
Abre el resultado
Cuando termine, localiza index.html y ábrelo con doble clic. Comprueba que el horario y los servicios coinciden con lo pedido y que no ha añadido formularios ni conexiones externas. Si hay algo que no sabes comprobar, pide apoyo técnico antes de reutilizarlo.
Decide antes de usarlo en el negocio
Abrir el archivo local no publica una web. Antes de trasladar el resultado a una web real, identifica quién revisará los cambios y quién podrá restaurar los archivos. Publicar requiere otra decisión y la comprobación del proyecto existente.
Si te atascas, comprueba el síntoma
No encuentra claude
Reabre la terminal. Si sigue igual, comprueba el ejecutable y PATH: la lista de carpetas donde busca programas. La instalación nativa usa «~/.local/bin/claude» en Mac y «%USERPROFILE%\.local\bin\claude.exe» en Windows.
Sigue la pestaña de tu sistema en la ayuda de instalación; evita pegar reparaciones destinadas a otro entorno.
PowerShell y CMD se han mezclado
Si «irm» no se reconoce, abre PowerShell: esa orden no es para CMD. Si PowerShell rechaza «&&», comprueba que no has pegado una orden destinada a CMD.
Vuelve a la pestaña Windows de esta guía y utiliza la orden de PowerShell.
El acceso no se completa
Si no se abre el navegador, pulsa «c» para copiar el enlace y ábrelo tú. Si aparece un código OAuth inválido, el código de autorización puede haber caducado o estar incompleto: repite el acceso.
Si aparece otra cuenta, revisa «/status», cierra sesión y vuelve a entrar con la correcta.
Error 403 o petición de mejorar el plan
Un 403 puede estar relacionado con el plan, los permisos de Console o el proxy, el intermediario de conexión de tu empresa. En escritorio, comprueba que has entrado con la cuenta de pago que incluye Code.
Consulta la ayuda de acceso. No atribuyas todo 403 al país ni desactives las protecciones de la empresa para continuar.
Se ha agotado el cupo
Escribe «/usage» dentro de la sesión para ver consumo y límites. Chat y Code comparten los cupos de la suscripción. Llegar al límite no significa que la instalación esté dañada.
Revisa la cuenta y el consumo antes de reinstalar o aceptar otra vía de cobro.
La descarga devuelve HTML o un aviso regional
La dirección ha devuelto una página web en vez del instalador. Lee el mensaje y comprueba la dirección y las condiciones de acceso antes de repetir la orden.
España figura en la lista vigente de acceso a Claude.
Después de la primera prueba
Para diagnosticar la instalación desde Terminal o PowerShell, utiliza «claude doctor». El instalador nativo se actualiza en segundo plano; «claude update» permite actualizar instalaciones compatibles. Si has elegido Homebrew o WinGet, gestores que instalan programas, mantén las actualizaciones por esa misma vía. La ayuda oficial de instalación y acceso reúne las reparaciones por sistema.
Los comandos que empiezan por «claude» se escriben en la terminal. «/status», «/usage» y «/help» se escriben dentro de Claude Code. Mantener esa diferencia evita confundir un problema de instalación con uno de la sesión.
Antes de incorporar documentos del negocio, revisa la cuenta y sus ajustes de privacidad. Instalar el cliente en tu equipo no instala el modelo ni hace que el procesamiento sea íntegramente local. Si quieres seguir con encargos, revisión y recuperación, el curso Claude Code a fondo desarrolla ese recorrido. Para conocer el resto del producto, consulta Claude.
Dudas sobre instalar Claude Code, respuestas cortas
¿Necesito una segunda suscripción para usar Code?
No. Una suscripción compatible da acceso a Code con sus cupos y Free no lo incluye. Cambiar de interfaz no añade otro cargo. Si ya tienes una suscripción, comprueba que has entrado con la misma cuenta antes de contratar otra.
¿Tengo que instalar WSL o Git para usarlo en Windows?
No. Puedes instalar el cliente nativo y utilizar PowerShell; WSL y Git for Windows son opcionales. Después de instalarlo, abre una ventana nueva de PowerShell y ejecuta «claude --version». Si devuelve un número de versión, el ordenador encuentra el programa; todavía falta iniciar sesión.
¿Puedo empezar desde la aplicación sin aprender órdenes?
Sí. Instala la aplicación oficial, entra, abre Code, elige Local y la carpeta de prueba, y revisa las diferencias antes de aprobar. Para usar además el comando claude en terminal, instala ese cliente aparte. Comprueba que el selector de permisos indique Manual antes de enviar el encargo.
¿La web puede usar directamente la carpeta de mi ordenador?
No automáticamente. El inicio documentado conecta un repositorio de GitHub y trabaja en la nube. Para empezar con un archivo de tu equipo, usa terminal o escritorio en Local. La pestaña «Web» de esta guía detalla ese recorrido con GitHub.
¿Puedo deshacer cualquier cambio si me equivoco?
No lo des por hecho. Los puntos de recuperación de Claude Code no sustituyen una copia independiente ni cubren todas las acciones externas o modificaciones de archivos. Empieza con material ficticio y conserva originales antes de trabajar con documentos existentes. Decide también quién podrá restaurarlos si algo falla.
Fuentes
Fuentes oficiales, consultadas el 2026-11-01
- Anthropic · Requisitos e instalación
- Anthropic · Guía de terminal para principiantes
- Anthropic · Primeros pasos
- Anthropic · Autenticación
- Anthropic · Modos de permisos
- Anthropic · Inicio en escritorio
- Anthropic · Inicio en nube y GitHub
- Anthropic · Países donde se puede acceder a Claude
- Anthropic · Planes y precios web
- Anthropic · Code con Pro, Max o Ultra
- Anthropic · Claves configuradas y facturación API
- Anthropic · Errores de instalación y acceso
- Anthropic · Diagnóstico y actualización
- Anthropic · Comandos de la sesión
- Anthropic · Seguridad y límites de permisos
- Anthropic · Puntos de recuperación
- Anthropic · Uso de datos
- Anthropic · Aislamiento de órdenes
- Anthropic · Code con Team y Enterprise
Cómo lo comprobamos. Instalación, cuentas, permisos y errores según documentación de Anthropic a 01-11-2026. Ciade usa Claude Code a diario desde España. El ejercicio del taller es ilustrativo. No hemos probado una instalación nueva en equipos limpios Mac y Windows para esta guía; las pantallas pueden variar.
Qué ha cambiado.
- 2026-11-01: Guía nueva: instalación en Mac y Windows, escritorio y web, cuenta necesaria, permisos, primera tarea local y errores de acceso.
Términos relacionados
Aprende a usar la IA en tu trabajo, con criterio.
El nivel 0 es gratis: cuarenta minutos para entender qué pedirle a la IA y qué revisar. El programa completo enseña a implementarla en tu propio negocio, tarea a tarea.
