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 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, 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 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. 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í. Las extensiones están 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 autocompletado?

El autocompletado 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 de 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 intentar 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:

Referencia: Modos de permisos

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: "implementar desde release, no desde main", "todos los IDs son cadenas", "nunca llamar a la BD directamente desde un manejador de rutas". Mantenlo bajo dos pantallas; lo más largo se hojea.

Referencia: Memoria y CLAUDE.md

2.5 Claude no sigue mi CLAUDE.md

• Demasiado largo o demasiado vago: reduce a las reglas que realmente importan
• Enterrado en prosa: coloca reglas duras cerca de la parte superior, usa lenguaje imperativo ("Nunca X. Siempre Y.")

Referencia: Mejores prácticas

2.6 Apúntalo 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 Pega una captura de pantalla en el indicador

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 Copia la respuesta de Claude fuera de la terminal

/copy coloca 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.

Referencia: Flujos de trabajo comunes: reanudar

2.10 Cambiar modelos

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

Referencia: Configuración de modelo

2.11 Pensamiento extendido

Activado por defecto. El razonamiento en sí está oculto en la vista normal; presiona Ctrl+O para cambiar a la transcripción detallada si deseas leerlo. Usa /effort para ajustar la profundidad hacia arriba o hacia abajo. Vale la pena la latencia adicional 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 comenzar la conversación de nuevo.

Pregunta

Respuesta

3.1 ¿Qué es MCP?

MCP conecta Claude Code a tus herramientas externas: GitHub, Linear, Slack, tu base de datos, tu pila 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 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

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 Crea un indicador 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é son buenos los subagenetes?

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

Referencia: Subagenetes

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, verificaciones previas a la confirmación o para canalizar 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 toman 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 a través de /plugin.

Referencia: Plugins

Pregunta

Respuesta

4.1 No se pueden encontrar 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.

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

Referencia: Patrones de permisos

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

Para ejecuciones no interactivas/CI, prefiere autenticación con 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.

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 o 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 deseas 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, agrega 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 pedirme permiso?

Las ediciones de archivos se realizan sin una 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 el modo predeterminado.

Referencia: Permisos

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)

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