Assistente de código
Conexão direta
Escolha de privacidade
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
Obtenha sua chave de API Venice
Abra as configurações de Intelligence
Adicione a Venice como provedor de chat
/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 .Escolha seus modelos
z-ai-glm-5-3-flash.Inicie uma conversa
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 endpointGET /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:
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 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:GET /models/traits?type=textretorna as escolhas atuais da Venice, comodefault_codepara programação.- O Project Context deixa as requisições grandes, então o preço dos tokens de entrada importa mais do que o normal. Compare os preços no catálogo de modelos de texto.
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:Permita agentes externos
Configure o agente com a Venice
Conecte o agente ao Xcode
Envie um prompt ao agente
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.
Solução de problemas
Erro 401 ou de autenticação
Erro 401 ou de autenticação
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.O Xcode não consegue carregar os modelos ou rejeita o provedor
O Xcode não consegue carregar os modelos ou rejeita o provedor
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.Erros de endpoint ao enviar uma mensagem
Erros de endpoint ao enviar uma mensagem
Erro 402 ou de pagamento necessário
Erro 402 ou de pagamento necessário
402 em dois casos:- A requisição chegou à Venice sem um header
Authorization. A Venice ignora outros headers, comox-api-key, e responde com um desafio de pagamento x402. Defina API Key Header comoAuthorization. - A chave atingiu seu limite de gastos, ou o seu saldo acabou. Veja Solução de problemas de erros de limite de gastos.
Modelo não encontrado
Modelo não encontrado
Ainda com problemas? Veja o que o agente envia
Ainda com problemas? Veja o que o agente envia