Claude Code, guía de referencia: instalación, suscripciones y API, comandos, CLAUDE.md, MCP, subagentes y buenas prácticas

Claude Code es el agente de desarrollo de Anthropic: trabaja con los archivos y las herramientas de un proyecto y puede encadenar análisis, modificaciones y comprobaciones. Para utilizarlo correctamente, elija la modalidad de facturación, instale el cliente, defina las instrucciones y los permisos, y revise los cambios antes de incorporarlos. Esta guía explica esa configuración y un método de trabajo que puede repetir, con información verificada el 24 de octubre de 2026.

Entender qué está instalando

Claude Code puede leer código, proponer cambios y utilizar un terminal para comprobarlos. Conviene distinguir entre el cliente instalado en su equipo y el servicio de modelos al que accede: tener el programa no significa disponer de un modelo que se ejecute localmente.

Su utilidad práctica está en la continuidad entre comprender el proyecto y actuar sobre él. Puede solicitar una corrección, obtener una modificación de archivos y ejecutar las comprobaciones pertinentes en la misma sesión. Para supervisar ese trabajo, debe saber reconocer un comando arriesgado, un cambio ajeno a la tarea o una prueba insuficiente.

El artículo Cómo trabajan los agentes de código explica este ciclo y sus límites. Aquí el objetivo es preparar un entorno cuyos resultados pueda revisar, en el que pueda retomar el trabajo y cuyos costes pueda explicar.

Antes de empezar, reúna estos requisitos:

• un terminal y un sistema compatible;
• una conexión a Internet y una cuenta autorizada para utilizar el servicio;
• un proyecto cuyos contenidos necesarios tenga derecho a transmitir;
• una copia de seguridad o un historial que permita recuperar el estado anterior;
• las herramientas de compilación y pruebas propias del proyecto.

Compruebe el último punto antes de continuar. Si la aplicación ya falla sin que haya intervenido el agente, conserve ese resultado inicial: le permitirá distinguir los problemas existentes de las regresiones introducidas durante el trabajo.

Elegir entre suscripción y API

El acceso individual mediante suscripción se ofrece, entre otras vías, a través de Claude. A fecha de 24 de octubre de 2026, la página oficial de precios muestra Pro a 20 dólares al mes con pago mensual, o 200 dólares facturados anualmente, con Claude Code incluido. Max parte de 100 dólares al mes. Estos importes no incluyen los impuestos aplicables y están sujetos a las condiciones y los límites de la oferta.

No interprete una suscripción como una garantía de capacidad para una carga de trabajo concreta: el uso depende de las tareas, del contexto y de los modelos disponibles. Que Claude Code esté incluido en un plan no significa que pueda utilizarlo sin límites.

Criterio	Suscripción individual	Facturación por API
Acceso	Cuenta con un plan compatible	Acceso a Claude Console configurado
Presupuesto	Importe recurrente, con límites de uso	Consumo facturado según las condiciones de la API
Comprobación previa	Plan y uso disponibles	Organización, facturación y acceso
Seguimiento	Uso de la suscripción y posibles cargos adicionales	Gastos y límites de la cuenta de API
Elección práctica	Trabajo interactivo dentro de los límites de una suscripción	Necesidad de llevar un seguimiento separado del consumo

Para comparar el coste de las distintas vías de acceso, mida tareas representativas. Registre el tiempo de ejecución, los intentos adicionales necesarios y el consumo que se muestra. El precio por token no basta para predecir cuánto costará completar una corrección.

Los créditos de API, los cargos adicionales y las ventajas vinculadas a determinadas ofertas tienen sus propias condiciones. Compruebe qué está activado en su cuenta antes de tratar un saldo de API como si formara parte de la cuota de su suscripción.

1. Instalar el cliente y comprobar que funciona

Los siguientes comandos proceden de la documentación oficial de instalación, consultada el 24 de octubre de 2026. Entre los requisitos, indica una conexión obligatoria a Internet y al menos 4 GB de memoria RAM. Consulte la lista de sistemas compatibles antes de instalarlo en un equipo antiguo o en una distribución particular.

En macOS, Linux o WSL:

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

En Windows PowerShell:

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

Estos comandos descargan y ejecutan un instalador. Utilice la dirección oficial y respete las reglas de su organización sobre la ejecución de scripts descargados.

A continuación, abra una nueva ventana de terminal y compruebe el cliente:

claude --version

La versión que aparece corresponde a su instalación real. Para resolver un problema, evite copiar un número de versión encontrado en un tutorial antiguo: anote el que obtiene en su equipo.

