Source: https://aiprimetech.io/es/learn/use-claude-api-with-aider/ [Inicio](/es/) / [Aprende](/es/learn/) / Aider con Claude a través de una pasarela: ANTHROPIC_API_BASE, archivos de configuración, modo arquitecto y soluciones # Aider con Claude a través de una pasarela: ANTHROPIC_API_BASE, archivos de configuración, modo arquitecto y soluciones Aider envía todas las llamadas al modelo a través de LiteLLM, por lo que apuntarlo a una pasarela es un ajuste de LiteLLM y no de Aider. Para Claude, eso significa ANTHROPIC_API_BASE configurado con la raíz del host de la pasarela y un nombre de modelo con el prefijo anthropic/ . Hay otros dos ajustes menos evidentes que son igual de importantes: los identificadores de los modelos de Claude más recientes necesitan una entrada en la configuración del modelo; de lo contrario, Aider recurre a editar archivos completos sin un mapa del repositorio. ## Instalar Aider macOS / LinuxCopiar ``` python -m pip install aider-install aider-install # or the one-line installer (installs Python 3.12 if needed) curl -LsSf https://aider.chat/install.sh | sh ``` WindowsCopiar ``` powershell -ExecutionPolicy ByPass -c "irm https://aider.chat/install.ps1 | iex" ``` Si el comando aider no se encuentra después, algo habitual en Windows, python -m aider ejecuta el mismo programa. ## Conectar con Claude a través de la pasarela terminalCopiar ``` export ANTHROPIC_API_KEY=your_gateway_key export ANTHROPIC_API_BASE=https://aiprimetech.io aider --model anthropic/claude-sonnet-5 ``` WindowsCopiar ``` setx ANTHROPIC_API_KEY your_gateway_key setx ANTHROPIC_API_BASE https://aiprimetech.io # open a new terminal, then: aider --model anthropic/claude-sonnet-5 ``` Usa la raíz del host: sin /v1 y sin barra final. LiteLLM añade /v1/messages automáticamente, por lo que https://aiprimetech.io/v1 se convierte en /v1/v1/messages y devuelve 404, y una barra final produce una doble barra en la ruta. La documentación de Aider no cubre una URL base personalizada de Anthropic. LiteLLM lee la variable y comprueba ANTHROPIC_API_BASE primero y después ANTHROPIC_BASE_URL, la variable que utiliza Claude Code. Cualquiera de las dos funciona; si ambas están configuradas, ANTHROPIC_API_BASE tiene prioridad. Mantén el prefijo anthropic/ en el nombre del modelo. Sin un prefijo de proveedor, LiteLLM no sabe adónde enviar un nombre que no reconoce y falla con LLM Provider NOT provided. ## Guardar los ajustes en archivos de configuración Aider lee .aider.conf.yml y .env desde tu directorio personal, la raíz del repositorio git y el directorio actual, en ese orden, y los archivos posteriores tienen prioridad. Un archivo en el directorio personal se aplica a todos los proyectos. ~/.aider.conf.ymlCopiar ``` model: anthropic/claude-sonnet-5 weak-model: anthropic/claude-haiku-4-5 set-env: - ANTHROPIC_API_BASE=https://aiprimetech.io model-settings-file: ~/.aider.model.settings.yml model-metadata-file: ~/.aider.model.metadata.json ``` ~/.envCopiar ``` ANTHROPIC_API_KEY=your_gateway_key ``` weak-model gestiona los mensajes de commit y los resúmenes del historial de chat, por lo que usar ahí un modelo económico ahorra dinero en cada sesión. set-env copia la variable en el entorno antes de cualquier llamada al modelo, lo que evita tener que incluir la URL base en el perfil de tu shell. ## Mantener las ediciones mediante diff y el mapa del repositorio en los modelos más recientes Aider elige su formato de edición según el nombre del modelo. Los nombres que reconoce, incluidos los que contienen sonnet-4-, opus-4- o haiku-4-, reciben ediciones diff y el mapa del repositorio. Un nombre que no reconoce, como claude-sonnet-5, hace que recurra a reescribir archivos completos y omita el mapa del repositorio. Esto hace que las ediciones sean más lentas y costosas. Una entrada de configuración restablece el comportamiento correcto: ~/.aider.model.settings.ymlCopiar ``` - name: anthropic/claude-sonnet-5 edit_format: diff use_repo_map: true weak_model_name: anthropic/claude-haiku-4-5 - name: anthropic/claude-opus-5-5 edit_format: diff use_repo_map: true weak_model_name: anthropic/claude-haiku-4-5 editor_model_name: anthropic/claude-sonnet-5 editor_edit_format: editor-diff ``` Los modelos desconocidos también generan una advertencia: Unknown context window size and costs, using sane defaults. Es inofensiva, pero Aider asume entonces una ventana ilimitada y un precio de cero. El archivo de metadatos le proporciona valores reales: ~/.aider.model.metadata.jsonCopiar ``` { "anthropic/claude-sonnet-5": { "max_tokens": 64000, "max_input_tokens": 200000, "max_output_tokens": 64000, "input_cost_per_token": 0.000002, "output_cost_per_token": 0.00001, "litellm_provider": "anthropic", "mode": "chat" }, "anthropic/claude-opus-5-5": { "max_tokens": 64000, "max_input_tokens": 200000, "max_output_tokens": 64000, "input_cost_per_token": 0.000004, "output_cost_per_token": 0.00002, "litellm_provider": "anthropic", "mode": "chat" } } ``` Los precios son los precios de catálogo de Anthropic por token, por lo que el indicador de costes de Aider muestra el coste de catálogo; la pasarela factura menos. Un límite de entrada de 200K es un máximo de trabajo seguro, incluso cuando un modelo admite más. ## Modo arquitecto: planifica con un modelo y edita con otro terminalCopiar ``` aider --architect --model anthropic/claude-opus-5-5 --editor-model anthropic/claude-sonnet-5 ``` En el modo arquitecto, el modelo principal propone el cambio y el modelo editor lo convierte en modificaciones de archivos. Usar un modelo más potente para planificar y uno más económico para editar suele costar menos que utilizar el modelo potente para ambas tareas. Dentro de una sesión, /architect cambia a él para un solo mensaje y /chat-mode architect cambia para el resto de la sesión. ## La vía compatible con OpenAI La pasarela también admite el formato Chat Completions de OpenAI, que es la vía para los modelos GPT en la misma cuenta. En esta vía, la URL base sí incluye /v1, y el nombre del modelo lleva el openai/ prefijo: terminalCopiar ``` export OPENAI_API_KEY=your_gateway_key export OPENAI_API_BASE=https://aiprimetech.io/v1 aider --model openai/claude-sonnet-5 ``` Para Claude, es preferible la vía nativa anterior: los metadatos del modelo y el almacenamiento en caché de prompts se ajustan al formato de Anthropic. Si en tu entorno se ha configurado por error OPENAI_BASE_URL , LiteLLM lo utiliza con preferencia sobre OPENAI_API_BASE. ## 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. Los alias cortos de Aider (sonnet, opus, haiku) apuntan a identificadores de modelos antiguos, así que indica el nombre del modelo explícitamente. Los identificadores antiguos con fecha, como claude-3-5-sonnet-20241022 , no están disponibles. ## Resolución de problemas | Lo que ves | Causa | Solución | 404 / NotFoundError | /v1 en ANTHROPIC_API_BASE, por lo que la ruta pasa a ser /v1/v1/messages | Establece la raíz del host, https://aiprimetech.io, sin barra final | LLM Provider NOT provided | Nombre del modelo sin prefijo de proveedor | Usa anthropic/claude-sonnet-5 | AuthenticationError: no se ha podido autenticarte | Falta la clave en el shell donde se ejecuta Aider, o la clave corresponde a otro endpoint | echo $ANTHROPIC_API_KEY; en Windows, abre un terminal nuevo después de setx | Reescrituras de archivos completos, sin mapa del repositorio | Aider no reconoce el nombre del modelo | Añade la .aider.model.settings.yml entrada anterior | Unknown context window size and costs | No hay metadatos para el modelo | Añade el archivo de metadatos o ignora la advertencia | Errores de límite de tokens | Demasiados archivos en el chat o archivos demasiado grandes | /tokens para ver el consumo, /drop archivos, /clear historial | RateLimitError | Se ha alcanzado el límite de concurrencia o de solicitudes | Aider reintenta con esperas progresivas; evita ejecutar varias sesiones con una misma clave | Modelo no compatible | Un identificador de modelo antiguo o mal escrito | Usa un ID de la tabla anterior Para los errores que proceden del modelo y no de Aider, consulta [guía de errores de la API de Claude](/es/learn/claude-api-errors-troubleshooting/). ## Preguntas frecuentes ¿Cómo uso Aider con una URL base personalizada de Anthropic? Establece ANTHROPIC_API_BASE en la raíz del host de la pasarela, por ejemplo, https://aiprimetech.io, sin /v1 ni barra final, configura ANTHROPIC_API_KEY y ejecuta aider --model anthropic/claude-sonnet-5.. LiteLLM añade /v1/messages. ¿Aider lee ANTHROPIC_BASE_URL? Sí, a través de LiteLLM, como alternativa. LiteLLM comprueba primero ANTHROPIC_API_BASE y después ANTHROPIC_BASE_URL. ¿Por qué Aider reescribe archivos completos con un modelo nuevo de Claude? Aider no reconoce el nombre del modelo y recurre al formato de edición de archivos completos sin mapa del repositorio. Añade una entrada con edit_format: diff y use_repo_map: true a .aider.model.settings.yml. ¿Puede Aider utilizar un endpoint compatible con OpenAI? Sí: establece OPENAI_API_BASE en el endpoint incluyendo /v1 y configura OPENAI_API_KEY; después, utiliza el prefijo openai/, por ejemplo, aider --model openai/claude-sonnet-5. 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/)[Utiliza Claude con el SDK de OpenAI: endpoint compatible con OpenAI, streaming, herramientas y límites](/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/)[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/)[Hermes Agent con Claude a través de una pasarela: configuración de un proveedor personalizado, controles de costes y soluciones](/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/)[Codex CLI con un proveedor personalizado: config.toml, modelos GPT y Claude, extensión para IDE y soluciones](/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/)[GitHub Copilot Chat con Claude a través de una pasarela: configuración de Custom Endpoint, modo agente y soluciones](/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/)[SDK de Python de Anthropic: instalación, configuración de base_url, streaming y gestión de errores](/es/learn/anthropic-python-sdk/)[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/)