Tu primera hora con Claude Code: De la configuración al primer diff

Comenzar tu camino con Claude Code marca un cambio en la forma en que interactúas con la terminal y tu código fuente. Esta herramienta de Anthropic, centrada en el desarrollador, no es solo un chat: es un agente de alta capacidad capaz de explorar archivos, ejecutar pruebas y realizar comandos dentro de tu entorno local. En esta guía, cubriremos tu primera hora con Claude Code, pasando desde la configuración inicial hasta la generación de tu primer diff.

Entendiendo el paradigma de Claude Code

Claude Code es una interfaz de línea de comandos que lleva las capacidades de razonamiento de Claude 3.5 Sonnet directamente a tu sistema de archivos local. A diferencia de las interfaces basadas en la web, esta herramienta opera donde vive tu código. Entiende el contexto de tu repositorio porque puede buscar activamente en tus directorios y leer el contenido de los archivos.

La propuesta de valor principal es la reducción del cambio de contexto. En lugar de copiar y pegar bloques de código en un navegador, invitas al agente a tu shell. Actúa como un colaborador que puede proponer cambios y explicar lógica compleja. Mientras otras herramientas como GitHub Copilot se enfocan en el autocompletado, Claude Code está diseñado para tener autonomía orientada a tareas.

Requisitos previos e instalación

Antes de comenzar, asegúrate de tener un entorno de terminal moderno y Node.js instalado. Claude Code se distribuye a través de npm, lo que lo hace accesible en Mac, Windows y Linux.

1. Abre la terminal de tu preferencia.
2. Ejecuta el comando para instalar el CLI de forma global: npm install -g @anthropic-ai/claude-code.
3. Una vez instalado, ejecuta claude para iniciar el proceso de autenticación.
4. Sigue las instrucciones del navegador para vincular tu cuenta de Anthropic.

Este proceso establece una conexión segura entre tu máquina local y la API de Anthropic. Si prefieres un entorno gestionado donde puedas organizar múltiples tareas, también puedes ejecutar estos comandos dentro de los terminals en un espacio de trabajo especializado.

Mejorando la experiencia con Deska

Aunque Claude Code funciona en cualquier terminal estándar, gestionar sesiones largas de agentes junto a tu editor puede volverse desordenado. Aquí es donde Deska ofrece una ventaja organizativa significativa.

Deska es una aplicación de escritorio local-first que proporciona un lienzo infinito para tus herramientas de desarrollo. En lugar de alternar pestañas entre una terminal y un IDE, puedes colocar un panel de terminal de Claude Code justo al lado de tu editor de código y un navegador. Este diseño visual ayuda a supervisar lo que el agente está haciendo en tiempo real.

Al usar coding agents dentro del entorno de Deska, mantienes una vista panorámica de todo tu proyecto. Puedes ejecutar Claude Code en un panel y usar Ask Deska para gestionar el espacio de trabajo, como abrir nuevos paneles de documentación o ajustar tu diseño.

Tus primeros comandos: Exploración

Una vez autenticado, navega al directorio de un proyecto y escribe claude. El primer paso de tu primera hora debe ser la exploración del código. En lugar de decirle al agente qué arreglar, pregúntale qué es lo que ve.

Comienza con un prompt general: ¿Cuál es la arquitectura de este proyecto?

Claude indexará la estructura de archivos y proporcionará un resumen de las tecnologías utilizadas. Podría identificar los puntos de entrada principales, el framework de pruebas y los modelos de datos. Esta fase es vital para verificar que el agente tiene los permisos correctos y puede leer tus archivos con precisión.

Refinando el contexto

Claude Code es potente, pero depende de instrucciones claras. Durante esta primera hora, practica el uso de los comandos /. Estas utilidades integradas te permiten gestionar el comportamiento del agente sin escribir prompts largos en lenguaje natural.

• /help: Muestra todos los comandos y atajos disponibles.
• /compact: Comprime el historial de conversación para ahorrar tokens.
• /review: Pide al agente que revise un archivo específico en busca de errores.
• /clear: Reinicia el contexto de la sesión actual si el agente se confunde.

Una parte clave de la gestión de data and storage es saber cuándo reiniciar. Si pasas de trabajar en una API de backend a un componente de frontend, limpiar el contexto ayuda al agente a mantenerse enfocado en los archivos relevantes.

Generando el primer diff

El punto culminante de tu primera hora es pasar de la exploración a la acción. Identifica una tarea pequeña, como añadir una nueva función de utilidad o corregir un error menor de CSS.

Proporciona un prompt específico: Añade una función auxiliar para formatear fechas en utils.js y luego actualiza el componente Header para usarla.

Claude Code analizará los archivos relevantes y propondrá una serie de cambios. Te mostrará un diff, que es una representación visual de lo que se añadirá o eliminará. Revisa este diff con cuidado. Si los cambios parecen correctos, puedes aprobarlos. El agente escribirá entonces los cambios directamente en tus archivos.

Esta manipulación directa de archivos es la razón por la que la privacy es tan importante. Dado que Claude Code y herramientas como Deska son local-first, tu código propietario se maneja con cuidado, y la lógica de la transformación ocurre a través de llamadas seguras a la API en lugar de subir todo tu repositorio a una nube de terceros.

Gestionando sesiones de forma remota

El desarrollo no siempre ocurre frente al escritorio. Si tienes una tarea larga iniciada por Claude Code, podrías necesitar alejarte. Deska ofrece una aplicación mobile que te permite supervisar estas sesiones. A través de un relevo seguro que empareja dispositivos directamente sin exponer puertos, puedes revisar el progreso de un agente o ejecutar un comando rápido para detener un proceso si algo sale mal.

Preguntas frecuentes

¿Cómo uso mis propias llaves de API con Claude Code?

Claude Code normalmente utiliza la facturación asociada a tu cuenta de Anthropic Console. Sin embargo, en Deska, puedes utilizar el modelo BYOK (trae tu propia llave) para varias herramientas y así gestionar tus costos directamente. Revisa el panel de settings para introducir tus credenciales.

¿Es Claude Code mejor que una extensión de IDE estándar?

Depende de tu flujo de trabajo. Las extensiones de IDE son excelentes para completar código en línea. Claude Code es una herramienta agentica, lo que significa que es más efectiva en tareas complejas que involucran múltiples archivos y ejecución en terminal. Muchos desarrolladores usan ambas aplicaciones lado a lado.

¿Puede Claude Code borrar mis archivos?

El agente requiere permiso para escribir cambios. Siempre revisa el plan que propone antes de presionar enter. Si ocurre un error, puedes usar tu sistema de control de versiones para revertir los cambios de inmediato.

Comienza con un mejor espacio de trabajo

Configurar Claude Code es el primer paso hacia un flujo de trabajo integrado con agentes. Para aprovechar al máximo estas herramientas, necesitas un entorno diseñado para la multitarea. Deska proporciona el lienzo infinito, la seguridad local-first y las herramientas auxiliares necesarias para mantener organizados a tus agentes de IA.

Descarga la aplicación gratuita para Mac, Windows o Linux y construye tu espacio de trabajo perfecto hoy mismo.

Descargar Deska