Preguntas frecuentes de Claude Code

Pregunta

Respuesta

1.1 ¿Cómo lo instalo?

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.

Referencia: Solución de problemas: PATH

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, luego pega el código de vuelta en la terminal.

Referencia: Solución de problemas: autenticación

1.4 Errores de autenticación justo después del inicio de 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.

Referencia: Solución de problemas: autenticación

1.5 ¿Claude Code está incluido en mi plan?

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

Referencia: Autenticación

1.6 ¿Claude Code vs. aplicación de escritorio vs. claude.ai?

Claude Code: agente de terminal que lee tu repositorio, edita archivos, ejecuta comandos.
​Desktop / claude.ai: interfaces de chat para conversaciones y preguntas puntuales.
Misma familia de modelos subyacente, forma diferente de herramienta.

Referencia: Descripción general

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 oración", más "aquí hay un problema, ve a trabajar en él".

Referencia: Descripción general

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.

Referencia: Casos de uso comunes

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.

Referencia: Configuración: actualizaciones

Pregunta

Respuesta

2.1 Sigue pidiendo permiso para los mismos comandos

Las aprobaciones duran la sesión actual por defecto. Para hacerlas persistentes:
• Elige "siempre permitir" 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 ciclar modos:
• default · pregunta antes de ediciones o comandos arriesgados
• accept-edits · las ediciones de archivos se aplican; aún pregunta antes de ejecutar comandos
• plan · solo lectura; propone un plan y espera aprobación
• auto (si está habilitado por tu organización) · aprueba automáticamente con una verificación de seguridad en segundo plano

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. Cada sesión futura lo carga automáticamente, para que Claude comience con contexto.

Referencia: Memoria y CLAUDE.md

2.4 ¿Qué va en CLAUDE.md?

Cosas que las herramientas no pueden forzar y que un nuevo compañero de equipo 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 rutas". Mantenlo en menos de dos pantallas; lo más largo se hojea rápidamente.

Referencia: Memory y CLAUDE.md

2.5 Claude no está siguiendo mi CLAUDE.md

• Demasiado largo o demasiado vago: reduce a las reglas que realmente importan
• Enterrado en prosa: pon las reglas duras cerca del 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.

Referencia: Flujos de trabajo comunes

2.7 Pegar una captura de pantalla en el mensaje

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.

Referencia: Trabajar con imágenes

2.8 Copiar 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 Recuperar 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.

Referencia: Flujos de trabajo comunes: reanudar

2.10 Cambiar modelos

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

Referencia: Configuración de modelo

2.11 Pensamiento extendido

Activado por defecto; verás el razonamiento de Claude antes de respuestas más difíciles. Usa /effort para ajustar la profundidad hacia arriba o hacia abajo. Vale la pena la latencia extra para depuración complicada o decisiones de arquitectura.

Referencia: Pensamiento extendido

2.12 Detenerlo a mitad de tarea

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

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 trabajar con las mismas herramientas que usas. Primer conector común: tu rastreador de problemas.

Referencia: MCP

3.2 Configurar 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

Referencia: Configuración de MCP

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 está esperando 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 Hacer un comando reutilizable / comando de barra

Coloca un archivo markdown en .claude/commands/. El nombre del archivo se convierte en el comando: .claude/commands/ship.md se convierte en /ship. Inglés simple, sin sintaxis especial. Camino más fácil: pídele a Claude que lo escriba por ti.

Referencia: Comandos de barra

3.5 Habilidades vs. comandos de barra

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 te da una carpeta para archivos de apoyo (documentos de referencia, plantillas, scripts auxiliares).

Referencia: Habilidades

3.6 ¿Para qué sirven los subagenetes?

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: Subagenetes

3.7 Ejecutar sin interfaz (CI / scripts)

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

Referencia: Uso al estilo Unix

3.8 Deshacer lo que hizo

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

Referencia: Checkpointing

3.9 Comparte tu configuración con el equipo

Verifica .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 a través de /plugin.

Referencia: Plugins

Pregunta

Respuesta

4.1 No puedo encontrar archivos / la búsqueda no devuelve nada

Claude Code usa ripgrep bajo el capó. Si falta, la búsqueda se degrada. Instálalo (brew install ripgrep o apt install ripgrep) y establece USE_BUILTIN_RIPGREP=0 para usar la copia del sistema.

Referencia: Solución de problemas: búsqueda

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.

Referencia: Solución de problemas: WSL

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 interactivamente primero, verifica qué se escribió en la configuración, luego generaliza.

Referencia: Patrones de permisos

4.6 El modo sin interfaz -p se comporta diferente

• Los servidores MCP que necesitan OAuth no pueden solicitar en modo sin interfaz
• Las aprobaciones interactivas no se transfieren
Para modo sin interfaz/CI, prefiere autenticación con clave API y servidores MCP configurados con tokens de variables de entorno.

4.7 Se acabó 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.

Referencia: Gestión del contexto

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.

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, se carga como un repositorio completo, ni se utiliza para entrenar.

Referencia: Uso de datos

5.3 ¿Puede alguien más ver mis conversaciones?

No. Las sesiones se almacenan localmente en tu máquina, por directorio de proyecto, y no se comparten con compañeros de equipo ni son visibles en ningún panel. Usa /export si quieres compartir una conversación.

Referencia: Uso de datos

5.4 ¿Cómo mantengo los 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 archivos específicos, 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 "accept-edits" sin preguntarme?

Las ediciones de archivos se realizan sin solicitud. Aún así pregunta antes de ejecutar comandos de shell, hacer 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

Recurso

Para qué sirve

/help

Listado de comandos integrados de lo que está disponible en tu sesión

/bug

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

Documentación completa

Todo aquí, en detalle

El canal #claude-code de tu equipo

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

Página

Enlace

Inicio rápido

code.claude.com/docs/en/quickstart

Solución de problemas

code.claude.com/docs/en/troubleshooting

Permisos

code.claude.com/docs/en/permissions

Memoria y CLAUDE.md

code.claude.com/docs/en/memory

MCP

code.claude.com/docs/en/mcp

Uso de datos

code.claude.com/docs/en/data-usage