Vai al contenuto principale
Xcode include un coding assistant che può rispondere a domande sul tuo progetto, scrivere e fare refactoring del codice e correggere errori. Oltre ai provider integrati, Xcode accetta qualsiasi chat provider che supporti la Chat Completions API, quindi puoi aggiungere Venice nelle impostazioni Intelligence di Xcode e usare i modelli Venice nelle conversazioni con il coding assistant.

Coding assistant

Fai domande, genera codice e fai refactoring con i modelli Venice

Connessione diretta

Xcode invia le richieste dal tuo Mac direttamente a Venice

Scelta della privacy

Scegli un modello con il livello di privacy di cui il tuo codice ha bisogno

​
Prerequisiti

  • Una API key Venice da venice.ai/settings/api
  • Xcode 26.3 o successivo (le versioni precedenti di Xcode 26 possono perdere i chat provider personalizzati al riavvio di Xcode)
  • macOS Tahoe 26 o successivo (Xcode 27 richiede macOS Tahoe 26.6 o successivo e un Mac con Apple silicon)

​
Configurazione

1

Ottieni la tua API key Venice

Genera una key da venice.ai/settings/api. Per Xcode è sufficiente una key Inference Only.Valuta di creare una key dedicata con un Epoch Consumption Limit, così puoi limitare la spesa di Xcode e revocare la key senza influire sulle altre app. Consulta Generare una API key.
2

Apri le impostazioni Intelligence

In Xcode, scegli Xcode > Settings e seleziona Intelligence nella barra laterale.
3

Aggiungi Venice come chat provider

In Chat, fai clic su Add a Chat Provider e seleziona Internet Hosted. In alcune versioni di Xcode 26 il pulsante si chiama Add a Model Provider.Inserisci i seguenti valori, poi fai clic su Add:Mantieni l’URL esattamente come mostrato, senza /v1 e senza slash finale. Xcode vi aggiunge /v1/models e /v1/chat/completions, ottenendo così gli endpoint standard di Venice sotto https://api.venice.ai/api/v1.Xcode invia il campo API Key come valore completo dell’header Authorization. Sostituisci your-venice-api-key con la tua key e mantieni il prefisso Bearer .
4

Scegli i tuoi modelli

Seleziona il provider Venice in Chat. Xcode recupera l’elenco dei modelli da Venice. Attiva i modelli che vuoi usare e aggiungi una stella a quelli che usi più spesso, così appariranno in cima al menu dei modelli.L’elenco include tutti i modelli di testo Venice, ma il coding assistant funziona solo con i modelli che supportano il tool calling. Controlla i requisiti dei modelli prima di scegliere, oppure inizia con z-ai-glm-5-3-flash.
5

Avvia una conversazione

Apri un progetto, poi fai clic sul pulsante Coding Assistant o premi Command-0. Fai clic su New Conversation e scegli un modello Venice in Chat. Il testo segnaposto nel campo del messaggio indica quale modello usa la conversazione.Invia un breve prompt per testare la connessione:

​
Verificare la configurazione

L’invio del prompt di test è la vera verifica. Un elenco completo di modelli in Xcode non dimostra che la tua key funzioni, perché l’endpoint GET /models di Venice restituisce il catalogo con o senza una key valida. Venice controlla la key solo quando invii un messaggio. Se il prompt non va a buon fine, verifica la tua API key al di fuori di Xcode:
Questo endpoint richiede una key valida, quindi un 401 qui indica un problema con la key e non con la configurazione di Xcode. Se la key funziona, confronta le impostazioni del provider con la sezione Risoluzione dei problemi.

​
Requisiti dei modelli

Il modello deve supportare il tool calling. Nelle conversazioni chat, Xcode fornisce al modello strumenti per cercare e modificare il tuo progetto, quindi un modello senza tool calling non può gestire le richieste del coding assistant.
Il catalogo dei modelli di testo indica questa capacità come Function Calling, e la maggior parte dei modelli di testo Venice la supporta. Idealmente, il modello dovrebbe avere anche una context window di 200K token o più. Xcode non ha un’impostazione per la context window dei chat provider e, con Project Context attivo, una richiesta può includere molto codice del progetto oltre alle definizioni degli strumenti di Xcode. Per elencare i modelli Venice che soddisfano entrambi i requisiti:

​
Scegliere i modelli

Questi modelli soddisfano entrambi i requisiti: Quando confronti altri modelli: Venice ritira e sostituisce regolarmente i modelli. Se un modello smette di funzionare, controlla Deprecazioni e passa a uno attuale.

