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:
|
1.2 Instalado, pero «claude: command not found» | El instalador nativo coloca el binario en
|
1.3 El inicio de sesión abre un navegador en la máquina equivocada / Estoy en SSH | Presiona
|
1.4 Errores de autenticación justo después de iniciar sesión, pero tengo acceso | 400 «organization disabled»: una variable de entorno
|
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.
|
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.
|
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. |
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
|
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:
|
2.2 Modos de permiso y cómo cambiar | Presiona Shift+Tab para cambiar de modo:
|
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
|
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
|
2.5 Claude no sigue mi CLAUDE.md | • Demasiado largo o vago: reduce a las reglas que realmente importan
|
2.6 Apuntarlo a un archivo específico sin pegarlo | Escribe
|
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 |
|
2.9 Recupera una sesión anterior |
|
2.10 Cambiar modelos |
|
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
|
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
|
3.2 Configura tu primer servidor MCP | • Añade un
|
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.
|
3.4 Crea un prompt reutilizable / habilidad | Crea
|
3.5 Habilidades vs. comandos heredados | Mismo mecanismo; los comandos se han fusionado en 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.
|
3.7 Ejecutar de forma no interactiva (CI / scripts) |
|
3.8 Deshacer lo que hizo |
|
3.9 Comparte tu configuración con el equipo | Confirma
|
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 (
|
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. |
4.3 Lento en WSL | Leer archivos de Windows a través de
|
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 |
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 |
|
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
|
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
|
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 |
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
|
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.
|
Apéndice: ¿Aún atascado?
Recurso | Para qué sirve |
| Comando integrado que lista lo disponible en tu sesión |
| Reportar un problema desde la terminal (alias para |
Todo aquí, en detalle | |
El canal | Los pequeños logros y errores extraños tienen lugar allí |
Apéndice: Directorio de recursos
Página | Enlace |
Inicio rápido | |
Solución de problemas | |
Permisos | |
Memoria y CLAUDE.md | |
MCP | |
Uso de datos |
Claude Code se actualiza frecuentemente. Verifica los detalles específicos de la versión en code.claude.com/docs antes de distribuir internamente.
