Cómo usar Claude Code: una guía sencilla para nuevos usuarios

Aprende a usar Claude Code de forma eficaz y a optimizar tu flujo de trabajo de desarrollo. Con la flexibilidad de conectar modelos de IA mediante API, Kimi API ayuda a mejorar la eficiencia al programar, comprender mejor el código y acelerar el desarrollo desde la idea hasta la implementación.

9 min. de lectura2026-07-13
Cómo usar Claude Code

Muchos desarrolladores que buscan cómo usar Claude Code se dan cuenta rápidamente de que poner la herramienta en marcha es mucho más fácil que usarla con eficacia. Trabajar con comandos de terminal, gestionar el contexto del proyecto, configurar API externas y navegar flujos de trabajo avanzados puede suponer una curva de aprendizaje pronunciada para los nuevos usuarios. Este artículo desglosa todo el proceso en pasos prácticos, para ayudarte a pasar de la configuración inicial a un uso diario productivo con más confianza y eficiencia.

¿Qué es Claude Code?

Claude Code es un asistente de programación con IA desarrollado por Anthropic que funciona directamente dentro de la terminal, lo que permite a los desarrolladores interactuar con su código mediante comandos en lenguaje natural. En lugar de limitarse a generar código, puede inspeccionar archivos, modificar implementaciones, ejecutar tareas de desarrollo y ayudar con la depuración en proyectos complejos. Su flujo de trabajo está diseñado para mantener a los desarrolladores dentro de su entorno habitual mientras acelera las actividades rutinarias de ingeniería.

¿Qué puedes hacer con Claude Code?

Aunque Claude Code se asocia principalmente con la ingeniería de software, sus capacidades van mucho más allá de escribir código. Desde la resolución de problemas técnicos hasta la optimización de flujos de trabajo, puede dar soporte a una amplia variedad de tareas profesionales y operativas.

  • Desarrollo de software y gestión de código

Claude Code ayuda a lo largo de todo el ciclo de vida del software al interpretar bases de código, explicar la arquitectura, identificar errores y mejorar la calidad de la implementación. También puede generar pruebas, refactorizar lógica existente y evaluar cambios antes del despliegue, haciendo que los flujos de trabajo de desarrollo sean más eficientes y fáciles de mantener.

  • Análisis de datos y automatización de flujos de trabajo

Más allá de la programación, Claude Code puede transformar conjuntos de datos sin procesar en información útil y automatizar procesos repetitivos. Da soporte a tareas como la generación de informes, el procesamiento de archivos, la organización de información y la coordinación de flujos de trabajo entre herramientas, reduciendo el esfuerzo manual en operaciones basadas en datos.

  • Administración de sistemas y operaciones técnicas

Claude Code ayuda a gestionar la infraestructura técnica al diagnosticar problemas de rendimiento, investigar errores y dar soporte a la configuración de entornos. También puede ayudar con contenedores, bases de datos, despliegues locales y otros componentes operativos que requieren supervisión continua.

  • Gestión de proyectos y operaciones de negocio

Los equipos pueden usar Claude Code para optimizar los flujos de trabajo organizacionales mediante la síntesis de información y la coordinación de tareas. Puede resumir discusiones, extraer prioridades, organizar actualizaciones de proyectos y destacar elementos accionables que ayudan a mantener el avance de las iniciativas.

  • Productividad personal y organización digital

Claude Code también puede mejorar la gestión digital diaria al estructurar archivos, optimizar la organización de directorios y simplificar tareas administrativas rutinarias. Su capacidad para automatizar flujos de trabajo personalizados lo convierte en un asistente práctico para mantener un espacio de trabajo más organizado.

¿Cómo usar Claude Code en Windows y Mac?

Empezar a usar Claude Code requiere solo unos pocos pasos de configuración antes de que puedas comenzar a interactuar con tus proyectos directamente desde la terminal. Ya sea que estés explorando cómo usar Claude Code o integrándolo en un flujo de trabajo profesional, el proceso de puesta en marcha está diseñado para ser sencillo. A continuación, cómo usar Claude Code de forma eficaz en Windows y Mac.

Paso 1: instalar Claude Code

Para instalar Claude Code, usa uno de los siguientes métodos:

macOS, Linux, WSL:

curl -fsSL https://claude.ai/install.sh | bash

Windows PowerShell:

irm https://claude.ai/install.ps1 | iex