​
Agenti

I chat provider alimentano solo le conversazioni chat. Gli agenti integrati di Xcode, come Claude Agent e Codex, e qualsiasi agente che aggiungi tramite l’Agent Client Protocol (ACP) vengono configurati separatamente e non inviano richieste tramite un chat provider. Gli agenti hanno inoltre accesso a più funzionalità di Xcode rispetto alla chat, come la build e il test della tua app. Per eseguire un agente sui modelli Venice con accesso al tuo progetto Xcode, configura un agente da terminale per Venice e collegalo al server Model Context Protocol (MCP) fornito da Xcode 26.3 e successivi:
1

Consenti gli agenti esterni

Nelle impostazioni Intelligence di Xcode, in Model Context Protocol, attiva Allow external agents to use Xcode tools.
2

Configura l'agente con Venice

Segui la guida di Codex CLI o di Claude Code.
3

Collega l'agente a Xcode

Registra il server MCP di Xcode nell’agente:
4

Invia un prompt all'agente

Apri prima il tuo progetto in Xcode, poi invia un prompt all’agente nel Terminale. Xcode ti avvisa quando l’agente si connette.

​
Privacy

Xcode invia le richieste chat dal tuo Mac direttamente a Venice. Project Context è attivo per impostazione predefinita nelle conversazioni chat, quindi Xcode include in ogni richiesta il codice rilevante e altro contesto del tuo progetto. Per limitare ciò che Xcode invia, disattiva Project Context nel campo del messaggio e fai riferimento esplicitamente a file e simboli con @. Venice non memorizza né registra il contenuto di prompt e risposte nel suo proxy. Il modello che scegli determina il livello di privacy in fase di esecuzione:
  • I modelli Private usano un’infrastruttura a zero data retention.
  • I modelli Anonymized nascondono la tua identità al provider upstream, ma quel provider può elaborare il tuo codice.
  • I modelli TEE, con ID modello e2ee-, vengono eseguiti all’interno di un enclave hardware. Xcode non può cifrare i prompt sul tuo Mac, quindi quando li usi da Xcode questi modelli funzionano in modalità TEE anziché in modalità con crittografia end-to-end.
Controlla l’etichetta di privacy di ciascun modello nel catalogo dei modelli di testo e leggi Privacy di Venice prima di inviare codice proprietario.

​
Risoluzione dei problemi

Verifica che API Key sia Bearer seguito da una key Venice da venice.ai/settings/api, senza spazi aggiuntivi. Xcode carica l’elenco dei modelli anche con una key errata, perché quell’elenco è pubblico, quindi gli errori di autenticazione compaiono solo quando invii un messaggio. Testa la key con il comando in Verificare la configurazione.
Verifica che l’URL sia esattamente https://api.venice.ai/api. Un URL che termina con /v1 fa sì che Xcode richieda /api/v1/v1/models, mentre uno slash finale produce /api//v1/models. Venice restituisce 404 in entrambi i casi. Aggiungi di nuovo il provider con l’URL corretto.
Verifica che la conversazione usi un modello che supporta il tool calling e che, idealmente, abbia una context window di 200K token o più. Xcode invia definizioni degli strumenti e contesto del progetto con ogni richiesta: un modello senza tool calling non può gestirli e un progetto di grandi dimensioni può superare una context window più piccola. Attiva un modello che soddisfi i requisiti dei modelli, poi avvia una nuova conversazione con quel modello.
Venice restituisce 402 in due casi:
  • La richiesta è arrivata a Venice senza un header Authorization. Venice ignora altri header, come x-api-key, e risponde con una challenge di pagamento x402. Imposta API Key Header su Authorization.
  • La key ha raggiunto il suo limite di spesa, oppure il tuo saldo è esaurito. Consulta Risoluzione degli errori del limite di spesa.
Venice potrebbe aver ritirato il modello. Controlla Deprecazioni, scegli un modello attuale dall’elenco dei modelli del provider e avvia una nuova conversazione.

​
Risorse

Configurare la coding intelligence

La guida di Apple ad agenti e chat provider in Xcode

Scrivere codice con Intelligence

Usa il coding assistant, il contesto del progetto e la cronologia

Modelli di testo Venice

Sfoglia gli ID dei modelli attuali, le capacità e i livelli di privacy

Generare una API key

Crea una key dedicata con limiti di spesa