Ir al contenido principal

Preguntas frecuentes de Claude Code

Respuestas breves a las preguntas más comunes en horarios de oficina, con un enlace para profundizar. Organizado según dónde estés en tus primeras semanas.

Cómo usar esta guía

Cinco secciones siguen el recorrido de las primeras semanas de un desarrollador: comenzar, uso diario, mejorar habilidades, errores comunes, privacidad y confianza. Revisa la sección que corresponda a tu situación o busca una pregunta específica.

1. Comenzar

Pregunta

Respuesta

1.1 ¿Cómo lo instalo?

Lo más fácil: descarga Claude Desktop, inicia sesión con tu plan y abre la pestaña «Code». Claude Code está integrado, así que no hay nada más que instalar.

Terminal:

macOS/Linux: curl -fsSL https://claude.ai/install.sh | bash
​Windows PowerShell: irm https://claude.ai/install.ps1 | iex
​Homebrew: brew install --cask claude-code
​WinGet: winget install Anthropic.ClaudeCode
Luego ejecuta claude desde cualquier repositorio.


Referencia: Inicio rápido

1.2 Instalado, pero «claude: command not found»

El instalador nativo coloca el binario en ~/.local/bin/claude (Windows: %USERPROFILE%\.local\bin). Añade ese directorio a tu PATH, por ejemplo export PATH="$PATH:$HOME/.local/bin" en ~/.zshrc o ~/.bashrc, luego reinicia tu terminal.

1.3 El inicio de sesión abre un navegador en la máquina equivocada / Estoy en SSH

Presiona c en el indicador de inicio de sesión para copiar la URL de autenticación. Ábrela en un navegador local y luego pega el código de vuelta en la terminal.

1.4 Errores de autenticación justo después de iniciar sesión, pero tengo acceso

400 «organization disabled»: una variable de entorno ANTHROPIC_API_KEY extraviada está anulando tu inicio de sesión. Desactívala, elimínala de tu perfil de shell y reinicia. Ejecuta /status para confirmar qué autenticación está activa.
​403 Forbidden: tu administrador aún no ha habilitado Claude Code para tu espacio de trabajo, o un proxy corporativo está interfiriendo.

1.5 ¿Claude Code está incluido en mi plan?

Sí. Está incluido con planes Claude pagos y con acceso a Console (API). Inicia sesión con tu cuenta de trabajo; SSO se maneja automáticamente. Un 403 después de iniciar sesión generalmente significa que tu administrador aún necesita habilitarlo para el espacio de trabajo.


Referencia: Autenticación

1.6 ¿Claude Code vs. chat en Claude?

Claude Code: un agente de codificación que lee tu repositorio, edita archivos y ejecuta comandos. Es la pestaña «Code» en Claude Desktop, y también se ejecuta en tu terminal o IDE.
​Chat en Claude (web, Claude Desktop o móvil): chat para conversaciones y preguntas puntuales.
Los mismos modelos subyacentes, forma diferente de herramienta.

1.7 ¿Funciona en mi IDE?

Sí. Hay extensiones disponibles para VS Code e IDEs de JetBrains (IntelliJ, PyCharm, etc.). Las mismas características, integradas en el editor en lugar de una terminal separada.


Referencia: VS Code · JetBrains

1.8 ¿En qué se diferencia de Copilot/Cursor autocomplete?

Autocomplete sugiere las siguientes líneas. Claude Code es un agente: dale una tarea («corrige las pruebas fallidas») y lee archivos, ejecuta comandos y realiza ediciones en múltiples archivos hasta terminar. Menos «completa mi frase,» más «aquí hay un problema, ve a trabajar en él.»

1.9 ¿Qué debería probar primero?

Apúntalo a un error tedioso pero no difícil que has estado posponiendo. Ejemplo: «la prueba en [archivo] es inestable, averigua por qué.» Déjalo leer el código en lugar de que tú expliques el código.

