Durante dos meses he querido escribir una guía para principiantes sobre CC, y hoy por fin puedo.
Claude Code (CC para abreviar) es el producto de IA que más recomiendo este año, sin duda.
Aunque se llame Claude Code, su funcionalidad va mucho más allá de escribir código; es un agente multiuso de verdad.
Muchas tareas tediosas en una computadora las puede manejar CC con una sola frase.
Lo uso para preguntas y respuestas, redacción, creación de sitios web, desarrollo de software, análisis de datos e incluso para dividir nóminas.
También puede ayudarme a combinar audio e imágenes en vídeos rápidamente.
Por amor a CC, incluso utilicé CC para escribir un lanzador de código abierto llamado Claude Code Now, que ya ha alcanzado las 400 estrellas en GitHub.
CC también es el software que hizo que el famoso investigador de OpenAI, AK, sintiera que se estaba quedando atrás.
Esta es una conversación entre el autor de CC y AK: ¡solo apuntas CC al objetivo y tus problemas se derriten!
He estado recomendando CC a colegas y amigos, y cada vez que lo usan, exclaman lo inteligente que es esta IA.
Sin embargo, CC no es tan fácil de recomendar porque el CEO de Anthropic es un poco despiadado...
Las suspensiones de cuentas son tan frecuentes —a veces tres veces al mes— que cuesta soportarlo.
Después de todo, los ingresos anuales de Claude Code son de mil millones de dólares; su CEO no parece preocuparse mucho por los usuarios en China.
Por eso, he estado esperando un momento: cuando las capacidades de codificación de los modelos open source nacionales superaran el umbral.
El lunes, mi amigo Yang Pan dijo emocionado en un grupo que ¡el momento ha llegado!
Ahora, por fin hay un modelo open source que se puede usar realmente dentro de Claude Code.
Por fin puedo escribir una guía para principiantes de Claude Code.
Un aviso: este artículo es bastante largo. Seguir los pasos tomará aproximadamente una hora, así que quizás quieras marcarlo.
Si tus amigos también quieren experimentar la IA más inteligente en una computadora, ¡no olvides reenviarles este artículo!
Guía de instalación de Claude Code
I. Preparación básica
- Prepara un entorno de red estable.
- Instala la última versión de Node.js aquí: https://nodejs.org/es/download/
- Los usuarios de Windows también deben instalar Git para Windows: https://git-scm.com/download/win
II. Iniciar la instalación de CC formalmente
- Busca «Terminal» en tu computadora y ábrelo. Se ve así: no tengas miedo, piensa que es una ventana de chat de IA con estilo.
- En la terminal, pega el siguiente comando y presiona Enter:
npm install -g @anthropic-ai/claude-code
Puedes encontrarte con varios errores aquí. Si ya has instalado otras herramientas de programación de IA como Cursor, te recomiendo encarecidamente instalarlo dentro de esas herramientas; ellas te ayudarán a resolver los problemas.
Si no tienes otras herramientas, puedes pedirle a cualquier IA que te ayude a solucionar los errores.
- Si el método 2 falla, prueba lo siguiente:
Si estás en macOS, Linux o WSL, pega este comando y presiona Enter:
Si estás en Windows, pega este comando y presiona Enter:
Una vez instalado, escribe claude --version. Si aparece un número de versión, la instalación fue exitosa.
La nueva versión de Claude Code añadió un molesto paso de verificación; podemos saltarlo con este método.
Añade el elemento de configuración "hasCompletedOnboarding": true en ~/.claude.json. Si el archivo no existe, créalo manualmente.
Debería verse así:
{ // ... otras configuraciones "hasCompletedOnboarding": true }
III. Adquirir un plan de servidor para CC
Como se mencionó, el CC oficial es implacable con las suspensiones, así que no recomiendo la suscripción oficial. Si puedes manejar la oficial, te admiro, pero probablemente no estarías leyendo esto.
Hay tres modelos nacionales con buen soporte para CC: GLM 4.7, MiniMax M2.1 y Kimi K2.
Aquí usaremos la configuración de GLM 4.7 como ejemplo. Como es un sitio nacional, es más fácil de usar. Los otros modelos tienen Planes de Codificación similares.
- Regístrate. Visita la Plataforma Abierta de Zhipu AI (https://open.bigmodel.cn/), haz clic en «Registrarse/Iniciar sesión» en la esquina superior derecha y sigue las instrucciones.
- Obtén una clave API. En el centro personal, haz clic en API Keys para crear una nueva y cópiala para usarla después.
- Suscríbete a un Plan de Codificación. Con un plan, puedes usarlo libremente sin preocuparte por problemas inesperados de saldo.
Actualmente hay una oferta de Año Nuevo: recomiendo encarecidamente el plan trimestral Coding Lite. Cuesta solo 54 RMB por tres meses, prácticamente regalado.
Puedes comprarlo aquí: https://www.bigmodel.cn/glm-coding?ic=KSGMCBOXUT
IV. Configurar el servidor de CC
Una vez que tengas el Plan de Codificación, puedes configurarlo.
Usaremos una nueva herramienta llamada Coding Tool Helper.
Esta herramienta facilita la importación de las configuraciones del servidor GLM en CC.
- Vuelve a la terminal, escribe el siguiente comando y presiona Enter:
npx @z_ai/coding-helper
- Verás una interfaz amigable en chino.
- Sigue las indicaciones de la herramienta, pega la clave API que obtuviste antes y completa los pasos uno por uno.
V. ¡Lanzar Claude Code!
🎉 Felicidades, has instalado la herramienta de IA más potente disponible. Toma un respiro.
Toma un poco de agua, ¡y luego lánzala!
Espera, ¿cómo se lanza?
En la terminal, solo escribe claude y presiona Enter. Verás la siguiente interfaz.
¡Saluda y preséntate!
A partir de ahora, este es tu asistente multiuso.
Puede que no estés acostumbrado a esta forma de abrirlo. No hay problema; puedes instalar el lanzador que escribí, Claude Code Now, en https://claudecodenow.com/
Después de instalarlo, podrás ver Claude Code en cualquier carpeta. Solo haz clic para lanzarlo: súper conveniente.
VI. Consejos de uso de Claude Code
Hay mucho que aprender con Claude Code.
Pero lo básico se reduce a tres cosas, centradas en entender cómo funciona CC.
Puedes pensar en CC como un agente que puede operar tu sistema. Puede ver tu computadora, leer archivos, operar archivos, analizar archivos y generar archivos.
Te comunicas con él mediante conversación natural; no necesitas escribir ni una línea de código.
- Carpetas
Las carpetas son el mejor concepto de diseño de CC; son el patio de juegos de CC.
Cuando CC se inicia, debes especificar una carpeta, que sirve como contexto para la tarea.
Recomiendo encarecidamente crear una carpeta dedicada para Claude Code para varios proyectos de CC.
A continuación se muestra mi carpeta de CC. La uso para notas, análisis de datos, lectura profunda y desarrollo de software. Cada tarea tiene su propia carpeta para que no interfieran entre sí.
Hay dos formas de especificar una carpeta: una es usando Claude Code Now como se mencionó anteriormente. La otra es arrastrar la carpeta a CC; la leerá automáticamente.
Los archivos funcionan igual: puedes arrastrarlos directamente a CC. Este es el primer consejo muy importante.
- El archivo Claude.md
El archivo Claude.md es el archivo de configuración principal de CC y su memoria a largo plazo.
Puedes pensar en este archivo como la constitución de CC.
Cada vez que CC se inicia, carga automáticamente este archivo, que registra lo que quieres hacer y las reglas que le has dado a CC.
También puedes hacer que CC cree este archivo por sí mismo y decirle qué información consideras importante.
- Modo peligroso
¿Qué es el modo peligroso?
Como su nombre indica, una vez activado, CC puede automatizar completamente tu computadora sin ninguna confirmación de tu parte.
Suena peligroso, pero si no lo activas, tienes que confirmar cada operación, lo cual es tedioso y mata la eficiencia.
Si usas Claude Code Now como lanzador, ya he activado el modo peligroso por ti.
Si no, puedes activarlo manualmente con este código:
claude --dangerously-skip-permissions
Sin embargo, una vez activado, CC podría causar daños irreparables, así que asegúrate de especificar la carpeta correcta y mantener copias de seguridad.
Ahora que hemos cubierto las tres cosas importantes, aquí hay un consejo muy práctico: Pegar imágenes.
Con CC, puedes preguntarle cualquier cosa. Pero algunas preguntas requieren imágenes. Debes pegar la imagen en CC.
Como CC se ejecuta en una terminal, el comando para pegar es diferente al predeterminado del sistema. No es Cmd+V, sino:
Control + V
Después de pegar, CC podrá ver la imagen.
VII. Un caso de uso real: Dividir nóminas
A continuación, demostremos un caso real que encontré en el trabajo para ver la magia de CC.
Como propietario de una empresa y contable, necesito pagar a todos cada mes.
Después de pagar, necesito enviar los recibos de nómina individuales.
Pero el agente solo me da una tabla de nóminas que se ve así:
Necesito dividir esta tabla, hacer un archivo separado para cada fila y enviarlo a cada persona.
Este tipo de trabajo repetitivo es muy molesto.
Pero con CC, solo le decimos nuestro requisito:
«Esta es una tabla de nóminas. Ayúdame a dividirla en recibos de nómina individuales, un archivo por persona.»
Grabé todo el proceso desde el inicio hasta la entrada del comando y la finalización, sin edición.
¡¿No es increíble?! ¡Esta tarea tediosa tomó solo 29 segundos en total!
Este es solo un pequeño caso; en realidad, hay decenas de miles de cosas que CC puede hacer.
La próxima vez que te encuentres con trabajo repetitivo, ¿por qué no abres CC y charlas con él?
VIII. Cargar habilidades: Flujos de trabajo empaquetados
Las habilidades son una característica importante lanzada recientemente para Claude Code.
Puedes pensar en una Habilidad como un flujo de trabajo que otros ya han probado y verificado; solo necesitas tomarlo prestado.
Puedes copiarlas de sitios web de habilidades existentes o hacer que CC las cree. Aquí está la guía oficial de habilidades: https://github.com/anthropics/skills
Usar habilidades es muy simple. Por ejemplo, acabo de ver una habilidad de diseño front-end compartida por el Sr. Liu Xiaopai (él es un dios de CC; puedes seguir su cuenta pública para más consejos).
Primero, instala la habilidad con una frase:
npx skills-installer install @anthropics/claude-code/frontend-design --client claude-code
Luego dile a CC:
Usa la habilidad @anthropics/skills/frontend-design para rediseñar la página de inicio de https://listenhub.ai
El resultado es muy elegante, evitando por completo el aspecto predeterminado azul-púrpura de las páginas web diseñadas por IA.
Conclusión: Cuando una ballena cae, todo florece
Con esto concluye la guía súper para principiantes de Claude Code.
Los pasos anteriores son solo el comienzo de tu viaje hacia el trabajo y el estudio inteligentes. Hay mucho más por aprender.
El primer paso es siempre el más difícil, y este artículo cubre esa parte. De ahora en adelante, si encuentras algún problema, solo pregúntale a CC, y te ayudará a resolverlo.
¡Creo que pronto encontrarás tu propio «momento ¡Guau!»!
Mientras termino de escribir, recuerdo una cena con Yang Pan donde discutimos la importancia del modelo GLM 4.7.
Anteriormente, Claude Code era un negocio de mil millones de dólares devorado por la ballena gigante que es Anthropic.
Ahora que los modelos open source nacionales se han puesto al día, esta es la igualdad técnica que tanto esperábamos.
Porque es open source, cualquier proveedor de nube puede implementarlo, venderlo y obtener ganancias.
Y lo que los usuarios obtienen es la conveniencia de la inteligencia a una centésima parte del precio.
Lo que estamos a punto de ver es la prosperidad de todo el ecosistema open source y la transformación de Vibe Coding de un juguete a una herramienta de producción.
La ballena gigante permanece,
Pero en las profundidades del mar,
Todo está creciendo.
