Fundamentos de Claude Code 101

10 ejemplos para empezar con Claude Code 101: 7 básicos y 3 intermedios.

Prerrequisitos

• Una terminal con la que te sientas cómodo trabajando y un directorio de proyecto en el que quieras que Claude Code trabaje.
• La CLI de Claude Code instalada en tu máquina (cubierto en el ejemplo 1 a continuación).
• Una cuenta de Anthropic con acceso a Claude Code, ya que la CLI necesita autenticarse antes de poder ejecutar una sesión.

Ejemplos Básicos

1. Instalar la CLI

Instala Claude Code desde tu terminal antes de hacer nada más.

npm install -g @anthropic-ai/claude-code

• La CLI se instala globalmente para que puedas lanzarla desde cualquier directorio de proyecto.
• La instalación es un paso único; después de esto, solo necesitas mantenerla actualizada ocasionalmente.
• Si npm no es tu gestor de paquetes preferido, consulta platform.claude.com/docs para ver las opciones de instalación actuales.

Relacionado: Instalar Claude Code y Conectar tu Primer Proyecto - el tutorial completo que este ejemplo resume.

2. Comprobar la versión instalada

Confirma que la CLI se instaló correctamente y ve qué versión estás ejecutando.

claude --version

• Un número de versión confirma que la instalación fue exitosa y que el comando claude está en tu PATH.
• Ejecuta esto de nuevo después de una actualización para confirmar que la nueva versión entró en vigor.
• Si el comando no se encuentra, es probable que el PATH de tu shell necesite incluir el directorio bin global de npm.

3. Iniciar el REPL en un proyecto

Inicia una sesión interactiva de Claude Code dentro del proyecto con el que necesitas ayuda.

cd ~/projects/my-app
claude

• Claude Code se inicia como un REPL: una sesión permanente donde escribes peticiones en lenguaje natural.
• Se orienta en el directorio actual, así que siempre haz cd en el proyecto primero.
• La sesión permanece abierta a través de múltiples peticiones hasta que la cierres.

Relacionado: Navegar por el REPL de Claude Code: Prompts y Comandos de Barra Diagonal - lo que puedes escribir una vez que la sesión esté abierta.

4. Darle tu primera petición en lenguaje natural

Escribe una instrucción en inglés plano en el prompt en lugar de escribir código tú mismo.

> Add a README.md that explains what this project does

• Claude Code lee el proyecto primero, luego planifica y escribe el archivo.
• No necesitas sintaxis especial; describe el resultado que deseas.
• Las peticiones vagas obtienen resultados vagos, así que nombra los detalles específicos (archivos, funciones, comportamiento) cuando puedas.

5. Revisar un cambio propuesto

Ve qué quiere cambiar Claude Code antes de que ocurra.

# Claude Code muestra una vista previa del estilo diff de la edición
# apruebas, editas la petición o la rechazas

• Revisar el diff es cómo detectas una petición mal entendida antes de que se convierta en una edición real.
• Si ves esta vista previa por defecto depende de tu modo de permisos.
• Trata las primeras sesiones en un proyecto nuevo como una oportunidad para generar confianza en sus planes.

Relacionado: Modos de Permiso Explicados: Aceptación Automática vs. Preguntar Siempre - controla si ves esta vista previa para cada acción.

6. Usar un comando de barra diagonal incorporado

Activa un comportamiento incorporado con una barra diagonal inicial en lugar de una petición en lenguaje natural.

> /init

• Los comandos de barra diagonal son distintos de las peticiones en lenguaje natural; la / inicial indica una acción incorporada.
• /init es un comando común al inicio en un proyecto nuevo, ya que permite a Claude Code construir contexto sobre la base de código.
• Existen otros comandos de barra diagonal para limpiar o compactar el contexto de la sesión.

7. Salir de la sesión limpiamente

Finaliza tu sesión de Claude Code cuando hayas terminado.

> /exit

• Salir limpiamente cierra la sesión REPL sin dejar trabajo en segundo plano en ejecución.
• Tus archivos de proyecto conservan cualquier cambio que ya haya sido aprobado durante la sesión.
• Siempre puedes reiniciar con claude desde el mismo directorio para continuar donde lo dejaste.

Ejemplos Intermedios

8. Establecer tu modo de permisos para una sesión

Elige si Claude Code pregunta antes de cada acción o procede por sí solo.

claude --permission-mode ask-every-time

• ask-every-time solicita aprobación antes de cada edición de archivo o comando de shell.
• Omitir el flag usa tu configuración por defecto, que puede ser de aceptación automática.
• Inicia proyectos nuevos o desconocidos con ask-every-time hasta que confíes en los planes del agente en esa base de código.

Relacionado: Modos de Permiso Explicados: Aceptación Automática vs. Preguntar Siempre - la comparación completa de ambos modos.

9. Investigar de forma segura con el Modo Plan primero

Deja que Claude Code investigue un cambio arriesgado o desconocido antes de que toque ningún archivo.

> /plan
> Investigate why the checkout flow fails intermittently and propose a fix

• En Modo Plan, Claude Code puede leer archivos y razonar sobre un enfoque, pero no puede realizar ediciones reales.
• Revisa el plan propuesto, luego cambia al modo de ejecución para que aplique la corrección.
• Este flujo de dos pasos es la forma más segura de delegar una tarea que aún no comprendes completamente.

Relacionado: Cambiar entre Modo Plan y Modo de Ejecución - el flujo completo para pasar de la investigación a las ediciones reales.

10. Encadenar una tarea de varios pasos a través de archivos

Dale a Claude Code una instrucción que requiera tocar varios archivos y ejecutar un comando.

> Rename getUserData to fetchUserProfile everywhere it's used, then run the test suite

• Una sola instrucción puede desencadenar la lectura de varios archivos, la edición de cada uso y la ejecución de un comando de shell para verificar el resultado.
• Este es el bucle del agente en la práctica: leer, planificar, actuar, verificar, todo desde una sola petición en lenguaje natural.
• Revisar el resumen que Claude Code reporta confirma que la suite de pruebas pasó realmente, no solo que los archivos cambiaron.

Relacionado: El Modelo Mental de Claude Code: Agente, No Autocompletado - por qué una instrucción puede desencadenar de forma segura un plan de varios pasos como este.

Versiones de la Pila: Escrito contra la línea de modelos de Claude actual a partir de ~junio de 2026 - Claude Fable 5, Claude Opus 4.8, Claude Sonnet 5 (el predeterminado), y Claude Haiku 4.5. Los nombres de los modelos, precios y características del producto cambian rápidamente; verifica los detalles actuales en platform.claude.com/docs antes de confiar en ellos.