Cómo instalar y configurar Claude Code, paso a paso

Conclusiones clave de ZDNET

  • La instalación de Claude Code es sencilla siempre que sigas unos sencillos pasos.
  • Los proyectos están delimitados por directorio, por lo que la ubicación de la configuración es importante.
  • Una configuración adecuada permite generar flujos de trabajo de desarrollo rápidos, estables y con agentes.

Claude Code ha estado causando sensación en el mundo del desarrollo. Recientemente usé el asistente de programación de Anthropic para crear una aplicación para iPhone compleja y bastante sofisticada de principio a fin.

Empecé usando Claude Code dentro de la función Code Intelligence de Apple en Xcode , pero descubrí que Code Intelligence tenía errores. Se bloqueaba o se bloqueaba con bastante frecuencia. Confirmé que era Code Intelligence, y no Claude Code, el causante de los problemas, ya que al intentar  usar Codex de OpenAI  en Code Intelligence, me encontré con el mismo comportamiento.

Cuando configuré Claude Code para que se ejecutara desde la terminal mediante la línea de comandos, todo se tranquilizó. Tuve una experiencia increíblemente productiva. De eso hablaremos en este artículo: cómo configurar Claude Code en la terminal y cómo hacerlo funcionar con Xcode.

No pienses que este artículo solo te será útil si planeas programar una app de Apple. Todo lo que voy a mostrarte también aplica a otras apps. Simplemente, mi proyecto es una app para iPhone, así que eso es lo que usaré en mis ejemplos.

Vamos a registrarte

El problema es que no se puede programar mucho con la versión gratuita de Claude. Necesitarás suscribirte al plan Pro (17 $ al mes) o al plan Max (desde 100 $ al mes). Recomiendo empezar con el plan Pro. Después de unas cinco horas, si decides que te gusta Claude Code, tendrás que cambiarte al plan Max, pero es bastante fácil.

Captura de pantalla de David Gewirtz/ZDNET

He descubierto que el plan Max te da mucho rendimiento. Lo he estado usando mucho este mes y aún no me ha cortado el servicio. Eso significa que Claude Code cuesta unos $100 al mes menos que Codex de OpenAI , que empieza en $200 al mes si te dedicas al desarrollo continuo.

A continuación, deberás conectarte a GitHub . Descubrí que, incluso si no quieres usar GitHub, necesitas conectarte.

Captura de pantalla de David Gewirtz/ZDNET

GitHub es una buena práctica que muchos desarrolladores usan, pero no todos los proyectos lo necesitan, especialmente si eres un desarrollador independiente. Así que, si ya tienes experiencia en GitHub, estás en el lugar correcto.

Si no usas GitHub, no intentes evitarlo. Registrarse en GitHub es gratis, al igual que crear repositorios. Claude tiene cierta ansiedad por separación. No avanzará con los pasos de configuración necesarios sin una conexión a GitHub totalmente autorizada. Por suerte, el proceso es prácticamente automático, así que sigue mis instrucciones y lo superarás fácilmente.

Tengo una cuenta de GitHub y varios repositorios, así que creé un nuevo repositorio y lo conecté. Primero deberás autorizar la conexión.

Captura de pantalla de David Gewirtz/ZDNET

A continuación, deberás conectar tus repositorios. Indica que estás instalando la aplicación Claude Code de GitHub, pero no es del todo exacto. Estás añadiendo algunos archivos de seguimiento. La instalación real se realizará más adelante.

Captura de pantalla de David Gewirtz/ZDNET

Ahora te preguntará dónde instalar Claude Code. Este es un cuadro de selección para todas tus cuentas de GitHub. Solo tienes que elegir tu cuenta. Como dije, la instalación real de Claude Code vendrá más adelante. Solo estás jugando para mantener al robot contento.

Captura de pantalla de David Gewirtz/ZDNET

Aquí hay otro. Esta vez, estás especificando el repositorio al que quieres conectar Claude Code. Estoy trabajando en un sistema de inventario de filamentos para bobinas de impresión 3D, así que el mío se llama «filamentory». Ese no es su nombre definitivo, pero funciona por ahora.

Captura de pantalla de David Gewirtz/ZDNET

Bien, ya tienes la conexión suficiente para empezar con la instalación real. Hagámoslo a continuación.

Instalar Claude Code en tu computadora

Claude Code se ejecuta en varios entornos de desarrollo, pero está diseñado y funciona mejor dentro de tu aplicación de terminal. Tenía algunas dudas, ya que no quería alternar entre mi terminal y mi IDE, pero resultó ser una forma muy sencilla y fluida de hacerlo.

Para comenzar, dirigiendo su navegador a la configuración de Claude, haciendo clic en el pequeño ícono de llaves (que se muestra en 1 a continuación) y luego en el enlace «Instrucciones de instalación aquí» (que se muestra en 2).

Captura de pantalla de David Gewirtz/ZDNET

A continuación, verás una línea de comandos. En mi caso, uso una Mac como equipo de desarrollo, así que elegí el entorno Mac. Selecciona la opción que mejor se adapte a tus necesidades, haz clic en ella y copia la línea de comandos.

Captura de pantalla de David Gewirtz/ZDNET

Pegue esto en su programa de terminal y presione Enter.

Captura de pantalla de David Gewirtz/ZDNET

Déjalo funcionar hasta que diga que está completo.

