Pular para o conteúdo principal
O Xcode inclui um assistente de código que pode responder perguntas sobre o seu projeto, escrever e refatorar código e corrigir erros. Além dos provedores integrados, o Xcode aceita qualquer provedor de chat compatível com a API Chat Completions, então você pode adicionar a Venice nas configurações de Intelligence do Xcode e usar modelos Venice nas conversas do assistente de código.

Assistente de código

Faça perguntas, gere código e refatore com modelos Venice

Conexão direta

O Xcode envia as requisições do seu Mac diretamente para a Venice

Escolha de privacidade

Escolha um modelo com o nível de privacidade de que o seu código precisa

​
Pré-requisitos

  • Uma chave de API Venice em venice.ai/settings/api
  • Xcode 26.3 ou posterior (versões anteriores do Xcode 26 podem perder provedores de chat personalizados quando o Xcode é reiniciado)
  • macOS Tahoe 26 ou posterior (o Xcode 27 requer macOS Tahoe 26.6 ou posterior e um Mac com Apple silicon)

​
Configuração

1

Obtenha sua chave de API Venice

Gere uma chave em venice.ai/settings/api. Uma chave Inference Only é suficiente para o Xcode.Considere criar uma chave dedicada com um Epoch Consumption Limit, para limitar quanto o Xcode gasta e revogar a chave sem afetar outros apps. Veja Gerando uma chave de API.
2

Abra as configurações de Intelligence

No Xcode, escolha Xcode > Settings e selecione Intelligence na barra lateral.
3

Adicione a Venice como provedor de chat

Em Chat, clique em Add a Chat Provider e selecione Internet Hosted. Algumas versões do Xcode 26 chamam o botão de Add a Model Provider.Insira os valores a seguir e clique em Add:Mantenha a URL exatamente como mostrado, sem /v1 e sem barra no final. O Xcode acrescenta /v1/models e /v1/chat/completions a ela, o que resulta nos endpoints padrão da Venice em https://api.venice.ai/api/v1.O Xcode envia o campo API Key como o valor inteiro do header Authorization. Substitua your-venice-api-key pela sua chave e mantenha o prefixo Bearer .
4

Escolha seus modelos

Selecione o provedor Venice em Chat. O Xcode busca a lista de modelos na Venice. Ative os modelos que você deseja usar e marque com estrela os que você usa com mais frequência, para que apareçam no topo do menu de modelos.A lista inclui todos os modelos de texto Venice, mas o assistente de código só funciona com modelos que suportam tool calling. Confira os requisitos do modelo antes de escolher, ou comece com z-ai-glm-5-3-flash.
5

Inicie uma conversa

Abra um projeto e clique no botão Coding Assistant ou pressione Command-0. Clique em New Conversation e escolha um modelo Venice em Chat. O texto de placeholder no campo de mensagem mostra qual modelo a conversa usa.Envie um prompt curto para testar a conexão:

​
Verifique a configuração

Enviar o prompt de teste é a verificação real. Uma lista completa de modelos no Xcode não prova que sua chave funciona, porque o endpoint GET /models da Venice retorna o catálogo com ou sem uma chave válida. A Venice só verifica a chave quando você envia uma mensagem. Se o prompt falhar, verifique sua chave de API fora do Xcode:
Este endpoint exige uma chave válida, então um 401 aqui indica um problema na chave, e não na configuração do Xcode. Se a chave funcionar, compare as configurações do provedor com a seção Solução de problemas.

​
Requisitos do modelo

O modelo precisa suportar tool calling. Nas conversas de chat, o Xcode fornece ao modelo ferramentas para pesquisar e editar o seu projeto, então um modelo sem tool calling não consegue lidar com as requisições do assistente de código.
O catálogo de modelos de texto lista esse recurso como Function Calling, e a maioria dos modelos de texto Venice o suporta. Idealmente, o modelo também deve ter uma janela de contexto de 200K tokens ou mais. O Xcode não tem configuração de janela de contexto para provedores de chat e, com Project Context ativado, uma requisição pode incluir muito código do projeto além das definições de ferramentas do Xcode. Para listar os modelos Venice que atendem aos dois requisitos:

​
Escolhendo modelos

Estes modelos atendem aos dois requisitos: Ao comparar outros modelos: A Venice aposenta e substitui modelos regularmente. Se um modelo parar de funcionar, confira Descontinuações e mude para um modelo atual.

