Asistente de programación
Conexión directa
Elección de privacidad
Requisitos previos
- Una API key de Venice desde venice.ai/settings/api
- Xcode 26.3 o posterior (las versiones anteriores de Xcode 26 pueden perder los proveedores de chat personalizados cuando Xcode se reinicia)
- macOS Tahoe 26 o posterior (Xcode 27 requiere macOS Tahoe 26.6 o posterior y un Mac con Apple silicon)
Configuración
Obtén tu API key de Venice
Abre los ajustes de Intelligence
Añade Venice como proveedor de chat
/v1 y sin barra final. Xcode le añade /v1/models y /v1/chat/completions, lo que da como resultado los endpoints estándar de Venice bajo https://api.venice.ai/api/v1.Xcode envía el campo API Key como el valor completo de la cabecera Authorization. Sustituye your-venice-api-key por tu key y conserva el prefijo Bearer .Elige tus modelos
z-ai-glm-5-3-flash.Inicia una conversación
Verificar la configuración
Enviar el prompt de prueba es la comprobación real. Que Xcode muestre la lista completa de modelos no demuestra que tu key funcione, porque el endpointGET /models de Venice devuelve el catálogo con o sin una key válida. Venice solo comprueba la key cuando envías un mensaje.
Si el prompt falla, verifica tu API key fuera de Xcode:
401 aquí apunta a la key y no a la configuración de Xcode. Si la key funciona, compara los ajustes del proveedor con la sección Solución de problemas.
Requisitos del modelo
El catálogo de modelos de texto indica esta capacidad como Function Calling, y la mayoría de los modelos de texto de Venice la admiten. Lo ideal es que el modelo tenga también una ventana de contexto de 200K tokens o más. Xcode no tiene ningún ajuste de ventana de contexto para los proveedores de chat y, con Project Context activado, una solicitud puede incluir mucho código del proyecto además de las definiciones de herramientas de Xcode. Para listar los modelos de Venice que cumplen ambos requisitos:Elegir modelos
Estos modelos cumplen ambos requisitos:GET /models/traits?type=textdevuelve las recomendaciones actuales de Venice, comodefault_codepara programación.- Project Context hace que las solicitudes sean grandes, así que el precio de los tokens de entrada importa más de lo habitual. Compara precios en el catálogo de modelos de texto.
Agentes
Los proveedores de chat solo dan servicio a las conversaciones de chat. Los agentes integrados de Xcode, como Claude Agent y Codex, y cualquier agente que añadas mediante el Agent Client Protocol (ACP) se configuran por separado y no envían solicitudes a través de un proveedor de chat. Además, los agentes tienen acceso a más capacidades de Xcode que el chat, como compilar y probar tu app. Para ejecutar un agente con modelos de Venice y acceso a tu proyecto de Xcode, configura un agente de terminal para Venice y conéctalo al servidor de Model Context Protocol (MCP) que proporcionan Xcode 26.3 y versiones posteriores:Permite agentes externos
Configura el agente con Venice
Conecta el agente a Xcode
Envía un prompt al agente
Privacidad
Xcode envía las solicitudes de chat desde tu Mac directamente a Venice. Project Context está activado por defecto en las conversaciones de chat, así que Xcode incluye en cada solicitud el código relevante y otro contexto de tu proyecto. Para limitar lo que envía Xcode, desactiva Project Context en el campo de mensaje y haz referencia a archivos y símbolos explícitamente con@.
Venice no almacena ni registra el contenido de los prompts y las respuestas en su proxy. El modelo que elijas determina el nivel de privacidad en tiempo de ejecución:
- Los modelos Private usan infraestructura sin retención de datos.
- Los modelos Anonymized ocultan tu identidad al proveedor upstream, pero ese proveedor puede procesar tu código.
- Los modelos TEE, con IDs de modelo
e2ee-, se ejecutan dentro de un enclave de hardware. Xcode no puede cifrar los prompts en tu Mac, así que estos modelos se ejecutan en modo TEE y no en modo de cifrado de extremo a extremo cuando los usas desde Xcode.
Solución de problemas
Error 401 o de autenticación
Error 401 o de autenticación
Bearer seguido de una key de Venice obtenida en venice.ai/settings/api, sin espacios adicionales. Xcode carga la lista de modelos incluso con una key incorrecta, porque esa lista es pública, así que los errores de autenticación solo aparecen cuando envías un mensaje. Prueba la key con el comando de Verificar la configuración.Xcode no puede cargar los modelos o rechaza el proveedor
Xcode no puede cargar los modelos o rechaza el proveedor
https://api.venice.ai/api. Una URL que termina en /v1 hace que Xcode solicite /api/v1/v1/models, y una barra final produce /api//v1/models. Venice devuelve 404 en ambos casos. Vuelve a añadir el proveedor con la URL corregida.Errores del endpoint al enviar un mensaje
Errores del endpoint al enviar un mensaje
Error 402 o de pago requerido
Error 402 o de pago requerido
402 en dos casos:- La solicitud llegó a Venice sin una cabecera
Authorization. Venice ignora otras cabeceras, comox-api-key, y responde con un desafío de pago x402. Establece API Key Header enAuthorization. - La key alcanzó su límite de gasto o se agotó tu saldo. Consulta Solución de errores de límite de gasto.
Modelo no encontrado
Modelo no encontrado
¿Sigues atascado? Mira lo que envía el agente
¿Sigues atascado? Mira lo que envía el agente