1.10 ¿Cómo lo actualizo?

Las instalaciones nativas se actualizan automáticamente en segundo plano. Para forzar una ahora, ejecuta claude update.
Homebrew/WinGet no se actualizan automáticamente: ejecuta brew upgrade claude-code o winget upgrade Anthropic.ClaudeCode periódicamente.


2. Uso diario

Pregunta

Respuesta

2.1 Sigue pidiendo permiso para los mismos comandos

Las aprobaciones duran la sesión actual por defecto. Para hacerlas persistentes:
• Elige «permitir siempre» en el indicador
• Añade el patrón a permissions.allow en .claude/settings.json
• O ejecuta /permissions para gestionar interactivamente


Referencia: Permisos

2.2 Modos de permiso y cómo cambiar

Presiona Shift+Tab para cambiar de modo:

  • auto · aprueba automáticamente con una verificación de seguridad en segundo plano. Disponible a menos que tu organización lo haya desactivado en la configuración administrada, en modelos compatibles.

  • manual · pregunta antes de ediciones o comandos arriesgados

  • acceptEdits · las ediciones de archivos se procesan; aún pregunta antes de ejecutar comandos

  • plan · solo lectura; propone un plan y espera aprobación


Referencia: Modos de permiso

2.3 ¿Qué es /init y cuándo lo ejecuto?

Ejecútalo una vez, al principio, en cualquier repositorio en el que trabajes más de una vez. Escanea el proyecto y escribe CLAUDE.md con comandos de compilación, arquitectura y convenciones. En cada sesión futura se carga automáticamente, para que Claude comience con contexto.

2.4 ¿Qué va en CLAUDE.md?

Cosas que las herramientas no pueden forzar y que un compañero nuevo cometería el primer día: «desplegar desde release, no desde main», «todos los IDs son strings», «nunca llamar a la BD directamente desde un manejador de ruta.» Mantenlo en menos de dos pantallas; lo más largo se hojea.

2.5 Claude no sigue mi CLAUDE.md

• Demasiado largo o vago: reduce a las reglas que realmente importan
• Enterrado en prosa: pon las reglas duras al principio, usa lenguaje imperativo («Nunca X. Siempre Y.»)


Referencia: Mejores prácticas

2.6 Apuntarlo a un archivo específico sin pegarlo

Escribe @ seguido de la ruta (se completa con tabulación). El archivo mencionado se lee antes de que Claude responda.

2.7 Pega una captura de pantalla en el prompt

Arrastra la imagen a la terminal, o presiona Ctrl+V. En Mac es Ctrl, no Cmd (Cmd+V pega texto). Funciona para diálogos de error, maquetas de UI, fotos de pizarra.

2.8 Copia la respuesta de Claude fuera de la terminal

/copy pone la última respuesta en tu portapapeles. /export escribe toda la conversación en un archivo.

2.9 Recupera una sesión anterior

claude --continue reanuda la más reciente. claude --resume abre una lista para elegir. Las sesiones se almacenan localmente por directorio de proyecto.

2.10 Cambiar modelos

/model abre el selector. Establece un predeterminado en .claude/settings.json si quieres el mismo modelo en cada sesión.

2.11 Pensamiento extendido

Activado por defecto. El razonamiento está oculto en la vista normal; presiona Ctrl+O para cambiar a la transcripción detallada si quieres leerlo. Usa /effort para ajustar la profundidad hacia arriba o abajo. Vale la latencia extra para depuración complicada o decisiones de arquitectura.

2.12 Detenerlo a mitad de tarea

Presiona Ctrl+C para cancelar la generación actual, luego dile qué hacer en su lugar. No necesitas reiniciar la conversación.


3. Mejorando

Pregunta

Respuesta

3.1 ¿Qué es MCP?

