Coding-Assistent
Direkte Verbindung
Wahl der Privatsphäre
Voraussetzungen
- Ein Venice API-Schlüssel von venice.ai/settings/api
- Xcode 26.3 oder neuer (frühere Xcode-26-Versionen können benutzerdefinierte Chat-Provider verlieren, wenn Xcode neu startet)
- macOS Tahoe 26 oder neuer (Xcode 27 erfordert macOS Tahoe 26.6 oder neuer und einen Mac mit Apple Silicon)
Einrichtung
Venice API-Schlüssel besorgen
Intelligence-Einstellungen öffnen
Venice als Chat-Provider hinzufügen
/v1 und ohne abschließenden Schrägstrich. Xcode hängt /v1/models und /v1/chat/completions daran an, was die Standard-Endpoints von Venice unter https://api.venice.ai/api/v1 ergibt.Xcode sendet das Feld API Key als vollständigen Wert des Authorization-Headers. Ersetze your-venice-api-key durch deinen Schlüssel und behalte das Präfix Bearer bei.Modelle auswählen
z-ai-glm-5-3-flash.Eine Unterhaltung starten
Einrichtung überprüfen
Das Senden des Test-Prompts ist die eigentliche Prüfung. Eine vollständige Modellliste in Xcode beweist nicht, dass dein Schlüssel funktioniert, denn derGET /models-Endpoint von Venice liefert den Katalog mit oder ohne gültigen Schlüssel. Venice prüft den Schlüssel erst, wenn du eine Nachricht sendest.
Wenn der Prompt fehlschlägt, überprüfe deinen API-Schlüssel außerhalb von Xcode:
401 deutet hier also auf den Schlüssel hin und nicht auf die Konfiguration von Xcode. Wenn der Schlüssel funktioniert, vergleiche die Provider-Einstellungen mit der Fehlerbehebung.
Modellanforderungen
Der Textmodell-Katalog führt diese Fähigkeit als Function Calling, und die meisten Venice-Textmodelle unterstützen sie. Idealerweise sollte das Modell außerdem ein Kontextfenster von 200K Tokens oder mehr haben. Xcode bietet für Chat-Provider keine Einstellung für das Kontextfenster, und bei aktiviertem Project Context kann eine Anfrage zusätzlich zu den Tool-Definitionen von Xcode viel Projektcode enthalten. So listest du die Venice-Modelle auf, die beide Anforderungen erfüllen:Modelle auswählen
Diese Modelle erfüllen beide Anforderungen:GET /models/traits?type=textliefert die aktuellen Empfehlungen von Venice, etwadefault_codefür das Programmieren.- Project Context macht Anfragen groß, daher sind die Preise für Input-Tokens wichtiger als sonst. Vergleiche die Preise im Textmodell-Katalog.
Agents
Chat-Provider betreiben ausschließlich Chat-Unterhaltungen. Die integrierten Agents von Xcode, etwa Claude Agent und Codex, sowie alle Agents, die du über das Agent Client Protocol (ACP) hinzufügst, werden separat konfiguriert und senden keine Anfragen über einen Chat-Provider. Agents erhalten außerdem mehr Fähigkeiten von Xcode als der Chat, etwa das Bauen und Testen deiner App. Um einen Agent mit Venice-Modellen und Zugriff auf dein Xcode-Projekt zu betreiben, konfiguriere einen Terminal-Agent für Venice und verbinde ihn mit dem Model Context Protocol (MCP)-Server, den Xcode ab Version 26.3 bereitstellt:Externe Agents zulassen
Agent mit Venice einrichten
Agent mit Xcode verbinden
Agent prompten
Privatsphäre
Xcode sendet Chat-Anfragen direkt von deinem Mac an Venice. Project Context ist in Chat-Unterhaltungen standardmäßig aktiviert, sodass Xcode relevanten Code und weiteren Kontext aus deinem Projekt in jede Anfrage einbezieht. Um einzuschränken, was Xcode sendet, deaktiviere Project Context im Nachrichtenfeld und referenziere Dateien und Symbole explizit mit@.
Venice speichert oder protokolliert Prompt- und Antwortinhalte an seinem Proxy nicht. Das gewählte Modell bestimmt die Privatsphäre-Stufe zur Laufzeit:
- Private-Modelle nutzen eine Infrastruktur ohne Datenspeicherung (Zero Data Retention).
- Anonymized-Modelle verbergen deine Identität vor dem Upstream-Provider, dieser Provider kann deinen Code aber verarbeiten.
- TEE-Modelle mit
e2ee--Modell-IDs laufen innerhalb einer Hardware-Enclave. Xcode kann Prompts nicht auf deinem Mac verschlüsseln, daher laufen diese Modelle bei Nutzung aus Xcode im TEE-Modus und nicht im Ende-zu-Ende-verschlüsselten Modus.
Fehlerbehebung
401 oder Authentifizierungsfehler
401 oder Authentifizierungsfehler
Bearer gefolgt von einem Venice-Schlüssel von venice.ai/settings/api besteht, ohne zusätzliche Leerzeichen. Xcode lädt die Modellliste auch mit einem falschen Schlüssel, weil diese Liste öffentlich ist. Authentifizierungsfehler treten daher erst auf, wenn du eine Nachricht sendest. Teste den Schlüssel mit dem Befehl unter Einrichtung überprüfen.Xcode kann keine Modelle laden oder lehnt den Provider ab
Xcode kann keine Modelle laden oder lehnt den Provider ab
https://api.venice.ai/api lautet. Eine URL, die auf /v1 endet, lässt Xcode /api/v1/v1/models anfragen, und ein abschließender Schrägstrich ergibt /api//v1/models. Venice gibt in beiden Fällen 404 zurück. Füge den Provider mit der korrigierten URL erneut hinzu.Endpoint-Fehler beim Senden einer Nachricht
Endpoint-Fehler beim Senden einer Nachricht
402 oder Fehler „Payment Required“
402 oder Fehler „Payment Required“
402 zurück:- Die Anfrage hat Venice ohne
Authorization-Header erreicht. Venice ignoriert andere Header wiex-api-keyund antwortet mit einer x402-Zahlungsaufforderung. Setze API Key Header aufAuthorization. - Der Schlüssel hat sein Ausgabenlimit erreicht oder dein Guthaben ist aufgebraucht. Siehe Fehlerbehebung bei Ausgabenlimit-Fehlern.
Modell nicht gefunden
Modell nicht gefunden
Immer noch nicht gelöst? Sehen Sie, was der Agent sendet
Immer noch nicht gelöst? Sehen Sie, was der Agent sendet