Den vollständigen Index der Dokumentation findest du in llms.txt. Die Markdown-Version einer Dokumentationsseite erhältst du, indem du .md an die URL der Seite anhängst.
Hauptnavigation
Design

Codex in Linear verwenden

Codex-Chats direkt aus Linear-Issues starten

Mit Codex in Linear kannst du Aufgaben direkt aus Issues delegieren. Weise Codex ein Issue zu oder erwähne @Codex in einem Kommentar. Codex startet einen Cloud-Chat, berichtet im Issue über den Fortschritt und teilt dort die Ergebnisse.

Codex in Linear ist in kostenpflichtigen Plänen verfügbar (siehe Preise).

Wenn du einen Enterprise-Plan nutzt, bitte die Person, die deinen ChatGPT-Workspace verwaltet, Cloud-Chats für Codex in den Workspace-Einstellungen und Codex for Linear in den Konnektoreinstellungen zu aktivieren.

Linear-Integration einrichten

  1. Richte Cloud-Chats für Codex ein. Verbinde dazu GitHub in Codex und erstelle eine Umgebung für das Repository, in dem Codex arbeiten soll.
  2. Öffne die Codex-Einstellungen und installiere Codex for Linear für deinen Workspace.
  3. Verknüpfe dein Linear-Konto, indem du @Codex in einem Kommentar-Thread zu einem Linear-Issue erwähnst.

Aufgaben an Codex delegieren

Du kannst Aufgaben auf zwei Arten delegieren:

Codex ein Issue zuweisen

Nach der Installation der Integration kannst du Codex genauso Issues zuweisen wie anderen Mitgliedern deines Teams. Codex beginnt mit der Bearbeitung und berichtet im Issue über den Fortschritt.

In Kommentaren @Codex erwähnen

Du kannst @Codex auch in Kommentar-Threads erwähnen, um Aufgaben zu delegieren oder Fragen zu stellen. Sobald Codex antwortet, kannst du denselben Chat mit einer Antwort im Thread fortsetzen.

Sobald Codex mit der Bearbeitung eines Issues beginnt, wählt Codex eine Umgebung und ein Repository aus. Um ein bestimmtes Repository vorzugeben, nenne es in deinem Kommentar, zum Beispiel @Codex behebe das Problem in openai/codex.

So verfolgst du den Fortschritt:

  • Öffne Activity im Issue, um die Fortschrittsmeldungen zu sehen.
  • Öffne den Link zum Chat, um die Bearbeitung im Detail zu verfolgen.

Nach Abschluss der Arbeit veröffentlicht Codex eine Zusammenfassung und einen Link zum abgeschlossenen Chat, damit du einen Pull Request erstellen kannst.

Wie Codex die Umgebung und das Repository auswählt

  • Linear schlägt anhand des Issue-Kontexts ein Repository vor. Codex wählt die Umgebung aus, die am besten zu diesem Vorschlag passt. Ist die Anfrage mehrdeutig, verwendet Codex die Umgebung, die du zuletzt genutzt hast.
  • Codex arbeitet im Chat mit dem Standard-Branch des ersten Repositorys in der Repository-Liste dieser Umgebung. Aktualisiere die Liste in Codex, wenn du ein anderes Repository als Standard festlegen oder weitere Repositorys hinzufügen möchtest.
  • Falls keine geeignete Umgebung oder kein passendes Repository verfügbar ist, erklärt Codex in einer Antwort in Linear, wie du das Problem vor dem nächsten Versuch beheben kannst.

Codex automatisch Issues zuweisen

Mit Triage-Regeln kannst du Codex automatisch Issues zuweisen:

  1. Öffne in Linear Settings.
  2. Wähle unter Your teams dein Team aus.
  3. Öffne in den Workflow-Einstellungen Triage und aktiviere die Funktion.
  4. Erstelle unter Triage rules eine Regel und wähle Delegate > Codex. Lege bei Bedarf weitere Eigenschaften fest.

Linear weist Codex neue Issues automatisch zu, sobald sie in die Triage gelangen. Bei der Zuweisung über Triage-Regeln verwendet Codex für den Chat das Konto der Person, die das Issue erstellt hat.

Datennutzung, Datenschutz und Sicherheit

Wenn du @Codex erwähnst oder Codex ein Issue zuweist, erhält Codex den Inhalt des Issues, um deine Anfrage zu verstehen und einen Chat zu starten. Für die Verarbeitung der Daten gelten die Datenschutzrichtlinie, die Nutzungsbedingungen und weitere anwendbare Richtlinien von OpenAI. Weitere Informationen zur Sicherheit findest du in der Dokumentation zur Sicherheit von Codex.

Codex nutzt große Sprachmodelle, denen Fehler unterlaufen können. Prüfe Antworten und Diffs immer.

Tipps und Fehlerbehebung

  • Fehlende Verbindungen: Wenn Codex deine Verbindung zu Linear nicht bestätigen kann, antwortet Codex im Issue mit einem Link, über den du dein Konto verbinden kannst.
  • Unerwartete Umgebung: Nenne in einer Antwort im Thread die gewünschte Umgebung, zum Beispiel @Codex führe das bitte in openai/codex aus.
  • Falsche Codestelle: Ergänze das Issue um mehr Kontext oder gib in deinem Kommentar an @Codex genaue Anweisungen.
  • Weitere Hilfe: Besuche das Hilfecenter von OpenAI.

Linear für die lokale Arbeit verbinden (MCP)

Wenn du die ChatGPT-Desktop-App, die Codex CLI oder die IDE-Erweiterung verwendest und damit lokal auf Linear-Issues zugreifen möchtest, konfiguriere den Server von Linear für das Model Context Protocol (MCP).

Weitere Informationen findest du in der MCP-Dokumentation von Linear.

Die IDE-Erweiterung und die CLI verwenden dieselbe Konfiguration. Deshalb sind die Schritte zum Einrichten des MCP-Servers in beiden Fällen gleich.

CLI verwenden (empfohlen)

Wenn du die CLI installiert hast, führe diesen Befehl aus:

codex mcp add linear --url https://mcp.linear.app/mcp

Du wirst aufgefordert, dich mit deinem Linear-Konto anzumelden und es mit Codex zu verbinden.

Manuell konfigurieren

  1. Öffne ~/.codex/config.toml in deinem Editor.
  2. Füge folgenden Eintrag hinzu:
[mcp_servers.linear]
url = "https://mcp.linear.app/mcp"
  1. Führe codex mcp login linear aus, um dich anzumelden.