Glosario — Guía Práctica de Claude

A

Agente. Modelo de lenguaje en un bucle con herramientas: decide acciones (leer archivos, ejecutar comandos), observa los resultados e itera hasta completar la tarea. Claude Code es un agente de programación. Distinto de un chat, que solo produce texto.

Alucinación. Respuesta plausible pero falsa generada por un LLM: citas inventadas, funciones que no existen, datos incorrectos dichos con total seguridad. Se mitiga verificando hechos, dando fuentes propias al modelo o activando búsqueda web — nunca se elimina del todo.

Anthropic. Empresa fundada en 2021, creadora de Claude. Se define como empresa de seguridad en IA (AI safety); su técnica de entrenamiento más conocida es la IA constitucional.

API (Application Programming Interface). Interfaz para que programas hablen entre sí. La API de Anthropic permite que tu código mande requests a Claude y reciba respuestas, pagando por token consumido.

API key. Cadena secreta que identifica y autoriza tus requests a la API, asociada a tu facturación. Se crea en console.anthropic.com, vive en la variable de entorno ANTHROPIC_API_KEY y JAMÁS va dentro del código. Filtrada = revocada.

Artefacto. Contenido sustancial (documento, código, diagrama, mini-app) que claude.ai genera en un panel separado de la conversación, donde se puede iterar, editar y exportar.

B

Batches API. Endpoint (/v1/messages/batches) para procesar lotes de requests sin urgencia con 50% de descuento, con resultados en un máximo de 24 horas. Ideal para clasificación masiva, resúmenes nocturnos y todo lo que nadie espera en pantalla.

Búsqueda web. Función de claude.ai por la que Claude busca en internet y responde citando fuentes. Cubre el hueco del corte de conocimiento; las fuentes citadas igual se revisan.

C

Caching (prompt caching). Mecanismo de la API que guarda procesado el prefijo estable de un prompt (marcado con cache_control: {"type": "ephemeral"}). Las lecturas de caché cuestan ~0.1× del precio de entrada; las escrituras ~1.25×. Funciona por prefijo exacto: cualquier cambio al inicio lo invalida.

Claude. Familia de asistentes de IA de Anthropic basados en LLMs. A junio de 2026: Fable 5, Opus 4.8, Sonnet 4.6 y Haiku 4.5, en orden descendente de capacidad y precio.

Claude Code. Agente de programación de Anthropic. Corre en terminal, web, escritorio y como extensión de IDE; lee tu repositorio, edita archivos, ejecuta comandos y tests, hace commits. Se configura por proyecto con un archivo CLAUDE.md.

CLAUDE.md. Archivo en la raíz de un proyecto que Claude Code lee automáticamente al iniciar: comandos del proyecto, estructura, convenciones y advertencias. La "memoria persistente" del proyecto entre sesiones.

Cliente (SDK). Objeto que gestiona la comunicación con la API. En Python: client = anthropic.Anthropic() — lee la key del entorno y se reutiliza en todos los requests.

console.anthropic.com. La consola de desarrollador de Anthropic: creación y revocación de API keys, saldo, monitoreo de uso y gasto, límites.

Corte de conocimiento (knowledge cutoff). Fecha hasta la cual llegan los datos de entrenamiento de un modelo. De eventos posteriores no sabe nada — y puede alucinar si se le pregunta sin darle fuentes o búsqueda web.

D

Diff. Vista de las diferencias entre dos versiones de un archivo (líneas agregadas/eliminadas). Revisar el diff completo antes de aceptar cambios es el hábito central al trabajar con Claude Code.

E

Excepciones tipadas. Clases de error específicas del SDK (anthropic.AuthenticationError, anthropic.RateLimitError, anthropic.APIError...) que permiten capturar cada tipo de fallo por separado en lugar de inspeccionar códigos a mano.

I