Windows CMD:

curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

Una vez completada la instalación, verifica que Claude Code se haya instalado correctamente ejecutando claude --version. Los usuarios de Windows también pueden instalar Git for Windows, lo que puede mejorar la compatibilidad del shell y ofrecer una mejor experiencia de desarrollo.

Instalación de Claude Code

Paso 2: Inicia sesión en tu cuenta

Ve a cualquier directorio y ejecuta el comando claude para iniciar Claude Code por primera vez. Se te pedirá que inicies sesión y se abrirá automáticamente una ventana del navegador para la autenticación. Una vez que completes el proceso de inicio de sesión, tus credenciales se guardan localmente, lo que te permite acceder a Claude Code en futuras sesiones sin volver a iniciar sesión.

Inicio de sesión en la cuenta en Claude Code

Paso 3: Inicia tu primera sesión

Abre tu terminal en cualquier directorio de proyecto e inicia Claude Code:

cd /path/to/your/project claude

Después de iniciar Claude Code, la interfaz muestra la versión actual, el modelo seleccionado y el directorio del proyecto. Puedes escribir /help para explorar los comandos disponibles o /resume para reabrir una conversación anterior.

Paso 4: Haz tu primera pregunta

Después de iniciar una sesión, puedes interactuar con tu proyecto usando lenguaje natural. Claude Code lee automáticamente los archivos relevantes de tu espacio de trabajo, por lo que no es necesario que subas tu código manualmente.

Para tu primera interacción, prueba con una pregunta sencilla:

¿Qué hace este proyecto?

Claude Code analizará los archivos de tu proyecto y te dará un resumen del propósito, la estructura y los componentes principales de la aplicación.

También puedes hacer preguntas más específicas:

¿Qué tecnologías usa este proyecto?
¿Dónde está el punto de entrada principal?
Explica la estructura de carpetas.

Estas interacciones te ayudan a entender rápidamente una base de código desconocida y a comenzar a trabajar con Claude Code mediante comandos en lenguaje natural.

Inicio de la primera sesión en Claude Code

Una de las capacidades más potentes de Claude Code es su capacidad de trabajar con proveedores de IA externos mediante integraciones de API. Esto permite a los desarrolladores dirigir las solicitudes a modelos alternativos sin perder el flujo de trabajo basado en terminal, la ejecución de herramientas y las capacidades de gestión de proyectos de Claude Code. Por ejemplo, puedes configurar Claude Code para usar la Kimi API y acceder a las capacidades de codificación y agentes de Kimi directamente desde el entorno de Claude Code. A continuación, te explicamos cómo usar Claude Code vinculando APIs externas.

Integra la Kimi API en Claude Code

Sigue estos pasos para integrar la Kimi API en Claude Code.

Paso 1: Crea una clave de la Kimi API

Comienza iniciando sesión en la Plataforma abierta de Kimi y generando una clave de API desde la sección de gestión de API. Guarda la clave de forma segura, ya que se requerirá para la autenticación cuando Claude Code se comunique con la infraestructura de Kimi.

Obtén la clave de la Kimi API desde la consola

Paso 2: Configura la variable de entorno de Claude Code

Después de completar la instalación de Claude Code, configura las variables de entorno de la siguiente manera para usar el modelo kimi-k2.7-code e iniciar Claude.

MacOS y Linux

# Start the `kimi-k2.7-code` model on Linux/macOS export ANTHROPIC_BASE_URL=https://api.moonshot.ai/anthropic export ANTHROPIC_AUTH_TOKEN=${YOUR_MOONSHOT_API_KEY} export ANTHROPIC_MODEL=`kimi-k2.7-code` export ANTHROPIC_DEFAULT_OPUS_MODEL=`kimi-k2.7-code` export ANTHROPIC_DEFAULT_SONNET_MODEL=`kimi-k2.7-code` export ANTHROPIC_DEFAULT_HAIKU_MODEL=`kimi-k2.7-code` export CLAUDE_CODE_SUBAGENT_MODEL=`kimi-k2.7-code` export ENABLE_TOOL_SEARCH=false export CLAUDE_CODE_AUTO_COMPACT_WINDOW=262144 claude

Windows

