Wie importiert man Xcode 27.1 RC Skills in Codex? Tutorial 2026

Die Apple-Veröffentlichungsseite nennt den 05.10.2026 als Veröffentlichungsdatum von Xcode 27.1 RC (Apple-Veröffentlichung). Symptom: Codex sieht einen importierten Skill, baut Ihr Projekt aber nicht. Schnellster Weg: Exportieren Sie die Skills auf dem Mac mit der gewünschten Xcode-Installation, legen Sie sie in einem von Codex unterstützten Skills-Verzeichnis ab und prüfen Sie Skill-Aufruf, Projektberechtigungen und Build getrennt.

Dieser Leitfaden ist für Sie, wenn Sie mit Codex CLI Swift-, iOS- oder macOS-Projekte pflegen und Xcode Agent Skills weiterverwenden möchten, ohne den Entwicklungsablauf vollständig in Xcode zu verlagern. Er hilft auch kleinen Teams, die Skills und Berechtigungen nachvollziehbar prüfen müssen. Wenn Sie keinen lokalen Mac haben, erfahren Sie außerdem, wie Sie eine geeignete Remote-Mac-Umgebung in den Ablauf einordnen.

Zuletzt aktualisiert am 10.10.2026; Versions- und Funktionsangaben anhand der Apple-Veröffentlichungsseite, der Xcode-Dokumentation und der offiziellen Codex-Dokumentation geprüft.

SECTION 01Vor dem Export: die tatsächlich verwendete Xcode-Umgebung prüfen

Ein Skill ist eine Anleitung für den Agenten, kein Nachweis dafür, dass Codex Ihre Projektdateien lesen, Befehle ausführen oder Xcode starten darf. Behandeln Sie deshalb den Export und die spätere Build-Abnahme als getrennte Arbeitsschritte. Das verhindert einen häufigen Fehlschluss: Eine sichtbare Skill-Datei bedeutet weder, dass der Agent sie korrekt aufruft, noch dass ein Archiv oder eine App erfolgreich erstellt werden kann.

Prüfen Sie zuerst, welche Xcode-Installation Ihr Terminal tatsächlich verwendet. Die dafür maßgebliche Auswahl des aktiven Entwicklerverzeichnisses lässt sich mit xcode-select -p anzeigen; die installierte Xcode-Version können Sie mit xcodebuild -version abfragen. Apple beschreibt die Auswahl der Kommandozeilenwerkzeuge und die Installation der Command Line Tools in der Dokumentation zur Installation der Kommandozeilenwerkzeuge und in der Technote zu Xcode-Kommandozeilenwerkzeugen.

Notieren Sie die Ausgabe, bevor Sie exportieren. Auf einem Rechner mit mehreren Xcode-Installationen kann das aktive Entwicklerverzeichnis auf eine andere Installation zeigen als diejenige, die Sie in der grafischen Oberfläche öffnen. Wenn Sie in diesem Zustand einen Export starten, prüfen Sie später möglicherweise Skills aus der falschen Umgebung. Wechseln Sie nicht vorsorglich Verzeichnisse oder Installationen, sondern gleichen Sie die angezeigte Auswahl mit der Xcode-Installation ab, die Ihr Team für das Projekt verwendet.

Prüfen Sie ebenso, unter welchem Benutzer und in welchem Terminal Codex CLI gestartet wird. Ein Skills-Verzeichnis im Benutzerkonto eines anderen macOS-Accounts ist für die laufende Codex-Sitzung nicht automatisch verfügbar. Halten Sie außerdem Projektpfad, Git-Status und verwendete Toolchain fest. Damit können Sie nach dem Import unterscheiden, ob ein Problem vom Skill, von der Sitzung, vom Projektzugriff oder von Xcode ausgeht.

Apple dokumentiert Erweiterungen für Agenten und die zugehörigen Skills in der Dokumentation zum Erweitern und Anpassen von Agenten. Die Xcode-27-Release-Notes sind die ergänzende Referenz für versionsbezogene Hinweise. Dass Xcode 27.1 RC auf der Veröffentlichungsseite steht, belegt den dort genannten Veröffentlichungstermin; es ist keine Aussage darüber, welche Xcode-Version zu einem späteren Zeitpunkt die neueste ist.