Captura de pantalla de David Gewirtz/ZDNET

Pero, por desgracia, no está del todo completo. Observe en la siguiente captura de pantalla que la línea de comandos original se muestra en el paso 1. En el paso 2, el instalador indica que se requiere un cambio de ruta. Muestra la línea de comandos para ello. Así que, en el paso 3, pegué esa línea de comandos y pulsé Enter.

Captura de pantalla de David Gewirtz/ZDNET

Ahora, Claude Code está instalado.

Empiece a codificar

Aquí está el gran secreto de usar Claude Code: todo funciona desde el directorio de trabajo actual. Por lo tanto, si tienes un proyecto en /a/b/c/proyecto1 y otro en /a/b/c/proyecto2, Claude, al ejecutarse en el proyecto1, no sabrá nada del proyecto2. Y Claude, al ejecutarse en el proyecto2, no sabrá nada del proyecto1.

Si tienes esto en cuenta y accedes al directorio correcto antes de iniciar Claude, todo irá bien. Así que hagámoslo. Mantengo mi carpeta «Desarrollo» en «Mis Documentos». Es una forma sencilla de asegurarme de que se detecte en todas las copias de seguridad, y funciona. Tengo una estructura de carpetas bastante completa, pero mi proyecto actual de iPhone se encuentra en una carpeta llamada «xcode».

Captura de pantalla de David Gewirtz/ZDNET

Lo primero que hago es ir a esa carpeta. Luego, ejecuto Claude escribiendo «claude» en la línea de comandos. Claude realizará una serie de pasos de inicio que se repetirán para cada nueva carpeta de proyecto que configures. Aquí, pregunta por el tema. Oscuro, por supuesto.

Captura de pantalla de David Gewirtz/ZDNET

A continuación, deberá conectarse a su suscripción. La mayoría de ustedes usarán la opción de suscripción, así que selecciónenla.

Captura de pantalla de David Gewirtz/ZDNET

A continuación, deberá autorizar el enlace.

Captura de pantalla de David Gewirtz/ZDNET

En este punto, Anthropic compartirá contigo los hechos de la vida. Presiona Enter para aceptar que nuestros amos robots son falibles.

Captura de pantalla de David Gewirtz/ZDNET

Te recomiendo encarecidamente que dejes que Claude Code use la configuración recomendada. Puedes cambiarla más tarde si lo deseas. Pero esta es la forma más sencilla de que todo funcione.

Captura de pantalla de David Gewirtz/ZDNET

Ahora, necesitas confirmar que estás en la carpeta correcta, que quieres trabajar en ella y que confías en su contenido. La confianza es efímera. En algún momento, tienes que confiar en algo, o estarás completamente sola (Lección de vida n.° 47 para mamás).

Captura de pantalla de David Gewirtz/ZDNET

Y ahora, estamos aquí.

Captura de pantalla de David Gewirtz/ZDNET

Puedes empezar a trabajar ahora, pero hay algunas cosas más que debes hacer para asegurarte de que todo esté configurado correctamente. Lo explicaremos a continuación.

Inicialización y primeros pasos

Claude Code utiliza varios comandos de barra que modifican su comportamiento. Incluso puedes añadir tus propios comandos de barra más adelante.

El primero que debes ejecutar es /init. Analizará tu carpeta, creará un archivo CLAUDE.MD  que puede usar como referencia y, en general, te familiarizará con tu código .

Captura de pantalla de David Gewirtz/ZDNET

Como puedes ver, he desarrollado una comprensión de lo que hay dentro de mi base de código.

Captura de pantalla de David Gewirtz/ZDNET

Mi carpeta no está impecable. Inicialmente creé el proyecto con Claude en Xcode con Code Intelligence. Ese proceso se documentó en este artículo . Así, a medida que Claude ejecuta su proceso /init, va familiarizándose con ese código.

Captura de pantalla de David Gewirtz/ZDNET

Finalmente, al completar el análisis, le asigné a Claude su primera tarea de agente. Quería que revisara el desorden que Code Intelligence había dejado y se asegurara de que no hubiera archivos ni instancias de código duplicados.

Captura de pantalla de David Gewirtz/ZDNET

Desde aquí, continué con el código de vibración para crear una aplicación para iPhone completamente funcional. Espero que esto te haya ayudado a empezar.

La nueva integración de Slack de Claude

Aquí les dejo una breve mención de otra forma de comunicarse con Claude Code: a través de Slack. Anthropic lo anunció hace unos días como avance de investigación.

Creo que es un enfoque interesante, pero me preocuparía escribir algo accidentalmente en Slack y que Claude se ponga furioso. Vale la pena considerarlo, pero no te dejes llevar por este modo de interacción hasta que investigues más. Probablemente sea mejor esperar a que la función salga de la versión beta.

¿Has probado Claude Code?

¿Y tú? ¿Ya has probado Claude Code, ya sea en un IDE o desde la terminal? De ser así, ¿cómo te fue en comparación con herramientas como OpenAI Codex o las funciones integradas de Code Intelligence? ¿Prefieres los asistentes de programación de IA integrados directamente en tu editor, o te parece más estable y productivo un flujo de trabajo de línea de comandos? ¿Y cómo influyen el precio, la fiabilidad y la dificultad de configuración en tu decisión de adoptar una herramienta como esta a largo plazo? Cuéntanoslo en los comentarios.

Deja un comentario