Zum Hauptinhalt springen
Xcode enthält einen Coding-Assistenten, der Fragen zu deinem Projekt beantworten, Code schreiben und refaktorieren sowie Fehler beheben kann. Neben den integrierten Providern akzeptiert Xcode jeden Chat-Provider, der die Chat Completions API unterstützt. Du kannst Venice also in den Intelligence-Einstellungen von Xcode hinzufügen und Venice-Modelle in Unterhaltungen mit dem Coding-Assistenten verwenden.

Coding-Assistent

Stelle Fragen, generiere Code und refaktoriere mit Venice-Modellen

Direkte Verbindung

Xcode sendet Anfragen direkt von deinem Mac an Venice

Wahl der Privatsphäre

Wähle ein Modell mit der Privatsphäre-Stufe, die dein Code benötigt

​
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

1

Venice API-Schlüssel besorgen

Erstelle einen Schlüssel unter venice.ai/settings/api. Ein Inference Only-Schlüssel reicht für Xcode aus.Erwäge, einen eigenen Schlüssel mit einem Epoch Consumption Limit anzulegen. So kannst du begrenzen, was Xcode ausgibt, und den Schlüssel widerrufen, ohne andere Apps zu beeinträchtigen. Siehe API-Schlüssel generieren.
2

Intelligence-Einstellungen öffnen

Wähle in Xcode Xcode > Settings und wähle in der Seitenleiste Intelligence aus.
3

Venice als Chat-Provider hinzufügen

Klicke unter Chat auf Add a Chat Provider und wähle Internet Hosted. In einigen Xcode-26-Versionen heißt die Schaltfläche Add a Model Provider.Gib die folgenden Werte ein und klicke dann auf Add:Übernimm die URL genau wie angegeben, ohne /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.
4

Modelle auswählen

Wähle unter Chat den Venice-Provider aus. Xcode ruft die Modellliste von Venice ab. Aktiviere die Modelle, die du nutzen möchtest, und markiere die am häufigsten genutzten mit einem Stern, damit sie oben im Modellmenü erscheinen.Die Liste enthält alle Venice-Textmodelle, der Coding-Assistent funktioniert aber nur mit Modellen, die Tool Calling unterstützen. Prüfe vor der Auswahl die Modellanforderungen oder beginne mit z-ai-glm-5-3-flash.
5

Eine Unterhaltung starten

Öffne ein Projekt und klicke dann auf die Schaltfläche Coding Assistant oder drücke Command-0. Klicke auf New Conversation und wähle unter Chat ein Venice-Modell aus. Der Platzhaltertext im Nachrichtenfeld zeigt, welches Modell die Unterhaltung verwendet.Sende einen kurzen Prompt, um die Verbindung zu testen:

​
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 der GET /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:
Dieser Endpoint erfordert einen gültigen Schlüssel. Ein 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

Das Modell muss Tool Calling unterstützen. In Chat-Unterhaltungen stellt Xcode dem Modell Tools zum Durchsuchen und Bearbeiten deines Projekts bereit. Ein Modell ohne Tool Calling kann die Anfragen des Coding-Assistenten daher nicht verarbeiten.
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: Beim Vergleich anderer Modelle:
  • GET /models/traits?type=text liefert die aktuellen Empfehlungen von Venice, etwa default_code fü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.
Venice nimmt regelmäßig Modelle außer Betrieb und ersetzt sie. Wenn ein Modell nicht mehr funktioniert, sieh unter Deprecations nach und wechsle zu einem aktuellen Modell.

​
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:
1

Externe Agents zulassen

Aktiviere in den Intelligence-Einstellungen von Xcode unter Model Context Protocol die Option Allow external agents to use Xcode tools.
2

Agent mit Venice einrichten

Folge der Anleitung für Codex CLI oder Claude Code.
3

Agent mit Xcode verbinden

Registriere den MCP-Server von Xcode beim Agent:
4

Agent prompten

Öffne zuerst dein Projekt in Xcode und prompte dann den Agent im Terminal. Xcode benachrichtigt dich, wenn sich der Agent verbindet.

​
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.
Prüfe das Privatsphäre-Label jedes Modells im Textmodell-Katalog und lies Venice-Privatsphäre, bevor du proprietären Code sendest.

​
Fehlerbehebung

Stelle sicher, dass API Key aus 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.
Prüfe, ob die URL genau 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.
Prüfe, ob die Unterhaltung ein Modell verwendet, das Tool Calling unterstützt und idealerweise ein Kontextfenster von 200K Tokens oder mehr hat. Xcode sendet mit jeder Anfrage Tool-Definitionen und Projektkontext: Ein Modell ohne Tool Calling kann diese nicht verarbeiten, und ein großes Projekt kann ein kleineres Kontextfenster überlaufen lassen. Aktiviere ein Modell, das die Modellanforderungen erfüllt, und starte damit eine neue Unterhaltung.
Venice gibt in zwei Fällen 402 zurück:
  • Die Anfrage hat Venice ohne Authorization-Header erreicht. Venice ignoriert andere Header wie x-api-key und antwortet mit einer x402-Zahlungsaufforderung. Setze API Key Header auf Authorization.
  • Der Schlüssel hat sein Ausgabenlimit erreicht oder dein Guthaben ist aufgebraucht. Siehe Fehlerbehebung bei Ausgabenlimit-Fehlern.
Venice hat das Modell möglicherweise außer Betrieb genommen. Sieh unter Deprecations nach, wähle ein aktuelles Modell aus der Modellliste des Providers und starte eine neue Unterhaltung.

​
Ressourcen

Coding Intelligence einrichten

Apples Anleitung zu Agents und Chat-Providern in Xcode

Code mit Intelligence schreiben

Coding-Assistent, Projektkontext und Verlauf nutzen

Venice-Textmodelle

Aktuelle Modell-IDs, Fähigkeiten und Privatsphäre-Stufen durchsuchen

API-Schlüssel generieren

Einen eigenen Schlüssel mit Ausgabenlimits erstellen