Introducción a la documentación

La documentación de MoreContext es una referencia por temas para construir aplicaciones y agentes con modelos de lenguaje. Cada artículo responde a cuatro preguntas: qué es, cómo se usa, qué parámetros tiene y dónde suele fallar. Está pensada para consultarla con el editor abierto, no para leerla de principio a fin.

Documentación frente a roadmap

MoreContext tiene dos formas de contar lo mismo. Elige según lo que necesites ahora.

Cada artículo enlaza a las lecciones que enseñan su tema. Por ejemplo, Uso de herramientas remite a Function calling: el ciclo tool_use → tool_result. Si una tabla de parámetros te resulta opaca, la lección es el sitio donde se entiende.

Grupos

Convenciones del código

Todo el código de la documentación sigue las mismas reglas. Así puedes copiar un fragmento de un artículo y pegarlo junto a otro sin sorpresas.

• Implementación de referencia: la API de Mensajes de Anthropic. Los conceptos sirven con cualquier proveedor; los nombres de campos cambian.
• Python primero, con TypeScript en pestañas en el ejemplo central de cada artículo.
• Una constante MODEL al principio de cada archivo. Los nombres de modelo cambian con frecuencia; cámbialos en un solo sitio.
• La clave de API sale del entorno, nunca del código.
• Salidas inventadas se marcan con # salida de ejemplo en un bloque de texto. Lo demás es código que funciona.
• Se maneja siempre stop_reason. Ignorarlo es la causa más común de respuestas cortadas o bucles que no terminan.

Preparar el entorno

Necesitas una clave de API del proveedor y el SDK de tu lenguaje.

pip install anthropic
export ANTHROPIC_API_KEY="sk-ant-..."   # mejor en un .env que no subas al repositorio

npm install @anthropic-ai/sdk
export ANTHROPIC_API_KEY="sk-ant-..."

Comprueba que todo funciona con el mínimo posible:

import anthropic

MODEL = "claude-sonnet-5-5"
client = anthropic.Anthropic()  # lee ANTHROPIC_API_KEY del entorno

resp = client.messages.create(
    model=MODEL,
    max_tokens=64,
    messages=[{"role": "user", "content": "Responde solo: ok"}],
)
print(resp.content[0].text, resp.stop_reason)

import Anthropic from "@anthropic-ai/sdk";

const MODEL = "claude-sonnet-5-5";
const client = new Anthropic(); // lee ANTHROPIC_API_KEY del entorno

const resp = await client.messages.create({
  model: MODEL,
  max_tokens: 64,
  messages: [{ role: "user", content: "Responde solo: ok" }],
});
const first = resp.content[0];
if (first.type === "text") console.log(first.text, resp.stop_reason);

# salida de ejemplo
ok end_turn

Si ves un error de autenticación, la variable de entorno no está llegando al proceso. Si ves un error de modelo no encontrado, cambia MODEL por uno vigente según la documentación oficial.

Conceptos que se dan por sabidos

Los artículos usan estos términos sin volver a explicarlos. Si alguno no te suena, empieza por su entrada del glosario.

Cómo leer un artículo

Todos tienen la misma estructura para que encuentres rápido lo que buscas:

1. Definición en el primer párrafo.
2. Secciones de referencia: cómo funciona y qué opciones hay.
3. Ejemplo completo, ejecutable, con pestañas Python y TypeScript.
4. Tabla de parámetros o casos.
5. Errores frecuentes, con su causa y su arreglo.
6. Ver también: glosario, lecciones, recetas y sistemas relacionados.

Puedes enlazar a una sección concreta con su título, por ejemplo los errores de la primera llamada.

Ver también

• Tu primera llamada: anatomía de una petición y su respuesta.
• Nivel 00 · Fundamentos: el mismo terreno, enseñado paso a paso.
• Empieza aquí: rutas según tu punto de partida.
• Glosario: todos los términos.