Source: https://aiprimetech.io/es/learn/anthropic-python-sdk/ [Inicio](/es/) / [Aprende](/es/learn/) / SDK de Python de Anthropic: instalar, configurar base_url, usar streaming y gestionar errores # SDK de Python de Anthropic: instalación, configuración de base_url, streaming y gestión de errores El anthropic es el paquete del cliente oficial de Python de Anthropic para la API de Claude. Gestiona la autenticación, los reintentos, el streaming y los errores tipados, y funciona sin modificaciones con cualquier endpoint compatible con Anthropic: configura base_url (o ANTHROPIC_BASE_URL) y el resto de tu código permanece igual. ## Instalación terminalCopiar ``` pip install anthropic ``` Las versiones 1.x funcionan con httpx2 y requieren Python 3.10 o posterior. Si proporcionas tu propio cliente HTTP, usa DefaultHttpxClient del SDK para conservar sus tiempos de espera y límites de conexión predeterminados. ## Crear un cliente app.pyCopiar ``` import anthropic client = anthropic.Anthropic( api_key="your_key", # default: ANTHROPIC_API_KEY base_url="https://aiprimetech.io", # default: ANTHROPIC_BASE_URL, else https://api.anthropic.com ) ``` base_url es la raíz del host. El SDK añade /v1/messages automáticamente, por lo que https://aiprimetech.io/v1 produciría /v1/v1/messages y un 404 page not found. Con ambas variables definidas en el entorno, anthropic.Anthropic() no necesita ningún argumento: terminalCopiar ``` export ANTHROPIC_API_KEY=your_key export ANTHROPIC_BASE_URL=https://aiprimetech.io ``` ## Enviar un mensaje app.pyCopiar ``` message = client.messages.create( model="claude-sonnet-5", max_tokens=1024, messages=[{"role": "user", "content": "Summarise TCP slow start in two sentences."}], ) for block in message.content: if block.type == "text": print(block.text) print(message.usage.input_tokens, message.usage.output_tokens) print(message._request_id) # log this with any failure report ``` content es una lista de bloques (texto, razonamiento, uso de herramientas), así que comprueba block.type en lugar de leer content[0].text a ciegas. ## Recibir respuestas en streaming stream.pyCopiar ``` with client.messages.stream( model="claude-sonnet-5", max_tokens=16000, messages=[{"role": "user", "content": "Write a short story about a lighthouse."}], ) as stream: for text in stream.text_stream: print(text, end="", flush=True) final = stream.get_final_message() ``` Usa streaming para cualquier solicitud con una entrada larga, una salida larga o un valor elevado de max_tokens: una solicitud sin streaming debe completarse dentro del tiempo de espera; una con streaming no. messages.create(..., stream=True) te proporciona el iterador de eventos sin procesar si no necesitas la función auxiliar. ## Cliente asíncrono async_app.pyCopiar ``` import asyncio, anthropic client = anthropic.AsyncAnthropic(base_url="https://aiprimetech.io") limit = asyncio.Semaphore(3) # stay within your key's concurrency async def ask(question: str) -> str: async with limit: msg = await client.messages.create( model="claude-haiku-4-5", max_tokens=512, messages=[{"role": "user", "content": question}], ) return next(b.text for b in msg.content if b.type == "text") async def main(): answers = await asyncio.gather(*(ask(q) for q in ["What is DNS?", "What is BGP?"])) print(answers) asyncio.run(main()) ``` El semáforo es importante. Lanzar cientos de solicitudes a la vez con asyncio.gather es la causa más habitual de los errores Concurrency limit exceeded que observamos en clientes de Python. ## Tiempos de espera y reintentos Valores predeterminados: un tiempo de espera de 10 minutos por solicitud y 2 reintentos automáticos con espera exponencial. El SDK reintenta los errores de conexión, 408, 409, 429 y las respuestas 5xx. Como también se reintentan las solicitudes cuyo tiempo de espera se agota, el tiempo total transcurrido en el peor caso es el tiempo de espera multiplicado por el número de intentos. app.pyCopiar ``` client = anthropic.Anthropic(base_url="https://aiprimetech.io", timeout=60.0, max_retries=4) # override for one call only client.with_options(timeout=300.0).messages.create( model="claude-opus-5-5", max_tokens=4000, messages=[{"role": "user", "content": "Review this design doc..."}], ) ``` ## Gestión de errores | Estado | Excepción | ¿Reintentar? | 400 | anthropic.BadRequestError | No: corrige la solicitud | 401 | anthropic.AuthenticationError | No: clave incorrecta o ausente | 403 | anthropic.PermissionDeniedError | No | 404 | anthropic.NotFoundError | No: ID del modelo o URL | 429 | anthropic.RateLimitError | Sí, tras una pausa | 5xx, incluido 529 por sobrecarga | anthropic.InternalServerError | Sí | Fallo de red | anthropic.APIConnectionError | Sí | Tiempo de espera agotado | anthropic.APITimeoutError | Sí, o usa streaming errors.pyCopiar ``` try: message = client.messages.create(model="claude-sonnet-5", max_tokens=1024, messages=[{"role": "user", "content": "Hi"}]) except anthropic.NotFoundError as e: print("Bad model ID or URL:", e.message) except anthropic.RateLimitError as e: print("Rate limited, retry after", e.response.headers.get("retry-after")) except anthropic.APIStatusError as e: print(e.status_code, e.type, e.message) except anthropic.APIConnectionError: print("Network problem") ``` Captura primero las clases específicas y APIStatusError al final; una captura genérica con except oculta la diferencia entre los errores que conviene reintentar y los que requieren un cambio en el código. e.type proporciona la cadena del tipo de error de la API, como rate_limit_error o overloaded_error. ## ID de modelos | ID del modelo | Úsalo para | claude-sonnet-5 | Opción predeterminada para programación y trabajo con agentes: rápida, potente y de precio intermedio. | claude-opus-5-5 | Razonamiento más complejo, refactorizaciones grandes y ejecuciones largas de agentes. | claude-fable-5-1 | El más capaz y el más caro; resérvalo para las tareas más difíciles. | claude-haiku-4-5 | Económico y rápido: títulos, resúmenes, clasificación y pasos pequeños. client.models.list() devuelve los modelos que ofrece un endpoint, para que puedas comprobar un ID antes de usarlo. Usa los ID exactamente como aparecen: sin sufijos de fecha. ## Resolución de problemas en una pasarela | Lo que ves | Causa | Solución | NotFoundError por 404 page not found | /v1 en base_url | Usa la raíz del host | AuthenticationError | La clave no está definida en el proceso o se ha pegado con espacios en blanco | Imprime len(os.environ["ANTHROPIC_API_KEY"]) | RateLimitError: Concurrency limit exceeded for user | Demasiadas solicitudes en curso | Un asyncio.Semaphore como el anterior | APITimeoutError en tareas largas | La solicitud sin streaming supera el tiempo de espera | Usa streaming o aumenta timeout | InternalServerError: No available accounts | Limitación temporal de capacidad del proveedor | Deja que el SDK reintente; aumenta max_retries | Insufficient account balance | Saldo agotado | [Recargar saldo](/es/topup/) Más información sobre los errores del modelo: la [guía de errores de la API de Claude](/es/learn/claude-api-errors-troubleshooting/). ## Preguntas frecuentes ¿Cómo instalo el SDK de Python de Anthropic? pip install anthropic. La versión 1.x requiere Python 3.10 o posterior. ¿Cómo configuro una URL base personalizada en el SDK de Python de Anthropic? Pasa base_url a anthropic.Anthropic() o define ANTHROPIC_BASE_URL. Usa la raíz del host; el SDK añade /v1/messages. ¿Cuáles son el tiempo de espera y los reintentos predeterminados? 10 minutos por solicitud y 2 reintentos con espera exponencial, que cubren errores de conexión, 408, 409, 429 y 5xx. ¿Cómo uso streaming con el SDK de Python? Usa with client.messages.stream(...) as stream: e itera sobre stream.text_stream; stream.get_final_message() devuelve el mensaje completo. Empieza a usar Claude en minutos Obtén una clave de API: no necesitas una cuenta de Anthropic ni estar en una lista de espera.[Obtén tu clave de API](/register) AI Prime Tech es una pasarela de API independiente. No está afiliada a Anthropic, no cuenta con su respaldo ni es un distribuidor de Anthropic. Claude y los nombres de los modelos relacionados son marcas comerciales de sus respectivos propietarios. ## Más guías de la API de Claude [Cómo obtener una clave de API de Claude](/es/learn/how-to-get-a-claude-api-key/)[Precios de la API de Claude, explicados](/es/learn/claude-api-pricing-explained/)[La forma más económica de usar la API de Claude](/es/learn/cheapest-way-to-use-claude-api/)[Cursor ilimitado con la API de Claude](/learn/use-claude-api-with-cursor/)[Acceso ilimitado a Claude Code](/es/learn/use-claude-api-with-claude-code/)[Gateway de la API de Claude frente al acceso directo a Anthropic](/es/learn/claude-api-vs-anthropic-direct/)[Usar Claude a través de una API compatible con OpenAI](/es/learn/openai-compatible-claude-api/)[Los modelos de Claude explicados: una comparación de Claude Opus, Sonnet, Haiku y Fable; todos los modelos de la API de Claude, nombres de modelos de Anthropic y precios (2026)](/es/learn/claude-api-models-compared/)[Pagar la API de Claude con criptomonedas](/es/learn/claude-api-with-crypto-payment/)[Acceso a la API de Claude sin lista de espera](/es/learn/claude-api-without-waitlist/)[Cómo reducir el uso de tokens de Claude](/es/learn/how-to-reduce-claude-token-usage/)[Cline ilimitado con la API de Claude](/es/learn/use-claude-api-with-cline/)[Roo Code ilimitado con la API de Claude](/es/learn/use-claude-api-with-roo-code/)[Claude ilimitado en los IDE de JetBrains](/es/learn/use-claude-api-with-jetbrains/)[Aider sin límites con la API de Claude](/es/learn/use-claude-api-with-aider/)[Claude ilimitado en VS Code](/es/learn/use-claude-api-with-vscode/)[Configuración de OpenCode para Claude: ajustes de opencode.json, modelos y errores comunes](/es/learn/use-claude-api-with-opencode/)[Ejecutar un agente Hermes sin límites con Claude](/es/learn/run-hermes-agent-with-claude-api/)[Ejecutar OpenClaw sin límites con Claude](/es/learn/run-openclaw-with-claude-api/)[Qué significa una API compatible con Anthropic](/es/learn/anthropic-compatible-api/)[Clave API de Claude Code — ANTHROPIC_API_KEY: cómo obtenerla, configurarla y cuándo usar claude setup-token en su lugar](/es/learn/claude-code-api-key-setup/)[Costes de la API de Claude Code: precios y cómo reducirlos](/es/learn/claude-code-api-costs/)[Explicación de los errores de la API de Claude: error del servidor 500, sobrecarga 529, límite de solicitudes 429, solicitud incorrecta 400 y la solución para cada uno](/es/learn/claude-api-errors-troubleshooting/)[Cómo comprar créditos para la API de Claude y por qué un crédito de Claude es mejor que cualquier oferta de «comprar una cuenta de Claude»](/es/learn/buy-claude-api-credits/)[API gratuita de Claude: ¿existe una clave API de Claude gratuita y qué es realmente gratis en 2026?](/es/learn/claude-api-free-trial/)[API de Claude frente a la suscripción Claude Pro/Max: cuál elegir](/es/learn/claude-api-vs-subscription/)[Ejecutar la CLI de Codex con Claude](/es/learn/use-claude-api-with-codex/)[Conectar Claude a n8n](/es/learn/use-claude-api-with-n8n/)[Enrutar LiteLLM a Claude](/es/learn/use-claude-api-with-litellm/)[Usar Claude en Kilo Code](/es/learn/use-claude-api-with-kilo-code/)[Integra Claude en GitHub Copilot](/es/learn/use-claude-api-with-github-copilot/)[Conecta Zed a Claude a través de la pasarela](/es/learn/use-claude-api-with-zed/)[Conecta Cherry Studio a Claude](/es/learn/use-claude-api-with-cherry-studio/)[ChatAnthropic en LangChain: importación, base_url, streaming, herramientas y errores](/es/learn/use-claude-api-with-langchain/)[Claude con Vercel AI SDK: baseURL de createAnthropic, streaming y soluciones](/es/learn/use-claude-api-with-vercel-ai-sdk/)[Ejecuta Factory Droid con Claude](/es/learn/use-claude-api-with-factory-droid/)[La API de Claude Code, explicada](/es/learn/claude-code-api/)[Integración de la API de Claude en tu aplicación](/es/learn/claude-api-integration/)[Cómo usar Claude sin límites y por qué no existe un «Claude Code crackeado»](/es/learn/get-unlimited-claude-usage/)