Según la documentación, la instalación nativa se actualiza automáticamente. Si trabaja en equipo, acuerden una política de actualizaciones y registren la versión cuando se produzca una incidencia reproducible. Una diferencia de comportamiento puede deberse al cliente, pero también a las instrucciones del repositorio, a los permisos o al servicio remoto.

Instale por separado las dependencias del proyecto. Que Claude Code se inicie no demuestra que funcionen el compilador, la base de datos de pruebas o el entorno de desarrollo.

2. Iniciar sesión y delimitar la primera tarea

Sitúese en el directorio del proyecto antes de iniciar el cliente. La referencia oficial de la línea de comandos documenta el inicio interactivo:

claude

Siga el proceso de inicio de sesión que se le indique. Para elegir expresamente una conexión a Claude Console con facturación por API, la documentación proporciona este comando:

claude auth login --console

Compruebe qué cuenta ha seleccionado antes de iniciar una tarea larga. En un equipo utilizado para varias organizaciones, una conexión técnicamente correcta puede seguir correspondiendo al entorno de facturación equivocado.

Empiece con una solicitud de observación, sin modificaciones. Por ejemplo:

Repérez le point d’entrée de l’application et les vérifications existantes.
Expliquez comment reproduire le problème décrit.
Ne modifiez aucun fichier.
Signalez les informations qui vous manquent.

Esta etapa sirve sobre todo para comprobar que usted y el agente entienden el proyecto de la misma manera. Revise las rutas citadas y pida que indique en qué archivos se basa cada conclusión relevante.

Después, defina un resultado observable: el comportamiento que debe corregirse, el alcance autorizado, las comprobaciones previstas y las acciones que necesitan validación. La guía Cómo trabajar con un agente de código desarrolla este método.

Para la primera intervención, elija una corrección acotada. Una migración general reúne demasiadas incertidumbres para distinguir rápidamente entre un problema de configuración y una interpretación incorrecta de la solicitud.

3. Utilizar los comandos en el lugar adecuado

Los comandos del terminal inician el programa o permiten retomar una sesión. Los comandos que empiezan por una barra se escriben dentro de Claude Code. La lista oficial de comandos interactivos es la referencia para comprobar cuáles están disponibles en su entorno.

Comando interactivo	Uso	Comprobación útil
/plan	Activar el modo de planificación antes de un cambio	Hipótesis y alcance propuestos
/init	Preparar las instrucciones del proyecto	Exactitud de las convenciones detectadas
/memory	Consultar y ajustar las instrucciones	Archivos que se tienen en cuenta
/permissions	Revisar las autorizaciones	Alcance de los permisos guardados
/context	Examinar la ocupación del contexto	Información que ya no resulta útil
/compact	Resumir la conversación	Restricciones que deben conservarse expresamente
/usage	Consultar el uso	Capacidad disponible antes de continuar
/mcp	Examinar las conexiones MCP	Servidores, autenticación y estado

Para continuar la conversación más reciente del directorio actual, ejecute en el terminal:

claude -c

Retomar una sesión permite mantener el hilo del trabajo, pero sigue siendo necesario comprobar qué ha cambiado desde la última vez. Un compañero puede haber modificado los archivos o una dependencia remota puede haber evolucionado.

Para una tarea nueva que no guarde relación con la anterior, es preferible abrir una sesión y aportar un breve resumen del estado del proyecto. Acumular solicitudes distintas dificulta identificar qué decisiones siguen vigentes.

Antes de comprimir el contexto, prepare un punto de recuperación: objetivo, archivos afectados, decisiones aceptadas, comprobaciones realizadas y problemas pendientes. Este documento también le servirá si necesita cambiar de sesión.

4. Escribir un CLAUDE.md breve y verificable

CLAUDE.md contiene instrucciones persistentes para el agente. La documentación sobre memoria e instrucciones distingue, entre otras cosas, las reglas compartidas del proyecto, en ./CLAUDE.md o ./.claude/CLAUDE.md, de las preferencias personales, en ~/.claude/CLAUDE.md.

Utilice /init para preparar una base y revísela después. Una convención deducida del código puede estar desactualizada, ser accidental o aplicarse únicamente a un subdirectorio.

Este ejemplo editorial sirve como punto de partida para adaptarlo:

# Règles de travail

- Avant de modifier, identifier le comportement attendu et son emplacement.
- Préserver les changements déjà présents dans le répertoire de travail.
- Utiliser les vérifications définies par le projet.
- Signaler une vérification impossible et sa cause.
- Demander une validation avant publication ou modification distante.
- Terminer par les fichiers modifiés, les tests et les limites restantes.

Añada los comandos propios del repositorio después de verificarlos. Una instrucción concreta, como la ruta de un conjunto de pruebas pertinente, resulta más útil que una petición general de calidad.

