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.

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

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.