Por dos meses, he querido escribir una guía para principiantes sobre CC, y hoy por fin puedo hacerlo.
Claude Code (CC para abreviar) es el producto de IA que más recomiendo este año, sin duda alguna.
Aunque se llama Claude Code, su funcionalidad va mucho más allá de escribir código; es un Agente de propósito general de verdad.
Muchas tareas tediosas en una computadora pueden ser manejadas por CC con solo una frase.
Lo uso para preguntas y respuestas, escribir, crear páginas web, desarrollar software, análisis de datos e incluso dividir recibos de nómina.
Incluso puede ayudarme a sintetizar rápidamente audio e imágenes en videos.
Por amor a CC, hasta usé CC para escribir un lanzador de código abierto llamado Claude Code Now, que ya ha alcanzado 400 estrellas en GitHub.
CC es también 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 derrite tus problemas!
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 cuenta son tan frecuentes, a veces tres veces al mes, que es difícil de soportar.
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 de código abierto 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 de código abierto que se puede usar realmente dentro de Claude Code.
Por fin puedo escribir una guía para principiantes de Claude Code para novatos.
Un aviso amigable: este artículo es bastante largo. Seguir los pasos take alrededor de una hora, así que quizás quieras marcarlo primero.
Si tus amigos también quieren experimentar la IA más inteligente en una computadora, ¡asegúrate de 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/en/download/
- Los usuarios de Windows también necesitan instalar Git para Windows: https://git-scm.com/install/windows
II. Iniciar Formalmente la Instalación de CC
- Busca "Terminal" en tu computadora y ábrela. Se ve así: no temas, solo 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 encontrar varios errores aquí. Si ya has instalado otras herramientas de programación de IA como Cursor, recomiendo fuertemente 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, intenta 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 agregó un molesto paso de verificación; podemos saltarlo con este método.
Agrega el elemento de configuración "hasCompletedOnboarding": true a ~/.claude.json. Si el archivo no existe, créalo manualmente.
Debería verse así:
{ // ... otras configuraciones "hasCompletedOnboarding": true }
III. Comprar un Plan de Servidor de CC
Como se mencionó, el CC oficial es despiadado con las suspensiones, así que no recomiendo la suscripción oficial. Si puedes manejar el 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 web nacional, es más fácil de usar. 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 Claves API 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 Coding Lite trimestral. Cuesta solo 54 RMB por tres meses, prácticamente gratis.
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, ingresa el siguiente comando y presiona Enter:
npx @z_ai/coding-helper
- Verás una interfaz amigable en español.
- Sigue las instrucciones 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ánzalo!
Espera, ¿cómo se lanza?
En la terminal, simplemente escribe claude y presiona Enter. Verás la siguiente interfaz.
¡Saluda y preséntate!
Desde ahora, este es tu asistente multiusos.
Puede que no estés acostumbrado a esta forma de abrirlo. Está bien; puedes instalar el lanzador que escribí, Claude Code Now, en https://claudecodenow.com/
Después de la instalación, puedes 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 sola 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, necesitas especificar una carpeta, que sirve como contexto para la tarea.
Recomiendo enfáticamente crear una carpeta dedicada de Claude Code para varios proyectos de CC.
Esta es 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 de la misma manera: 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 Peligro
¿Qué es el Modo Peligro?
Como su nombre indica, una vez activado, CC puede automatizar completamente tu computadora sin ninguna confirmación tuya.
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 tu lanzador, ya he activado el Modo Peligro para 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 se cubrieron 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. Necesitas pegar la imagen en CC.
Debido a que 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 Recibos de Nómina
A continuación, demostremos un caso real que encontré en el trabajo para ver la magia de CC.
Como dueño de una empresa y contador, necesito pagar a todos cada mes.
Después de pagar, necesito enviar 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, simplemente 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. Habilidades de Carga: 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 frontend compartida por el Sr. Liu Xiaopai (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 principal de https://listenhub.ai
El resultado es muy profesional, evitando por completo el aspecto azul-morado predeterminado 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 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 aquí 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 Wow"!
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 de código abierto nacionales se han puesto al día, esta es la igualdad técnica que tanto esperábamos.
Porque es de código abierto, cada proveedor de la nube puede implementarlo, venderlo y obtener ganancias de él.
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 de código abierto 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.