Evite incluir secretos, copias de documentación y reglas contradictorias. Los archivos de instrucciones aportan contexto, pero no constituyen una barrera de acceso. Una prohibición relativa a acciones sensibles también debe aplicarse mediante los permisos o el entorno.

Para proyectos grandes, la documentación contempla reglas en .claude/rules/. Distribúyalas por temas cuando eso facilite su mantenimiento. Si el repositorio ya contiene AGENTS.md, compruebe las reglas de carga actuales antes de duplicar las instrucciones: que ambos archivos coexistan no significa que se vayan a leer automáticamente juntos.

5. Ajustar los permisos antes de ampliar la autonomía

Una instrucción expresa su intención; un permiso determina las acciones que autoriza el cliente. La documentación de permisos describe reglas por herramienta y distintos modos de aprobación. Algunas autorizaciones pueden persistir: revise su alcance antes de elegir una opción que evite futuras solicitudes.

Aplique el principio de mínimo privilegio: empiece con los accesos necesarios para la tarea y amplíelos cuando aparezca una necesidad concreta. Una corrección local no justifica automáticamente el acceso a credenciales de producción o a permisos de publicación.

Cuando se proponga un comando, compruebe:

• los archivos y directorios afectados;
• si utiliza acceso a la red;
• las credenciales o variables que puede emplear;
• los efectos secundarios y si pueden revertirse.

No confunda el modo de planificación con un entorno de aislamiento completo. Para ejecutar código desconocido, prevea también protecciones en el sistema y en las cuentas utilizadas.

La guía para proteger los agentes de IA detalla estas medidas. En su procedimiento diario, separe claramente la preparación de la publicación: un cambio revisado puede estar listo para incorporarse al proyecto sin que eso autorice su publicación automática.

Evalúe también los scripts de pruebas. Su nombre no garantiza que sean inocuos: pueden instalar dependencias, contactar con servicios o modificar datos. Incluso un comando habitual debe ser comprensible en el contexto en el que se ejecutará.

6. Añadir MCP cuando exista una necesidad concreta

MCP permite conectar el agente con herramientas y fuentes externas. La documentación de MCP para Claude Code distingue, entre otros, los servidores remotos HTTP y los procesos locales que utilizan el transporte stdio.

Para mostrar la sintaxis sin imponer un servicio concreto, este es el ejemplo genérico oficial:

claude mcp add --transport http example https://mcp.example.com/mcp

La dirección es ilustrativa: sustitúyala por el punto de acceso oficial del servidor elegido. Después, examine la conexión con /mcp.

La configuración puede limitarse a su uso local, ser personal o compartirse con el proyecto. El ámbito del proyecto utiliza, entre otros archivos, .mcp.json. Revíselo antes de aceptarlo en un repositorio recibido de un tercero.

Elija un primer servidor que responda a una tarea concreta, como consultar una fuente de documentación autorizada. Compruebe quién lo publica, sus permisos, su autenticación y los datos que recibe. El directorio de servidores MCP ayuda a localizar las fichas; las instrucciones de instalación deben proceder del proveedor correspondiente.

Un documento devuelto por un servidor sigue siendo un dato externo. Puede contener una inyección de prompts, aunque la conexión funcione correctamente.

Establezca, por tanto, una regla sencilla: consultar una incidencia o un documento no autoriza a seguir las instrucciones que contenga para enviar secretos, modificar permisos o ejecutar un comando que no guarde relación con su solicitud.

7. Configurar subagentes especializados

Un subagente recibe una misión específica y trabaja con su propio contexto. La documentación oficial de subagentes contempla definiciones en .claude/agents/ para el proyecto y en ~/.claude/agents/ para el usuario.

Puede pedir a Claude que prepare una definición y revisarla después. Describa una misión, las herramientas autorizadas y el resultado esperado. Por ejemplo, un revisor puede buscar regresiones sin tener permiso para modificar archivos.

A fecha de 24 de octubre de 2026, la documentación precisa que /agents muestra un recordatorio que remite a Claude o a la edición de archivos. Por tanto, los tutoriales antiguos que presentan siempre un asistente interactivo ya no describen todos los clientes actuales.

La delegación resulta útil para tareas que se pueden separar: localizar una zona del código, analizar un fallo o buscar casos límite. Complica el trabajo cuando varios agentes modifican simultáneamente los mismos archivos.

Exija un informe que permita actuar: hallazgo, ubicación, evidencia e incertidumbre. Una opinión general sobre la calidad del código no permite decidir qué debe corregirse.

Un subagente también consume recursos. Compare su aportación con el trabajo adicional de coordinación: redactar instrucciones, esperar, leer el informe y resolver contradicciones. Empiece con una especialización clara antes de organizar varias tareas en paralelo.