# Start the `kimi-k2.7-code` model on Windows PowerShell $env:ANTHROPIC_BASE_URL="https://api.moonshot.ai/anthropic"; $env:ANTHROPIC_AUTH_TOKEN="YOUR_MOONSHOT_API_KEY" $env:ANTHROPIC_MODEL="`kimi-k2.7-code`" $env:ANTHROPIC_DEFAULT_OPUS_MODEL="`kimi-k2.7-code`" $env:ANTHROPIC_DEFAULT_SONNET_MODEL="`kimi-k2.7-code`" $env:ANTHROPIC_DEFAULT_HAIKU_MODEL="`kimi-k2.7-code`" $env:CLAUDE_CODE_SUBAGENT_MODEL="`kimi-k2.7-code`" $env:ENABLE_TOOL_SEARCH=false $env:CLAUDE_CODE_AUTO_COMPACT_WINDOW="262144" claude

Paso 3: Verifica la integración

Escribe /status en Claude Code para comprobar el estado del modelo:

Verificar la integración

Descubre las capacidades de razonamiento de kimi-k2.7-code en Claude Code

Después de configurar el modelo, presiona "Tab" para cambiar a la interfaz de Claude Code. Cuando el cambio se realice correctamente, verás el indicador "Thinking on", que significa que la capacidad de razonamiento extendido del modelo está activa.

Ventajas de usar la Kimi API

Aunque integrar Kimi con Claude Code amplía la disponibilidad de modelos, sus ventajas van más allá de la simple compatibilidad. Su estructura de precios, la flexibilidad de su ecosistema y el soporte para flujos de trabajo avanzados con agentes la convierten en una opción atractiva para los desarrolladores que crean aplicaciones asistidas por IA a gran escala.

  • Menor costo para flujos de trabajo de codificación y agentes de alta frecuencia

La Kimi API está diseñada para admitir patrones de uso intensivo sin generar costos operativos elevados. Esto la hace especialmente atractiva para equipos que ejecutan sesiones de codificación continuas, agentes autónomos o flujos de trabajo de desarrollo que generan grandes volúmenes de solicitudes de API.

  • Integración flexible con las pilas de desarrollo de IA existentes

En lugar de requerir una revisión completa de la infraestructura, la Kimi API funciona con estándares de API y frameworks de desarrollo ampliamente adoptados. Esta compatibilidad permite a los desarrolladores incorporar Kimi en sus flujos de trabajo establecidos, minimizando el esfuerzo de migración y la complejidad de implementación.

  • Comprensión multimodal y desarrollo con herramientas integradas

Kimi API va más allá de la generación de código tradicional al procesar múltiples formas de información dentro de un mismo flujo de trabajo. Su compatibilidad con contenido visual, documentación, datos estructurados y herramientas externas permite a los desarrolladores crear aplicaciones que operan con una mayor comprensión contextual.

  • Mejor adaptado para flujos de trabajo de codificación y agentes de larga duración Los proyectos de software complejos suelen requerir interacciones sostenidas a lo largo de numerosas tareas y archivos. Las capacidades de contexto extendido de Kimi API ayudan a mantener la continuidad durante sesiones de codificación prolongadas, permitiendo que los agentes gestionen dependencias, hagan seguimiento del progreso y ejecuten objetivos de varias etapas de forma más eficaz.

Comandos esenciales de Claude Code que debes probar

Una vez que domines lo básico, aprender algunos comandos clave de Claude Code puede hacer que el desarrollo diario sea mucho más fluido. Los siguientes comandos te ayudan a navegar entre sesiones, gestionar el contexto e interactuar con los proyectos de forma más eficiente sin interrumpir tu flujo de trabajo.

Comandos de shell

ComandoQué haceEjemplo
claudeIniciar el modo interactivoclaude
claude "tarea"Ejecutar una tarea puntualclaude "corrige el error de compilación"
claude -p "consulta"Ejecutar una consulta puntual y salirclaude -p "explica esta función"
claude -cContinuar la conversación más reciente en el directorio actualclaude -c
claude -rReanudar una conversación anteriorclaude -r

Comandos de sesión

ComandoQué haceEjemplo
/clearBorrar el historial de la conversación/clear
/helpMostrar los comandos disponibles/help
/exit or Ctrl+DSalir de Claude Code/exit

Consejos prácticos para principiantes al usar Claude Code

Ahora ya sabes cómo usar los agentes de Claude Code, pero algunos consejos pueden mejorar la calidad de las respuestas, reducir iteraciones innecesarias y ayudarte a obtener resultados más precisos.

  • Sé específico con tus solicitudes

