Para usar Claude Code de forma oficial necesitas tres pasos: un plan de pago, porque el plan gratuito no lo incluye, y el más barato es Pro a 20 dólares al mes o 17 dólares con facturación anual; después, el comando de instalación oficial de claude.ai para tu sistema; y por último, iniciar sesión desde el navegador en el primer arranque. Arabia Saudí está en la lista de regiones admitidas por Anthropic, así que no necesitas intermediarios ni una cuenta prestada. Después, instala el plugin Claude Code Setup desde el marketplace oficial para que lea tu proyecto y recomiende la configuración adecuada, sin cambiar ni un solo archivo.

¿Por qué precisamente la vía oficial?

La política de regiones admitidas de Anthropic dice que sus productos, incluidas las aplicaciones web, Claude Code y la API, solo están disponibles en los países de la lista, y Arabia Saudí figura en ella junto con los Emiratos Árabes Unidos, Kuwait, Catar, Baréin y Omán. La misma política considera no admitido el uso desde un país que no esté en la lista, aunque la cuenta pertenezca a una entidad admitida. Si estás en el Reino y usas tu propia cuenta, vas por buen camino, y no hay motivo para recurrir a atajos que pueden hacer que suspendan la cuenta.

Hay una segunda razón: el instalador oficial actualiza la herramienta automáticamente en segundo plano, así que las correcciones de seguridad te llegan en cuanto salen. Los plugins, en cambio, pueden ejecutar comandos automáticos y servidores de conexión externos en tu equipo, por lo que la documentación oficial aconseja leer los detalles de un plugin antes de instalarlo, y el lugar más seguro para empezar es el marketplace oficial de Anthropic.

¿Qué necesitas antes de instalar?

Según la página oficial de configuración, estos son los requisitos:

RequisitoDetalles
Sistema operativomacOS 13.0 o posterior, Windows 10 versión 1809 o posterior, Windows Server 2019, o Ubuntu 20.04, Debian 10 o Alpine 3.19 y posteriores
HardwareAl menos 4 GB de RAM y un procesador x64 o ARM64
RedUna conexión a internet que funcione
TerminalBash, Zsh, PowerShell o CMD
CuentaPro, Max, Team, Enterprise o una cuenta de Console

¿Cuánto cuesta Claude Code?

La herramienta se descarga gratis, pero para usarla necesitas una cuenta de pago. Estos son los planes tal como aparecen en la página oficial de precios:

PlanPrecio¿Incluye Claude Code?
FreeGratisNo
Pro20 dólares al mes, o 17 dólares al mes con facturación anual (200 dólares por adelantado)Sí
MaxDesde 100 dólares al mes, con cinco o veinte veces el uso de ProSí
Team y EnterprisePor puesto, con administración y facturación centralizadasSí

Para una persona, Pro basta para empezar. Para una empresa, la guía de autenticación recomienda Team o Enterprise, porque reúne la facturación y los permisos en un solo panel y permite imponer la misma configuración a todos los desarrolladores.

¿Cómo se instala Claude Code paso a paso?

Abre una terminal y pega el comando de tu sistema. Los comandos siguientes están copiados tal cual de la documentación oficial, y ninguno necesita permisos de administrador.

En Mac, Linux o WSL

curl -fsSL https://claude.ai/install.sh | bash

En Windows

En PowerShell, que reconoces por el PS delante de la ruta:

irm https://claude.ai/install.ps1 | iex

Y en CMD:

curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

La documentación recomienda instalar Git for Windows para que la herramienta pueda ejecutar comandos de Bash; sin él, funciona a través de PowerShell.

Con Homebrew o WinGet

También puedes instalar con brew install --cask claude-code en Mac, o winget install Anthropic.ClaudeCode en Windows. Ten en cuenta que estos dos métodos no actualizan la herramienta automáticamente, así que ejecutas tú el comando de actualización, y que la versión estable de Homebrew suele ir una semana por detrás de la última versión.

El instalador no muestra barra de progreso mientras descarga, así que no te preocupes si parece detenido. Cuando termine, abre una nueva ventana de terminal antes del siguiente paso.

