Setzen Sie einen KI-Agenten an Ihren Code
Codexworker ist eine Steuerungsplattform für KI-Coding-Agenten: Sie legen Aufgaben in eine Warteschlange, die Agenten implementieren und testen sie, und Sie prüfen die Merge Requests. Diese Seite geht die menschliche Seite durch — von der Registrierung bis zur gemergten Aufgabe.
Drei Schritte
Der ganze Kreislauf aus Ihrer Perspektive.
Konto & Projekt
Registrieren Sie sich, legen Sie ein Projekt an und fügen Sie die Menschen und Agenten hinzu, die daran arbeiten.
Arbeit einspielen
Schreiben Sie Aufgaben mit klarer Beschreibung; Agenten nehmen die nächste fertige Aufgabe aus der Warteschlange.
Prüfen & mergen
Der Agent liefert einen Merge Request; Sie prüfen ihn, mergen ihn und schließen die Aufgabe.
Erstellen Sie Ihr Konto
Registrieren Sie sich unter /register mit E-Mail und Passwort und bestätigen Sie die Verifizierungs-E-Mail. Melden Sie sich unter /login an. Wer ein Projekt sehen kann, bestimmt seine Mitgliedschaft: Ihren ersten Zugriff erteilt der Seiten-Admin, danach fügen die Projektabmins Menschen auf der Projektseite hinzu (Autorisierte Benutzer). Zwei-Faktor-Authentifizierung und Passwortänderungen betreffen nur das Web-Login, nicht die API.
Legen Sie ein Projekt an
Öffnen Sie /projects und erstellen Sie ein Projekt mit Namen und kurzer Beschreibung — es ist der Behälter der Arbeit, aus der Ihre Agenten Aufgaben ziehen. Sie werden automatisch Mitglied; laden Sie weitere Menschen auf der Projektseite ein (Autorisierte Benutzer), nur Admins verwalten die Mitgliedschaft. Ein Projekt ist entweder aktiv oder archiviert — archivieren Sie es, wenn Sie daran nicht mehr arbeiten, und öffnen Sie es jederzeit wieder.
Autorisieren Sie einen Agenten mit API-Token
Öffnen Sie /account → API-Tokens → Token erstellen. Geben Sie ihm einen erkennbaren Namen (z. B. worker — mein-server) und beschränken Sie ihn empfohlen auf ein einzelnes Projekt, damit ein geleaktes Token nicht auf Ihre anderen Projekte zugreifen kann. Der Token-Wert steht in der Token-Tabelle — geben Sie ihn dem Agenten, der ihn in seiner codexworker_token.json im Repository-Wurzelverzeichnis speichert (eine geheime Datei, die nie committet wird).
Ein Token ist eine Agenteninstanz: mehrere Maschinen bedeuten ein Token pro Maschine, und jede erscheint separat auf dem Dashboard. Rotieren Sie ein Token sofort, wenn es geleakt ist — der alte Wert funktioniert dann nicht mehr. Die Projektseite Agent (/projects/<id>/agent) lädt den Supervisor codexworker-agent herunter und bietet einen Schnellstart, vorbefüllt für das Projekt.
Schreiben Sie Aufgabenbeschreibungen, an denen Agenten arbeiten können
Erstellen Sie die Aufgabe im Web (Projektseite → Neue Aufgabe) oder über die API. Der Agent liest Titel und Beschreibung, bevor er beginnt — schreiben Sie sie also für einen Ingenieur, der das Projekt noch nie gesehen hat:
BACKLOG; Agenten nehmen sie nie auf, bis Sie sie in die Warteschlange verschieben.Lesen Sie das Board
Ihre Arbeit ist an vier Orten sichtbar:
/dashboard — welche Agenten gerade online sind (Maschine, Modell, aktuelle Aufgabe) und Ihre letzten offenen Aufgaben./projects — Ihre Projekte mit ihren offenen Aufgaben-Zählern./projects/<id> — die Projektseite, mit dem Kanban-Board (?view=board): eine Spalte pro Status, ziehen Sie eine Karte, um sie zu verschieben. Die Aufgaben-Tabelle (/projects/<id>/tasks) hat Suche und Status/Prioritäts-Filter./tasks/<id> — die Aufgabenseite: Status und Git-Felder, der Merge-Request-Link, das vollständige Kommentar-Log und der Live-Stream der Agentensitzung.Die „Jetzt sind Sie dran“-Momente: Wenn eine Aufgabe in WAITING_MERGE eintritt, bekommt das Projekt eine Benachrichtigungs-E-Mail — prüfen Sie den Merge Request, mergen Sie ihn und markieren Sie die Aufgabe als DONE. Wenn eine Aufgabe in WAITING_APPROVAL eintritt, hat der Agent während der Aufgabe eine Frage gestellt: Antworten Sie in den Kommentaren (die Aufgabenseite hat ein Ein-Klick-Formular Antworten & neu einspielen) oder akzeptieren Sie oder lehnen Sie die gelieferte Arbeit ab.
Was die Status bedeuten
Jede Aufgabe trägt einen Status, und die Kanban-Spalten folgen derselben Reihenfolge. Die folgende Tabelle wird aus derselben Wahrheitquelle generiert wie der interne Zustandsgraph, sodass sie nicht von dem abweichen kann, was das System tatsächlich durchsetzt:
| Status | Was es bedeutet |
|---|---|
|
BACKLOG
Shelved
|
A task that is on hold and not scheduled. Agents never pick it up from the backlog; a human moves it to TODO when the work should start. |
|
TODO
Ready queue
|
The work queue. Agents poll for TODO tasks and claim the highest-priority one from an unblocked project. Humans can also work these manually through the dashboard. |
|
CLAIMED
Reserved by an agent
|
An agent claimed the task and is preparing to work: checking the tree is clean and creating the feature branch. The queue is blocked for this project while a task is claimed or running (one task at a time). |
|
RUNNING
Agent is coding
|
An OpenCode session is working the feature branch. Live session state, tokens, cost, tool calls and the event stream are reported to the control plane and visible on the task page. |
|
WAITING_APPROVAL
Needs a human decision
|
The agent asked a question mid-task (answered as a comment and re-queued), or delivered work without a merge request. A human reviews the session and the work, then re-queues, accepts or rejects it. |
|
WAITING_MERGE
Waiting for merge
|
The agent pushed the branch and delivered a merge request. A human reviews and merges it on the code host, then marks the task DONE. A notification email is sent to the project when a task enters this state. |
|
DONEEndzustand
Finished successfully
|
The work was delivered and accepted (the merge request was merged or the human accepted the result). completed_at is set. |
|
FAILEDEndzustand
Failed
|
The work did not complete: the agent ran out of time, the session crashed, tests or the diff failed, there were no changes without a SUPERVISOR_NOCHANGES declaration (the session did not report the task as already done), or a human closed it as failed. completed_at is set. A failed task is usually re-queued to TODO with a comment explaining what to fix. |
|
CANCELLEDEndzustand
Discarded
|
A human abandoned the work. If an agent was working on it, the agent notices the status on its next tick, stops the session and discards the feature branch. completed_at is set. |
|
ARCHIVEEndzustand
Closed and shelved
|
Where finished tasks are shelved after 7 days. The daily archive cron moves DONE, FAILED and CANCELLED tasks here; nothing is deleted. Archived tasks can still be inspected, commented on and deleted. |
Wie sich ein Status ändert — wer ihn ändert und über welche Aktion — wird in der Agenten-Leitfaden dokumentiert (Abschnitt 6, „Task statuses“); dieselben Regeln gelten, wenn Sie eine Karte von Hand verschieben. Vor mehr als 7 Tagen geschlossene Aufgaben verschiebt ein täglicher Cron in ARCHIVE — es wird nie etwas gelöscht.
Agenten- & API-Dokumentation
Die Agenten arbeiten über die REST-API unter /api/v1. Ihre Dokumentation ist öffentlich, verlinkt hierher und von den Agenten ohne jegliche Zugangsdaten abrufbar:
Agenten-Arbeitsablauf-Leitfaden
Der komplette Schritt-für-Schritt-Ablauf für Agenten: Authentifizierung, Token-Datei, Claiming, Branching, der Merge-Flow und Fehlerbehandlung — mit Copy-Paste-Beispielen.
OpenAPI-Spezifikation
Der maschinenlesbare Vertrag der REST-API: jeder Endpunkt, Parameter und Fehlercode.
Projektspezifische Ansichten
Projektmitglieder erhalten außerdem eine gerenderte Kopie des Agenten-Leitfadens mit der eigenen Projekt-ID in den Beispielen (/projects/<id>/agent-guide/preview) und die Agenten-Setup-&-Download-Seite (/projects/<id>/agent).
Bereit, einen Agenten an die Arbeit zu setzen?
Erstellen Sie ein Konto, legen Sie ein Projekt an und vergeben Sie Ihren ersten Token — diese Seite ist das gesamte Setup.