Wie exportieren Sie Agent Skills aus Xcode 27 für Codex CLI?
Verwenden Sie den von Apple dokumentierten Exportaufruf xcrun agent skills export in der zuvor geprüften Xcode-Umgebung. Übernehmen Sie Optionen oder zusätzliche Parameter nur, wenn sie für Ihre installierte Version in der offiziellen Dokumentation oder im zugehörigen Hilfetext bestätigt sind. Ein vermeintlich passendes Flag aus einem Beitrag oder einer früheren Beta-Anleitung ist kein verlässlicher Ersatz für die Prüfung der aktuellen Version.

SECTION 02Export: Skills aus der ausgewählten Installation erzeugen

Starten Sie den Export aus dem Terminal, in dem Sie zuvor die aktive Xcode-Umgebung geprüft haben. Der dokumentierte Aufruf lautet:

xcrun agent skills export

Behandeln Sie den Exit-Status allein nicht als vollständige Abnahme. Prüfen Sie die vom Werkzeug ausgegebene Rückmeldung und notieren Sie den tatsächlichen Ausgabeort. Öffnen Sie anschließend die erzeugten Dateien und kontrollieren Sie, ob dort die erwarteten Skill-Anweisungen und die für den Skill nötige Verzeichnisstruktur vorhanden sind. Der konkrete Ausgabeort und die unterstützten Optionen sind anhand der für Ihre Installation geltenden Apple-Unterlagen zu überprüfen; setzen Sie keinen Pfad voraus, nur weil ein anderer Rechner ihn verwendet.

Bewahren Sie für den Import einen nachvollziehbaren Stand auf: die verwendete Xcode-Version, das aktive Entwicklerverzeichnis, den Exportaufruf und den tatsächlichen Ausgabeort. Diese Angaben helfen, falls später eine Skill-Anweisung fehlt oder Codex eine andere Fassung entdeckt. Vermeiden Sie es, beim ersten Versuch Dateien umzubenennen oder ihre Struktur umzubauen. Erst wenn Sie wissen, wie der Export aussieht und wo Codex suchen soll, können Sie eine Abweichung gezielt untersuchen.

Die Abgrenzung ist wichtig: Ein erfolgreicher Export erzeugt Dateien, die für eine weitere Verwendung bereitstehen. Er belegt nicht, dass Codex sie bereits gefunden hat. Ebenso sagt er nichts darüber aus, ob ein Skill inhaltlich zu Ihrem Projekt passt oder eine Xcode-Aktion tatsächlich ausführen kann. Halten Sie daher Exportnachweis und Erkennungsnachweis getrennt.

SECTION 03Import: den Codex-Suchort und die Dateistruktur abgleichen

Codex CLI erkennt Skills anhand der dokumentierten Verzeichnisregeln. Die offiziellen Hinweise zu Aufbau und Auffindbarkeit finden Sie in der Dokumentation zu Skills und im Beitrag zu Skills und deren Auswertung. Diese Quellen sollten Sie vor dem Import mit der Codex-Version abgleichen, die Sie tatsächlich einsetzen: Verlassen Sie sich nicht auf ein pauschal angenommenes Verzeichnis, wenn sich die dokumentierte Erkennung oder Ihr Startkontext unterscheidet.

In welches Verzeichnis gehören exportierte Xcode Skills?
Legen Sie die exportierten Dateien in ein Skills-Verzeichnis, das die offizielle Codex-Dokumentation für Ihren gewünschten Geltungsbereich nennt. Prüfen Sie, ob Sie den Skill nur für ein Projekt oder für Ihren Benutzer verfügbar machen möchten, und übernehmen Sie die dazugehörige Verzeichnisstruktur aus der Dokumentation. Fügen Sie nicht nur den Inhalt einer Datei in einen beliebigen Ordner ein: Codex muss den Skill anhand der erwarteten Struktur finden können.