MCP conecta Claude Code a tus herramientas externas: GitHub, Linear, Slack, tu base de datos, tu stack de observabilidad. Una configuración .mcp.json y Claude puede leer tus problemas, consultar tus datos y usar las mismas herramientas que tú. Primer conector común: tu rastreador de problemas.


Referencia: MCP

3.2 Configura tu primer servidor MCP

• Añade un .mcp.json en la raíz del proyecto, o usa claude mcp add
• Cada entrada nombra un paquete de servidor más cualquier variable de entorno (generalmente un token de autenticación)
• Reinicia Claude Code y ejecuta /mcp para confirmar que está conectado

3.3 ¿Para qué sirven los hooks?

Scripts de shell que se ejecutan en eventos (antes de que se ejecute una herramienta, después de una edición de archivo, cuando Claude espera tu entrada). Primer hook común: un hook de Notificación que alerta tu escritorio cuando Claude necesita entrada. El mismo mecanismo puede ejecutar tu linter después de cada edición, publicar en Slack, o bloquear ediciones en rutas protegidas.


Referencia: Guía de hooks

3.4 Crea un prompt reutilizable / habilidad

Crea .claude/skills/ship/SKILL.md y el nombre de la carpeta se convierte en el comando: /ship. Inglés simple, sin sintaxis especial. Camino más fácil: pídele a Claude que lo escriba por ti. (La ruta heredada .claude/commands/ship.md aún funciona.)


Referencia: Habilidades

3.5 Habilidades vs. comandos heredados

Mismo mecanismo; los comandos se han fusionado en habilidades. .claude/commands/foo.md y .claude/skills/foo/SKILL.md ambos crean /foo. La forma de habilidad es preferida y te da una carpeta para archivos de apoyo (documentos de referencia, plantillas, scripts auxiliares).


Referencia: Habilidades

3.6 ¿Para qué sirven los suagentes?

Trabajo paralelo: buscar diferentes partes de la base de código, revisar un diff en dimensiones separadas, o generar implementaciones competidoras al mismo tiempo. La sesión principal agrega los resultados.


Referencia: Subagentes

3.7 Ejecutar de forma no interactiva (CI / scripts)

claude -p "tu prompt" se ejecuta una vez e imprime el resultado. Ideal para hooks de CI, comprobaciones previas a la confirmación o canalización hacia otras herramientas. Autenticación a través de tu sesión iniciada o ANTHROPIC_API_KEY.


Referencia: Uso estilo Unix

3.8 Deshacer lo que hizo

/rewind revierte a un punto de control anterior. Los puntos de control se crean automáticamente en cada prompt que envías. Para cualquier cosa ya confirmada, usa un git revert normal.


Referencia: Puntos de control

3.9 Comparte tu configuración con el equipo

Confirma .claude/ en el repositorio (CLAUDE.md, comandos, configuración de MCP). Cualquiera que clone el repositorio obtiene la misma configuración automáticamente. Las habilidades también se pueden empaquetar como un plugin que los equipos instalan mediante /plugin.


Referencia: Plugins


4. Errores comunes

Pregunta

Respuesta

4.1 No se encuentran archivos / la búsqueda no devuelve nada

Claude Code incluye una copia incluida de ripgrep, por lo que no necesitas instalarlo. El binario incluido puede fallar en sistemas Alpine/musl; en ese caso, instala una copia del sistema (apk add ripgrep) y establece USE_BUILTIN_RIPGREP=0 para que Claude la use en su lugar.

4.2 Copiar/pegar y desplazamiento rotos sobre SSH o en tmux

La interfaz de terminal captura eventos del ratón. Mantén presionada la tecla Mayús mientras seleccionas para omitirlo, o configura tmux para pasar eventos del ratón. /copy y /export evitan el problema por completo.

4.3 Lento en WSL

Leer archivos de Windows a través de /mnt/c/ es una penalización conocida. Mueve el repositorio al sistema de archivos de WSL (~/ en lugar de /mnt/c/...). La diferencia de velocidad es dramática.