​
Agentes

Os provedores de chat alimentam apenas as conversas de chat. Os agentes integrados do Xcode, como Claude Agent e Codex, e quaisquer agentes que você adicione pelo Agent Client Protocol (ACP) são configurados separadamente e não enviam requisições por um provedor de chat. Os agentes também têm acesso a mais recursos do Xcode do que o chat, como compilar e testar o seu app. Para executar um agente com modelos Venice e acesso ao seu projeto do Xcode, configure um agente de terminal para a Venice e conecte-o ao servidor Model Context Protocol (MCP) que o Xcode 26.3 e posteriores fornecem:
1

Permita agentes externos

Nas configurações de Intelligence do Xcode, em Model Context Protocol, ative Allow external agents to use Xcode tools.
2

Configure o agente com a Venice

Siga o guia do Codex CLI ou do Claude Code.
3

Conecte o agente ao Xcode

Registre o servidor MCP do Xcode no agente:
4

Envie um prompt ao agente

Abra primeiro o seu projeto no Xcode e depois envie um prompt ao agente no Terminal. O Xcode avisa quando o agente se conecta.

​
Privacidade

O Xcode envia as requisições de chat do seu Mac diretamente para a Venice. O Project Context vem ativado por padrão nas conversas de chat, então o Xcode inclui código relevante e outros contextos do seu projeto em cada requisição. Para limitar o que o Xcode envia, desative o Project Context no campo de mensagem e referencie arquivos e símbolos explicitamente com @. A Venice não armazena nem registra o conteúdo de prompts e respostas no seu proxy. O modelo que você escolhe determina o nível de privacidade em tempo de execução:
  • Modelos Private usam infraestrutura com retenção zero de dados.
  • Modelos Anonymized ocultam sua identidade do provedor upstream, mas esse provedor pode processar o seu código.
  • Modelos TEE, com IDs de modelo e2ee-, rodam dentro de um enclave de hardware. O Xcode não consegue criptografar prompts no seu Mac, então esses modelos rodam no modo TEE, e não no modo com criptografia de ponta a ponta, quando você os usa a partir do Xcode.
Confira o rótulo de privacidade de cada modelo no catálogo de modelos de texto e leia sobre a privacidade da Venice antes de enviar código proprietário.

​
Solução de problemas

Confirme que o API Key é Bearer seguido de uma chave Venice de venice.ai/settings/api, sem espaços extras. O Xcode carrega a lista de modelos mesmo com uma chave errada, porque essa lista é pública, então os erros de autenticação só aparecem quando você envia uma mensagem. Teste a chave com o comando em Verifique a configuração.
Verifique se a URL é exatamente https://api.venice.ai/api. Uma URL terminada em /v1 faz o Xcode requisitar /api/v1/v1/models, e uma barra no final produz /api//v1/models. A Venice retorna 404 para ambos. Adicione o provedor novamente com a URL corrigida.
Verifique se a conversa usa um modelo que suporta tool calling e, idealmente, tem uma janela de contexto de 200K tokens ou mais. O Xcode envia definições de ferramentas e contexto do projeto em cada requisição: um modelo sem tool calling não consegue lidar com elas, e um projeto grande pode estourar uma janela de contexto menor. Ative um modelo que atenda aos requisitos do modelo e inicie uma nova conversa com ele.
A Venice retorna 402 em dois casos:
  • A requisição chegou à Venice sem um header Authorization. A Venice ignora outros headers, como x-api-key, e responde com um desafio de pagamento x402. Defina API Key Header como Authorization.
  • A chave atingiu seu limite de gastos, ou o seu saldo acabou. Veja Solução de problemas de erros de limite de gastos.
A Venice pode ter aposentado o modelo. Confira Descontinuações, escolha um modelo atual na lista de modelos do provedor e inicie uma nova conversa.

​
Recursos

Configurando o Coding Intelligence

Guia da Apple sobre agentes e provedores de chat no Xcode

Escrevendo código com Intelligence

Use o assistente de código, o contexto do projeto e o histórico

Modelos de texto Venice

Navegue pelos IDs de modelo atuais, recursos e níveis de privacidade

Gere uma chave de API

Crie uma chave dedicada com limites de gastos