¿Cómo inicias sesión con tu cuenta?

  1. Ve a la carpeta de tu proyecto en la terminal y escribe claude.
  2. La herramienta abre una ventana del navegador para iniciar sesión con tu cuenta de claude.ai. Si no se abre, pulsa c para copiar el enlace y pégalo en el navegador.
  3. Si el navegador muestra un código en lugar de redirigirte, pégalo en la terminal en la línea Paste code here if prompted. Suele pasar dentro de WSL2, sesiones SSH o contenedores.
  4. Cuando aparezca Login successful, pulsa Enter y empieza a trabajar.

Para cerrar sesión, escribe /logout dentro de la sesión. Si tienes una cuenta de trabajo y otra personal, la forma oficial es dar a cada cuenta su propia carpeta de configuración con la variable CLAUDE_CONFIG_DIR, como en este alias:

alias claude-work='CLAUDE_CONFIG_DIR=~/.claude-work claude'

¿Cómo compruebas que la instalación está bien?

claude --version
claude doctor

El primer comando muestra el número de versión, por ejemplo 2.1.211, y el segundo revisa la instalación y los archivos de configuración sin abrir una sesión, y muestra cada advertencia con su solución.

¿Qué es el plugin Claude Code Setup?

Claude Code Setup es un plugin oficial de Anthropic en el marketplace de plugins que analiza tu proyecto y recomienda las automatizaciones que le convienen. Lee archivos como package.json, la estructura de carpetas y el lenguaje de programación, y luego muestra la mejor sugerencia o las dos mejores en cada una de cinco categorías, como explica su repositorio oficial:

CategoríaQué haceEjemplo del plugin
Servidores MCPConectan la herramienta con servicios externoscontext7 para documentación, Playwright para probar el frontend
SkillsConocimiento empaquetado que se carga cuando hace faltaLas skills de planificación y de diseño de interfaces
HooksAcciones automáticas en cada ediciónFormatear el código automáticamente, bloquear archivos sensibles
SubagentesRevisores especializadosRevisión de seguridad, rendimiento y accesibilidad
Comandos de barraAtajos para tareas repetidas/test, /pr-review y /explain

Lo más importante es que es de solo lectura: sugiere y no cambia nada en tus archivos, así que la decisión sigue siendo tuya. Si le preguntas por una sola categoría, amplía a entre tres y cinco opciones.

¿Cómo instalas y usas el plugin Claude Code Setup?

  1. Ejecuta claude dentro de tu proyecto y escribe:
/plugin install claude-code-setup@claude-plugins-official
  1. Se abre el panel de detalles del plugin: qué añadirá, cuándo se actualizó por última vez y cuánto contexto usa. Léelo antes de aceptar.
  2. Elige el alcance de la instalación: para ti en todos tus proyectos, para todos los que trabajan en este repositorio, o solo para ti en este repositorio.
  3. Después de instalarlo, escribe una petición como recommend automations for this project, o pregunta: what hooks should I use?

La página oficial de plugins explica que el plugin puede necesitar una recarga con /reload-plugins si el resumen de instalación lo pide.

¿Cuáles son los errores de instalación más comunes y cómo se arreglan?

  • claude not found: la carpeta de instalación aún no está en tu PATH. Abre una nueva ventana de terminal y, si sigue, consulta la sección sobre cómo arreglar el PATH en la documentación.
  • The token '&&' is not a valid statement separator: estás en PowerShell usando el comando de CMD, así que usa el comando de PowerShell.
  • 'irm' is not recognized: al revés, estás en CMD usando el comando de PowerShell.
  • Plan gratuito: iniciar sesión con una cuenta gratuita no basta, porque Claude Code no está incluido en ella.
  • Versión antigua: si instalaste con Homebrew o WinGet, actualiza a mano con brew upgrade claude-code o winget upgrade Anthropic.ClaudeCode.

Y si no te gusta nada la línea de comandos, la aplicación de escritorio oficial te ofrece Claude Code con interfaz gráfica en Mac, Windows y Linux. Repasamos las últimas novedades de la herramienta en Novedades de Claude Code, agosto de 2026.

Fuentes