Source: https://aiprimetech.io/es/learn/use-claude-api-with-zed/

[Inicio](/es/) / [Aprende](/es/learn/) / Conecta Zed a Claude a través de la pasarela 

# Conecta Zed a Claude a través de la pasarela 

Zed es rápido y su asistente resulta realmente útil, pero la opción para configurar un endpoint personalizado de Claude no está donde la mayoría suele buscar primero. El proveedor nativo de Anthropic no permite cambiar la URL base, así que la vía más sencilla para acceder a la pasarela pasa por el bloque openai_compatible de Zed. 

## Por qué no usar el proveedor Anthropic 

Zed incluye un proveedor nativo de Anthropic, y lo más intuitivo es apuntarlo a la pasarela. El problema es que este proveedor no tiene un ajuste api_url, por lo que no hay ningún campo admitido que permita redirigirlo desde el host predeterminado de Anthropic. 

Esa única limitación explica por qué tanta gente se atasca. En lugar de intentar sortearla, puedes dirigir Claude a través del mecanismo genérico openai_compatible, que sí permite configurar la URL base y está diseñado precisamente para endpoints de terceros. 

Resulta útil pensar en el proveedor nativo como uno vinculado a un único destino, y en el proveedor openai_compatible como uno configurable. Para una pasarela multimodelo, la opción configurable es la más adecuada de todos modos, porque el mismo bloque puede dar acceso a Claude y a cualquier otro modelo que ofrezca la pasarela mediante una única api_url. Así, toda la configuración de modelos del editor queda en un solo lugar, en vez de repartirse entre dos mecanismos de proveedores con reglas distintas. Esa decisión determina el resto de la configuración, por lo que conviene tenerla clara antes de editar nada. Una vez que aceptas que el bloque openai_compatible es la vía admitida, el resto consiste simplemente en rellenar los campos. 

## Añade un bloque openai_compatible 

En settings.json, dentro de language_models.openai_compatible, añade un proveedor con nombre. Establece su api_url en la dirección de la pasarela con /v1 al final; Zed añade /chat/completions a esa ruta, por lo que responde la interfaz compatible con OpenAI de la pasarela. 

Puedes elegir cualquier nombre, y este se convertirá en la etiqueta del menú de modelos de Zed. Un bloque puede dar acceso a varios modelos de Claude, que se declaran individualmente en el siguiente paso. 

El sufijo /v1 es fundamental aquí: Zed construye la ruta de chat-completions directamente a partir del valor que indiques en api_url, por lo que omitir /v1 envía las solicitudes al lugar equivocado y una barra final puede duplicar la ruta. Configúrala exactamente como el host seguido de /v1 y el enrutamiento funcionará correctamente. Una recarga rápida de los ajustes después de editarlos confirma que Zed ha interpretado el bloque sin errores. Si el proveedor no aparece, lo primero que debes comprobar es si hay un error de sintaxis JSON en el bloque. 

## Declara available_models 

Zed no descubre automáticamente los modelos de un endpoint personalizado, así que debes enumerarlos manualmente en available_models. Cada entrada necesita un name que coincida con el identificador de la pasarela, un display_name para el menú y un valor max_tokens adecuado para el modelo. 

Usa claude-sonnet-4-5 para la asistencia habitual y añade claude-opus-4-8 como segunda entrada para las tareas más difíciles. Al enumerarlos explícitamente, el menú muestra exactamente el conjunto que quieres y ningún otro modelo. 

El campo name debe coincidir carácter por carácter con el identificador de la pasarela, mientras que display_name es meramente visual y puede mostrar el texto que prefieras en el menú. Un name incorrecto suele ser la causa de que un modelo aparezca pero dé errores al usarlo, así que copia el identificador directamente de la pasarela en lugar de escribirlo de memoria. Enumerar solo los modelos que realmente usas mantiene el menú breve y facilita la elección en el trabajo diario. Añadir un modelo más adelante solo requiere editar una línea, así que no es necesario declararlos todos desde el principio. 

## Dónde se guarda la clave 

La clave API no va en settings.json. Zed la guarda en el llavero del sistema operativo o la lee de una variable de entorno cuyo nombre se deriva del proveedor, como AIPRIME_API_KEY, lo que mantiene el secreto fuera de la configuración sincronizada. 

Después de guardar, abre el asistente, elige tu proveedor en el menú e introduce la clave cuando se te solicite. A partir de entonces, Zed se autentica mediante el llavero y tu archivo de ajustes permanece libre de credenciales. 

Esta separación resulta realmente útil si sincronizas los ajustes de Zed entre equipos o los guardas en un repositorio de dotfiles: la configuración puede trasladarse libremente porque no contiene ningún secreto, y cada equipo proporciona su propia clave mediante el llavero o el entorno. Es una solución más limpia que la de las herramientas que incorporan la clave en el archivo de configuración. Por eso también es seguro compartir una configuración de Zed con un compañero: utiliza su propia clave y la tuya nunca se transfiere. Lo mismo se aplica al guardar los ajustes en un repositorio de dotfiles. 

## La vía nativa mediante ACP 

Si buscas específicamente el comportamiento nativo de Anthropic en lugar de la interfaz compatible con OpenAI, Zed admite el Agent Client Protocol con Claude Code. Ejecutas Claude Code como agente y Zed se comunica con él mediante ACP. 

En esa configuración, Claude Code tiene su propio ANTHROPIC_BASE_URL apuntando a la pasarela, por lo que Zed nunca necesita una api_url de Anthropic propia. Es la forma más sencilla de obtener el auténtico comportamiento nativo de Messages dentro del editor. 

La contrapartida es que ACP ofrece el ciclo completo de agente de Claude Code en lugar del asistente integrado más ligero de Zed, lo que proporciona más capacidades, pero también una experiencia más pesada. Elige la vía openai_compatible para obtener ayuda rápida en línea y la vía ACP cuando quieras que un agente completo dirija ediciones de varios pasos desde el editor. La mayoría empieza con la vía más ligera y solo adopta ACP cuando necesita un agente completo en el editor. Puedes mantener ambas disponibles y recurrir a la que requiera cada tarea. 

Copiar

```
// Zed settings.json
{
  "language_models": {
    "openai_compatible": {
      "aiprime": {
        "api_url": "https://aiprimetech.io/v1",
        "available_models": [
          { "name": "claude-sonnet-4-5",
            "display_name": "Claude Sonnet",
            "max_tokens": 200000 }
        ]
      }
    }
  }
}
// Key goes in the keychain / AIPRIME_API_KEY env var, NOT this file.
```

## Preguntas frecuentes 

 ¿Por qué no puedo configurar una URL base de Claude en Zed?

El proveedor nativo de Anthropic de Zed no tiene un campo api_url. Usa el bloque openai_compatible, que sí permite configurar api_url, y apúntalo a https://aiprimetech.io/v1. ¿Dónde configuro api_url?

En language_models.openai_compatible.<name>.api_url, con /v1 al final. Zed añade /chat/completions a esa ruta. ¿Dónde va la clave API?

No va en settings.json: Zed la guarda en el llavero del sistema operativo o en una variable de entorno cuyo nombre se deriva del proveedor, como AIPRIME_API_KEY. ¿Cómo obtengo el comportamiento nativo de Anthropic?

Usa ACP con Claude Code como agente; Claude Code utiliza ANTHROPIC_BASE_URL para conectarse a la pasarela, por lo que Zed no necesita una api_url de Anthropic.  

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 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/)