IA constitucional (Constitutional AI). Técnica de entrenamiento de Anthropic: el modelo evalúa y corrige sus propias salidas contra un conjunto explícito de principios escritos (la "constitución"), en lugar de depender solo de calificaciones humanas masivas.

L

LLM (Large Language Model). Modelo de lenguaje grande: red neuronal entrenada con cantidades enormes de texto para predecir el siguiente token, de lo que emergen capacidades de conversación, escritura, código y razonamiento. Claude es un LLM.

M

max_tokens. Parámetro obligatorio de cada request: techo de tokens de la respuesta. Si la generación lo alcanza, se corta y stop_reason vale "max_tokens" — chequearlo evita publicar respuestas incompletas.

messages. Lista de mensajes que constituye la conversación en un request: diccionarios con role ("user" o "assistant") y content. Los roles alternan y el primero siempre es user.

Multi-turno. Conversación de varios intercambios. Como la API es stateless, el código del cliente acumula el historial en una lista y lo reenvía completo en cada request — esa lista ES la memoria del chat.

P

Prompt. El texto de entrada que se le da al modelo. Un prompt efectivo combina contexto, tarea, formato y restricciones.

Proyecto (claude.ai). Espacio de trabajo con instrucciones y archivos persistentes que se aplican a todas sus conversaciones — un system prompt persistente más una biblioteca de materiales. La herramienta clave del estudiante: un Proyecto por materia.

R

Rate limit. Límite de requests o tokens por minuto de una cuenta. Al excederlo, la API responde 429 con header retry-after; el SDK reintenta solo los errores transitorios (429/5xx).

Response. Objeto que devuelve la API: content (bloques de contenido), usage (tokens consumidos), stop_reason (por qué terminó) y model, entre otros.

S

SDK (Software Development Kit). Librería oficial que envuelve la API en funciones cómodas. En Python: pip install anthropic.

Stateless. Propiedad de la API: el servidor no recuerda nada entre requests. Cada llamada es independiente y solo "sabe" lo que va en su lista messages. La memoria de un chat la construye el código del cliente.

stop_reason. Campo del response que indica por qué terminó la generación: "end_turn" (natural), "max_tokens" (cortada por el límite), "tool_use" (quiere usar una herramienta), "refusal" (se negó por seguridad).

Streaming. Modo de respuesta en que los tokens llegan a medida que se generan (client.messages.stream(...) + stream.text_stream). Obligatorio para salidas largas (evita timeouts) y deseable en toda interfaz interactiva.

System prompt. Instrucciones de comportamiento (rol, tono, reglas) que se pasan en el parámetro system, separadas de la conversación y con mayor peso que los mensajes. Su equivalente en claude.ai son las instrucciones de Proyecto.

T

Token. Unidad en que el modelo procesa texto: fragmentos de palabras. En español, 1 palabra ≈ 1.3 tokens. Es la unidad de facturación de la API (precios por millón de tokens, entrada y salida por separado) y de medida de la ventana de contexto.

count_tokens. Endpoint gratuito (client.messages.count_tokens(...)) que cuenta los tokens exactos de un request antes de mandarlo. La herramienta correcta para presupuestar con Claude — no usar tiktoken, que es el tokenizador de OpenAI y cuenta mal.

U

usage. Campo del response con los tokens consumidos (input_tokens, output_tokens). Multiplicado por la tabla de precios, da el costo exacto del request — la base de toda la contabilidad de una app.

V

Variable de entorno. Valor de configuración que vive en el sistema operativo, fuera del código (p. ej. ANTHROPIC_API_KEY). El lugar correcto para los secretos: el código los lee del entorno y nunca los contiene.

Ventana de contexto. Cantidad máxima de tokens que el modelo puede tener presentes a la vez en una conversación (mensajes, respuestas, archivos). 1M de tokens en Fable 5, Opus 4.8 y Sonnet 4.6 (≈ 770,000 palabras, varias novelas); 200K en Haiku 4.5. No es memoria permanente.