4.4 El pegado de imágenes no funciona en Mac

Usa Ctrl+V, no Cmd+V. Cmd+V pega texto; Ctrl+V es la ruta de imagen desde el portapapeles.

4.5 La regla de permiso comodín no coincide

Construye reglas incrementalmente: aprueba comandos de forma interactiva primero, verifica qué se escribió en la configuración, luego generaliza.

4.6 El modo no interactivo -p se comporta de manera diferente

  • Los servidores MCP que necesitan OAuth no pueden solicitar en modo no interactivo

  • Las aprobaciones interactivas no se transfieren

Para ejecuciones no interactivas/CI, prefiere autenticación de clave de API y servidores MCP configurados con tokens de variables de entorno.

4.7 Se agotó el contexto a mitad de la tarea

/compact resume la conversación anterior para liberar espacio. /clear comienza de nuevo mientras mantiene CLAUDE.md y la configuración cargada. Para tareas largas, divide en pasos con un /clear entre fases.


5. Privacidad y confianza

Pregunta

Respuesta

5.1 ¿Anthropic entrena con mi código?

No. Según los términos de Equipo/Empresa de tu organización, tu código y conversaciones no se utilizan para entrenar modelos, a menos que tu organización haya elegido proporcionar sus datos para mejorar el modelo, como a través del Programa de Socio de Desarrollo. Si envías comentarios con /feedback, podemos usarlos para mejorar nuestros productos y servicios.


Referencia: Uso de datos

5.2 ¿Dónde va realmente mi código?

Claude Code se ejecuta en tu máquina. Los archivos fuente se leen localmente y solo las porciones necesarias para la tarea actual se envían a la API para generar una respuesta. Nada se indexa ni se carga como un repositorio completo. Tu código no se utiliza para entrenar a menos que tu organización haya elegido proporcionar sus datos para mejorar el modelo. Si envías un informe con /feedback o eliges compartir la transcripción de tu sesión después de una encuesta, esa conversación, incluido cualquier código en ella, se envía a Anthropic.


Referencia: Uso de datos

5.3 ¿Puede alguien más ver mis conversaciones?

Los compañeros de equipo no pueden abrir tus sesiones locales a menos que las compartas. Las sesiones locales se almacenan en tu máquina, por directorio de proyecto. Usa /export si quieres compartir una conversación. Tu empresa puede revisar tus sesiones. Las sesiones en la nube configuradas con visibilidad de Equipo, o iniciadas desde Slack, pueden ser visibles para otros miembros de tu organización.

5.4 ¿Cómo mantengo secretos y archivos .env fuera de la conversación?

Claude solo lee los archivos que necesita para la tarea; no escanea todo tu repositorio. Para bloquear específicamente archivos, añade una regla de denegación de Lectura en .claude/settings.json (por ejemplo, "Read(.env*)"). Los archivos denegados no se pueden leer ni siquiera si accidentalmente los solicitas.


Referencia: Permisos

5.5 ¿Qué puede hacer el modo «acceptEdits» sin preguntarme?

Las ediciones de archivos se realizan sin solicitud. Aún así pregunta antes de ejecutar comandos de shell, realizar llamadas de red o tocar cualquier cosa fuera de tu directorio de trabajo. Para un control más estricto, mantente en modo predeterminado.


Referencia: Permisos


Apéndice: ¿Aún atascado?

Recurso

Para qué sirve

/help

Comando integrado que lista lo disponible en tu sesión

/feedback

Reportar un problema desde la terminal (alias para /bug)

Todo aquí, en detalle

El canal #claude-code de tu equipo

Los pequeños logros y errores extraños tienen lugar allí


Apéndice: Directorio de recursos

Claude Code se actualiza frecuentemente. Verifica los detalles específicos de la versión en code.claude.com/docs antes de distribuir internamente.

¿Ha quedado contestada tu pregunta?