Claude Code CLI: Cómo Funciona el Agente Oficial de Anthropic en Terminal

En este artículo te explicamos de forma clara qué diferencia a Claude Code de un editor tradicional, cuánto cuesta realmente usarlo por API y cómo controlar tu gasto con el comando /compact.

1. ¿Qué Hace Diferente a Claude Code Frente a un Chat Normal?

Ejemplo fácil y sencillo: El mecánico que abre el capó por sí mismo

Usar ChatGPT en el navegador para arreglar una web es como llamar por teléfono a un mecánico y tratar de describirle con palabras un ruido raro del motor. En cambio, usar Claude Code en la terminal es dejar que el mecánico abra el capó directamente, mire las piezas, pruebe a arrancar y te diga: «Ya he visto qué tornillo estaba flojo en el archivo de pagos, ¿quieres que lo apriete ahora mismo?».

Por qué el archivo CLAUDE.md ahorra tiempo y dinero

La primera vez que abres Claude Code en una carpeta y ejecutas /init, la herramienta crea un pequeño archivo llamado CLAUDE.md. Ahí queda apuntado cómo se compila tu web, qué idioma usas y qué reglas debe respetar siempre, de modo que no tienes que repetírselo cada mañana.

2. Cuánto Cuesta Realmente y Cómo Ahorrar un 70% de Tokens

El comando /compact y el control con /cost

Como Claude Code se conecta directamente a la API de Anthropic (o a tu suscripción Max), cuantas más vueltas dé leyendo archivos grandes, más tokens consume. Para mantener el coste bajo control (normalmente entre 0,20 $ y 1,50 $ por sesión de trabajo intenso), acostúmbrate a escribir /compact cada vez que termines una tarea para limpiar la memoria y usa /cost para ver en tiempo real cuántos céntimos llevas gastados.

Tabla comparativa de datos reales en Código & Desarrollo

Para que tengas todas las cifras oficiales de un solo vistazo sin tener que buscar en diez páginas distintas, aquí tienes la comparativa actualizada:

3. Cómo Instalarlo en 1 Minuto

Requisito único: tener Node.js instalado

Basta con ejecutar npm install -g @anthropic-ai/claude-code en tu terminal, entrar en la carpeta de tu proyecto y escribir claude. Antes de modificar cualquier archivo o ejecutar un comando, siempre te pedirá permiso en pantalla.

Plantilla práctica verificada lista para copiar y probar sin errores

Hemos pre-rellenado esta plantilla con datos de ejemplo reales para que puedas probarla ahora mismo con un solo clic y comprobar que funciona a la primera sin dar ningún fallo:

# Reglas del Proyecto (Archivo CLAUDE.md listo para usar)

## 1. Comandos de Verificación
- Desarrollo local: `npm run dev`
- Comprobar errores de tipos y código: `npm run lint && npm run build`

## 2. Normas de Estilo y Seguridad
- Idioma: Todos los textos visibles para el usuario deben estar en español de España.
- Diseño: Asegura siempre que cada componente sea 100% adaptable a pantallas móviles (390px).
- Seguridad: Nunca escribas claves de API en el código; utiliza variables de entorno (`.env`).

## 3. Protocolo antes de Modificar Archivos
- Explica primero en 3 líneas qué archivos vas a tocar y por qué.
- Tras aplicar el cambio, verifica que la compilación termina sin errores.

4. Veredicto Final: Imprescindible para Mantenimiento y Refactorización

Ideal cuando necesitas tocar 15 archivos a la vez sin olvidar ninguno

Para pequeños cambios visuales un editor como Cursor o Windsurf es comodísimo, pero para renombrar funciones en 30 archivos, actualizar librerías antiguas o escribir tests automáticos, Claude Code brilla con luz propia.

5. Fuentes Oficiales y Herramientas Verificadas

Para profundizar directamente en la documentación técnica, comprobar tarifas en tiempo real o descargar las herramientas oficiales mencionadas en este estudio, consulta estos recursos de referencia:

6. Preguntas Frecuentes (FAQ)