Nach dem Kopieren kontrollieren Sie den Zielpfad und vergleichen die Dateistruktur mit dem Export. Starten Sie anschließend eine frische Codex-Sitzung beziehungsweise laden Sie den Kontext so neu, wie es die für Ihre Version dokumentierte Vorgehensweise vorsieht. Die genaue Art der erneuten Erkennung kann sich mit der CLI-Version ändern; deshalb sollte sie nicht aus einer älteren Anleitung abgeleitet werden. Ein Neustart ist ein Diagnoseversuch, kein Beweis, dass der Pfad korrekt ist.

Führen Sie für die erste Erkennung eine harmlose Anfrage aus, die keine Änderungen an Ihrem Projekt verlangt. Fragen Sie Codex, welche einschlägigen Skill-Anweisungen für eine klar begrenzte Aufgabe verfügbar sind, und lassen Sie die relevanten Anweisungen beschreiben. Vergleichen Sie die Antwort mit dem exportierten Inhalt. Die Prüfung ist aussagekräftiger, wenn Sie keine Codeänderung und keinen Build anfordern: So testen Sie zunächst die Erkennung, ohne zugleich Berechtigungs- und Toolchain-Probleme einzuführen.

Eine Xcode-Beta-Notiz zu einem bekannten Problem oder einer Umgehungslösung darf nicht ungeprüft als Fehlerbeschreibung für Xcode 27.1 RC übernommen werden. Prüfen Sie die zu Ihrer installierten Version gehörenden Release Notes; eine frühere Beta-Meldung beweist nicht, dass derselbe Zustand in der RC fortbesteht.

SECTION 04Aufruf und Berechtigungen: drei getrennte Prüfungen

Wenn Codex den Skill nicht von selbst verwendet, behandeln Sie das nicht sofort als Beleg für einen fehlerhaften Export. Prüfen Sie nacheinander den Suchort, den Sitzungszustand und die Aufgabenbeschreibung. Ein Agent kann einen Skill finden und dennoch nicht wählen, wenn Ihre Anfrage keinen passenden Anwendungsfall erkennen lässt. Beschreiben Sie die Aufgabe deshalb konkret und nennen Sie den gewünschten Skill, sofern das in Ihrem Ablauf zulässig und sinnvoll ist.

Was prüfen Sie, wenn Codex einen Xcode Skill sieht, ihn aber nicht aufruft?
Bitten Sie zunächst um eine begrenzte Erläuterung der Skill-Anweisungen, ohne Änderungen ausführen zu lassen. Wird der Inhalt erkannt, aber nicht angewendet, präzisieren Sie den Arbeitsauftrag und fragen Sie nach dem geplanten Vorgehen. Wird der Skill gar nicht gefunden, prüfen Sie zuerst Suchpfad, Benutzerkonto, Verzeichnisstruktur und Sitzung. Diese Fehlerbilder brauchen unterschiedliche Korrekturen; zusätzliche Rechte lösen einen falschen Suchpfad nicht.

Danach prüfen Sie den Zugriff auf das Projekt. Codex muss im richtigen Projektkontext arbeiten und die Dateien lesen können, auf die sich die Anweisung bezieht. Lassen Sie sich vor einer Änderung zunächst die betroffenen Dateien und den geplanten Arbeitsschritt nennen. Kontrollieren Sie, ob Ihre lokale Umgebung eine Zustimmung für Dateiänderungen oder Befehle verlangt, und erteilen Sie nur die für die konkrete Aufgabe nötigen Rechte.

Die dritte Prüfung betrifft die Ausführung. Ein Skill kann Anweisungen für xcodebuild enthalten, doch daraus folgt nicht automatisch, dass Codex diesen Befehl ausführen darf oder dass Xcode in der aktuellen Shell erreichbar ist. Prüfen Sie die Freigaben Ihres Agentenwerkzeugs, die aktive Entwicklerumgebung und die Erreichbarkeit der benötigten Werkzeuge. Erhöhen Sie die Berechtigungen nicht pauschal, nur um einen Skill-Aufruf zu erzwingen. Weitreichende Befehlsrechte sind keine Voraussetzung für den Import und vergrößern das Risiko, dass ein unpassender Schritt Dateien verändert oder sensible Informationen ausgibt.