Proporciona objetivos claros, contexto relevante y los resultados deseados siempre que sea posible. Las instrucciones detalladas permiten que Claude Code interprete los requisitos con mayor precisión, lo que da lugar a recomendaciones e implementaciones más alineadas con tus expectativas.

  • Usa instrucciones paso a paso

Divide los objetivos complejos en tareas más pequeñas y secuenciales en lugar de combinarlo todo en un solo prompt. Este enfoque estructurado permite que Claude Code se concentre en un problema a la vez, lo que genera resultados más confiables y facilita la validación del progreso.

  • Deja que Claude explore primero

Antes de solicitar modificaciones, pídele a Claude Code que inspeccione el proyecto y explique sus hallazgos. Permitir que analice primero el código base, la arquitectura y las dependencias suele generar sugerencias más informadas y reduce la probabilidad de cambios innecesarios.

  • Ahorra tiempo con atajos

Aprovecha los comandos integrados y las funciones de gestión de sesiones para agilizar las interacciones repetitivas. Atajos como /help, /resume y otros comandos de terminal pueden acelerar la navegación, conservar el contexto y mejorar la eficiencia general del flujo de trabajo.

Conclusión

En resumen, Claude Code ofrece una forma más eficiente de trabajar con código al combinar asistencia de IA, comprensión del proyecto y flujos de trabajo basados en terminal en un solo entorno. Con los pasos de configuración, comandos, integraciones y ejemplos prácticos que se cubren en esta guía, puedes empezar a usar Claude Code rápidamente en tu proceso de desarrollo diario. Para obtener más flexibilidad en la selección de modelos y ampliar las capacidades de Claude Code, integrar la Kimi API ofrece una opción adicional para los desarrolladores que buscan personalizar su flujo de trabajo impulsado por IA.

Preguntas frecuentes

¿Qué necesito antes de usar Claude Code?
Antes de empezar, necesitarás una cuenta de Claude, una suscripción compatible o un método de acceso a la API, y un entorno de desarrollo con Terminal o PowerShell disponible. Instalar Claude Code y contar con acceso básico a la línea de comandos suelen ser los únicos requisitos técnicos. Tener un directorio de proyecto listo también puede facilitar el proceso de puesta en marcha.
¿Pueden los principiantes usar Claude Code sin experiencia en programación?
Sí, los principiantes pueden usar Claude Code para explorar proyectos, entender código desconocido y aprender conceptos de desarrollo mediante conversaciones en lenguaje natural. Aunque cierto conocimiento técnico es útil, la herramienta puede explicar archivos, flujos de trabajo y lógica de programación en términos accesibles. Muchos usuarios la utilizan como un compañero de aprendizaje interactivo mientras desarrollan habilidades prácticas.
¿Puede Claude Code trabajar con Git y GitHub?
Claude Code puede ayudar con flujos de trabajo basados en Git al revisar cambios, explicar commits, resolver problemas relacionados con fusiones y ayudar a preparar código para su envío. Cuando se usa dentro de repositorios, puede analizar el historial del proyecto y guiar tareas de control de versiones. Esto lo convierte en un valioso compañero para el desarrollo de software colaborativo.
¿Cómo uso Claude Code para crear un proyecto?
Comienza abriendo una terminal en un directorio vacío e iniciando Claude Code en ese espacio de trabajo. Luego puedes describir la aplicación que quieres crear, incluyendo su funcionalidad, estructura y stack tecnológico. Claude Code puede generar archivos iniciales, sugerir decisiones de arquitectura y ayudar a desarrollar el proyecto de manera incremental mediante una interacción continua.
También le puede interesar
Cómo instalar OpenClaw en macOS, Linux y Windows
Cómo instalar OpenClaw en macOS, Linux y Windows
2026-07-13
Cómo instalar OpenClaw en Mac: guía paso a paso
Cómo instalar OpenClaw en Mac: guía paso a paso
2026-07-13
Cómo instalar Hermes Agent: guía de configuración para principiantes
Cómo instalar Hermes Agent: guía de configuración para principiantes
2026-07-13
Guía de integración de Hermes API: configuración y funcionamiento
Guía de integración de Hermes API: configuración y funcionamiento
2026-07-13
Cómo configurar la API de OpenCode con tu API de LLM
Cómo configurar la API de OpenCode con tu API de LLM
2026-07-13