Verificar el resultado y controlar el coste real

Solicite una modificación coherente y acotada, y examine el diff antes de añadir otra petición. Debe poder explicar la relación entre cada archivo modificado y el resultado esperado.

Organice la validación en torno al comportamiento:

1. constatar o reproducir el problema inicial;
2. comprobar el resultado después de la modificación;
3. revisar los comportamientos relacionados que puedan sufrir una regresión;
4. examinar las dependencias, los permisos y los datos que puedan verse afectados.

Una prueba superada aporta evidencia sobre aquello que comprueba. No demuestra que todo el cambio sea correcto. Del mismo modo, si una comprobación no puede realizarse, debe indicarse la causa y cómo afecta a la confianza en el resultado.

Para controlar los costes, reduzca sobre todo los intentos adicionales que se pueden evitar. Proporcione desde el principio un ejemplo de entrada, el resultado esperado y las restricciones esenciales. Pida una búsqueda específica antes de una exploración general del repositorio.

Registre también los intentos abandonados. Si una sesión repite la misma hipótesis sin aportar nuevas pruebas, debe reorientarse: resuma el fallo, solicite otra explicación y establezca una condición para detener el trabajo. Compare las soluciones con la misma tarea; nuestro directorio de agentes de IA ofrece las fichas necesarias para ampliar esa comparación.

Problemas frecuentes

El comando no se reconoce. Abra un terminal nuevo y compruebe la instalación y la ruta de búsqueda de ejecutables según la documentación. Reinstalar varias veces sin identificar el problema puede dificultar el diagnóstico.

La conexión utiliza la cuenta equivocada. Compruebe la organización y la modalidad de facturación antes de retomar el trabajo. Nunca comparta una clave o un código de acceso en un informe público de diagnóstico.

Parece que se ignoran las instrucciones. Consulte qué archivos se están teniendo en cuenta, busque contradicciones y simplifique las reglas. Sustituya una instrucción vaga por un resultado verificable.

Un servidor MCP sigue sin estar disponible. Distinga las posibles causas: punto de acceso incorrecto, autenticación, red o ausencia de un proceso local. Pruebe una conexión cada vez.

Los cambios abarcan demasiado. Interrumpa la tarea, examine el diff y reformule el alcance. Pida una justificación de los archivos inesperados antes de continuar.

Las pruebas siguen fallando. Compare el resultado con el estado inicial. Un entorno incompleto, un servicio ausente o la falta de datos de prueba requieren un diagnóstico distinto al de una regresión del código.

Lista de comprobación antes de conservar los cambios

• La cuenta, la organización y la facturación están identificadas.
• Se puede recuperar el estado inicial del proyecto.
• Las instrucciones describen reglas verificables.
• Los permisos corresponden a la tarea.
• Las conexiones externas responden a una necesidad explícita.
• Se ha revisado cada archivo modificado.
• Las comprobaciones cubren el comportamiento esperado.
• Se han registrado las pruebas que no pudieron realizarse y las incertidumbres.
• Se han examinado el consumo y los intentos adicionales.
• Cualquier publicación remota requiere una decisión explícita.

Páginas relacionadas

• Claude Code
• Claude
• Codex
• GitHub

Preguntas frecuentes

¿Claude Code funciona sin suscripción?

Puede utilizar la facturación por API mediante Claude Console en lugar de una suscripción individual. Esta opción requiere configurar el acceso y la facturación; instalar el programa no proporciona una reserva gratuita de capacidad de cómputo.

¿Se puede usar Claude Code sin saber manejar el terminal?

La documentación también ofrece una interfaz de escritorio. Sin embargo, para trabajar en un proyecto de software debe poder revisar los cambios, comprender los errores y comprobar el resultado, o encargar esa validación a una persona con los conocimientos necesarios.

¿Hay que incluir toda la documentación en CLAUDE.md?

Conserve principalmente las reglas que influyen en las decisiones del agente: restricciones, problemas conocidos y comprobaciones previstas. La documentación extensa se consulta cuando hace falta; incluirla en las instrucciones generales no garantiza que se aplique correctamente.

¿Un subagente puede garantizar una revisión independiente?

Aporta un contexto de trabajo separado, pero puede mantener los mismos puntos ciegos que el agente principal. Utilice su informe para orientar la revisión humana y las pruebas, sin considerarlo una certificación de los cambios.

¿Es necesario MCP para empezar?

No. Empiece con los archivos y las herramientas del proyecto, y añada una conexión cuando surja una necesidad concreta. Cada servidor adicional incorpora accesos, configuración y posibles fallos.