Verwenden Sie bei Tests Platzhalter statt echter Zugangsdaten, persönlicher Teamkennungen oder Signaturinformationen. Für die erste Abnahme reicht eine Aufgabe, die den Projektzustand liest und einen Plan beschreibt. Erst wenn Skill-Erkennung und Projektzugriff getrennt funktionieren, sollten Sie eine kontrollierte Änderung in einem rücksetzbaren Arbeitszweig zulassen.

SECTION 05Projektabnahme: Build-Ergebnis statt Skill-Sichtbarkeit bewerten

Für die Projektprüfung brauchen Sie einen kontrollierten Ausgangspunkt. Verwenden Sie einen Testzweig oder ein geeignetes Testprojekt, prüfen Sie den Versionskontrollstatus und stellen Sie sicher, dass Sie Änderungen zurücknehmen können. Lassen Sie Codex eine eng umrissene Aufgabe anhand des importierten Skills bearbeiten. Lesen Sie die Änderung, bevor Sie den Build starten; ein plausibel formulierter Plan ist kein Ersatz für eine Prüfung des Diffs.

Wie bestätigen Sie nach dem Import, dass Codex ein iOS-Projekt bauen kann?
Lassen Sie Codex den Build mit der in Ihrem Projekt vorgesehenen Xcode-Konfiguration anstoßen und prüfen Sie unabhängig den vollständigen Build-Ausgang, die relevanten Fehlermeldungen und das erzeugte Ergebnis. Wenn Ihre Arbeit Tests, Archivierung oder Signierung einschließt, prüfen Sie auch diese Schritte separat. Ein erfolgreicher Skill-Aufruf belegt nur, dass der Agent die Anleitung genutzt hat. Er bestätigt weder erfolgreiche Kompilierung noch bestandene Tests, korrekt signierte Archive oder eine erfolgreiche Veröffentlichung.

Führen Sie den Build zunächst selbst im Projektkontext aus, wenn Sie die erwartete Ausgangslage noch nicht kennen. So erhalten Sie einen Vergleichspunkt für Fehlermeldungen, die möglicherweise schon vor dem Skill-Import bestanden. Lassen Sie nach dem Codex-Lauf den Build erneut ausführen und vergleichen Sie Protokoll, Rückgabestatus und Projektänderungen. Bei Abweichungen prüfen Sie zuerst die konkrete Fehlermeldung und nicht die bloße Tatsache, dass der Skill aufgerufen wurde.

Eine saubere Abnahme hält mindestens diese Ergebnisse getrennt fest:

• Erkennung: Codex kann den gewünschten Skill im aktuellen Kontext auffinden.
• Anwendung: Die Antwort oder der ausgeführte Arbeitsschritt folgt den relevanten Anweisungen.
• Projektzugriff: Codex kann die für die Aufgabe nötigen Dateien lesen und nur im vorgesehenen Umfang ändern.
• Befehlsausführung: Die freigegebenen Werkzeuge sind erreichbar und werden im passenden Projektkontext verwendet.
• Build: Xcode meldet das tatsächliche Ergebnis; Tests und weitere Freigabeschritte werden eigenständig geprüft.

Wenn Sie den Ablauf regelmäßig wiederholen, versionieren Sie nicht blind jede lokal exportierte Datei mit. Legen Sie im Team fest, welche Skills projektbezogen gelten, wer Änderungen daran prüft und wie neue Xcode- oder Codex-Versionen getestet werden. Für Teams mit mehreren Entwicklungsumgebungen ist außerdem entscheidend, dass der Export nicht versehentlich von einer anderen aktiven Xcode-Installation stammt. Die dokumentierten Umgebungsdaten und ein reproduzierbarer Abnahmelauf sind hierfür hilfreicher als ein Screenshot, der lediglich den Skill-Namen zeigt.

SECTION 06Remote Mac als Arbeitsumgebung ohne lokalen Mac

Wenn Sie keinen Mac vor Ort haben, benötigen Sie für Xcode-bezogene Export- und Build-Prüfungen dennoch Zugriff auf eine macOS-Umgebung mit der passenden Toolchain. Ein Windows- oder Linux-Rechner kann Ihre übrige Arbeit am Quellcode unterstützen, aber er ersetzt den tatsächlichen Xcode-Build nicht. Prüfen Sie bei einer Remote-Umgebung vor Beginn, ob Sie interaktiv auf macOS zugreifen, ein Terminal verwenden und den Projektstand sicher übertragen können. Verifizieren Sie außerdem, welche Xcode-Installation aktiv ist, statt die Verfügbarkeit eines Macs mit einer bereits geprüften Build-Umgebung gleichzusetzen.

Ein Remote Mac kann sinnvoll sein, wenn Sie den Export, den Import und die echte Projektprüfung ohne Anschaffung eines eigenen Rechners erledigen möchten. Nachteile sind die Abhängigkeit von Netzwerkzugriff und gebuchter Verfügbarkeit sowie zusätzlicher Aufwand für Sitzungszugriff, Projektübertragung und die sichere Behandlung von Signaturmaterial. Ein eigener Mac bietet dafür direkten Zugriff und eignet sich eher, wenn Sie dauerhaft auf dieselbe lokale Umgebung oder physische Anschlüsse angewiesen sind. Eine reine CI-Umgebung kann automatisierte Builds abdecken, ist aber nicht automatisch für interaktive Agentenkonfiguration oder manuelle Diagnose ausgelegt.

MACNOX bietet eine Möglichkeit, einen Remote Mac zu mieten; Umfang, Kosten und Eignung sollten Sie anhand der jeweils aktuellen Angaben prüfen, statt sie aus dieser Anleitung abzuleiten. Wenn Sie diese Option vergleichen, beziehen Sie aktuelle Mietkonditionen für einen Mac in Ihre Entscheidung ein. Wer für Export und Konfiguration eine macOS-Umgebung benötigt, kann anschließend die Mietoptionen für den Remote-Zugriff mit einem lokalen Mac oder einem vorhandenen CI-Ablauf vergleichen. Eine Miete ist nicht automatisch die bessere Wahl: Bei durchgehendem, langfristigem Einsatz kann ein eigener Mac günstiger oder einfacher sein; für eine zeitlich begrenzte Einrichtung und nachvollziehbare Xcode-Abnahme kann die Remote-Umgebung dagegen den Kauf eines zusätzlichen Rechners vermeiden.

SECTION 07Abhakliste für die Übergabe

Arbeiten Sie die Punkte in der Reihenfolge ab. Wenn eine Prüfung scheitert, korrigieren Sie zuerst diese Ebene und gehen Sie erst danach weiter:

• [ ] Die aktive Xcode-Installation und das Entwicklerverzeichnis sind im Terminal geprüft.
• [ ] Der Export wurde mit xcrun agent skills export aus der vorgesehenen Umgebung gestartet.
• [ ] Der tatsächliche Ausgabeort und die erzeugten Dateien sind dokumentiert.
• [ ] Die Skill-Dateien liegen an einem laut Codex-Dokumentation unterstützten Ort.
• [ ] Codex wurde im passenden Benutzer- und Projektkontext erneut gestartet oder aktualisiert.
• [ ] Eine unverändernde Anfrage bestätigt die Erkennung und den Inhalt des Skills.
• [ ] Projektzugriff und Befehlsfreigaben wurden einzeln und mit minimal nötigen Rechten geprüft.
• [ ] Der Build wurde in einem rücksetzbaren Projektzustand ausgeführt und anhand des Xcode-Protokolls bewertet.
• [ ] Tests, Archivierung und Signierung wurden nur dann als bestanden gewertet, wenn ihre jeweiligen Ergebnisse geprüft wurden.

Der entscheidende Unterschied bleibt: Ein importierter Skill verbessert die Anleitung für Codex, er richtet aber nicht automatisch Ihre Xcode-Toolchain, Projektberechtigungen oder Signaturumgebung ein. Wenn Sie all diese Ebenen auf einem vorhandenen Mac bereits zuverlässig abdecken, brauchen Sie für den Skill-Import keinen zusätzlichen Rechner. Fehlt Ihnen dagegen macOS für Export, Konfiguration oder einen echten Projekt-Build, vergleichen Sie die laufenden Nachteile Ihrer aktuellen Lösung — etwa fehlenden Xcode-Zugriff, eingeschränkte Diagnose und zusätzlichen Aufwand für wechselnde Build-Umgebungen — mit einem gemieteten Remote Mac, bevor Sie Hardware anschaffen.