Codex AGENTS.md: Einheitliche Anweisungen auf dem VPS

Codex AGENTS.md: Einheitliche Anweisungen auf dem VPS — Codex AGENTS.md auf dem VPS zuverlässig nutzen: Suchreihenfolge, Überschreibungen und Arbeitsverzeichnis verstehen und vor unbeaufsichtigten Läufen prüfen.
17. Nov. 20264 Min. Lesezeit
Share with

Eine Codex-Aufgabe verhält sich auf unserem Laptop anders als auf dem VPS. Das Repository ist identisch, aber der Agent startet in einem anderen Verzeichnis und übernimmt andere kontoweite Anweisungen. Eine Wiederholung des Prompts behebt diesen Unterschied nicht.

Wir behandeln Codex AGENTS.md als versionierte Arbeitsanweisung, nicht als magische Gedächtnisdatei. So machen wir den Geltungsbereich vor unbeaufsichtigten Aufgaben nachvollziehbar. Das ist ein manueller Codex-Ablauf, keine neue Konfigurationsfunktion von Office Claws.

Codex AGENTS.md: Was auf dem Runner geladen wird

Die offizielle Anleitung beschreibt eine beim Start aufgebaute Anweisungskette. Das Startverzeichnis zählt: Eine Datei irgendwo im Repository gehört nicht automatisch zur anfänglichen Kette.

EbeneSucheBetriebliche Folge
Codex-HomeAGENTS.override.md, sonst AGENTS.md; erste nicht leere DateiDas VPS-Konto kann zusätzliche Regeln enthalten
Projektwurzel bis ArbeitsverzeichnisEine Datei je Verzeichnis: Override, normale Datei, konfigurierte ErsatznamenDer Start im Dienstverzeichnis lädt eine andere Kette als der Start in der Wurzel
Zusammengeführte AnweisungenVon der Wurzel abwärts; nähere Regeln haben VorrangEine lokale Ausnahme kann einen allgemeinen Standard ändern

Das Standardlimit für kombinierte Projektdokumente beträgt 32 KiB. Anweisungen sollten kurz bleiben; bei Kürzungen prüfen wir project_doc_max_bytes. Ein Override ersetzt die normale Datei im selben Verzeichnis, nicht alle vorherigen Ebenen. Standardmäßig ist das Home ~/.codex; CODEX_HOME kann es ändern.

Anweisungskette von Kontostandards über Repository bis zum Dienst

Starte deinen ersten Agenten in etwa 3 Minuten

Installiere die Office Claws CLI, verbinde dein Contabo-Konto und dein Codex-Abo – dein Agent bekommt einen eigenen VPS und einen Schreibtisch im Büro.

curl -fsSL https://officeclaws.com/downloads/install.sh | sh

$4.99/Monat + dein eigener Contabo-VPS · Schlüssel bleiben in deinem Schlüsselbund

Einen Arbeitsvertrag statt eines Repository-Handbuchs schreiben

Stabile gemeinsame Regeln gehören in die Projektwurzel, dienstspezifische Befehle zum Dienst. Wir kopieren nicht das gesamte Architektur-Wiki in das Prompt-Budget, sondern nennen das relevante Dokument und die damit unterstützte Entscheidung.

Für ein Repository, dessen Testbefehl tatsächlich npm test ist, eignet sich diese kleine Vorlage für die Wurzeldatei. Vor dem Commit an das echte Projekt anpassen. Das Beispiel erteilt keine Berechtigungen und richtet keine Automatisierung ein.

# AGENTS.md
 
## Scope
- Work only on the assigned branch and requested change.
- Read docs/development.md before changing build configuration.
 
## Verification
- Run npm test after code changes; report the command and result.
- If a check cannot run, report the blocker instead of claiming success.
 
## Review boundary
- Do not deploy, publish packages, or rotate credentials.
- Flag authentication and migration changes for human review.

Die Anweisungsdatei wird wie Code versioniert. Auch der Wechsel von „Migration vorschlagen“ zu „Migration ausführen“ verdient eine Prüfung, selbst ohne Änderung am Anwendungscode. Tokens, Passwörter und private Kontodaten gehören nicht hinein: Repository-Anweisungen werden an das Modell übermittelt und sind kein Geheimnisspeicher.

Denselben Geltungsbereich über SSH prüfen

Auf dem VPS verwenden wir dasselbe Unix-Konto, denselben Checkout, dasselbe Arbeitsverzeichnis und dasselbe Codex-Profil wie für die echte Aufgabe. Eine Administratorshell beweist nichts über die Konfiguration eines Dienstkontos. Die Verbindung erklärt unser SSH-Leitfaden.

Diese schreibgeschützte Vorprüfung startet in der vertrauenswürdigen Repository-Wurzel. Den Pfad durch den eigenen Checkout ersetzen. Sie listet Kandidaten auf, beweist aber nicht, dass alle geladen werden. Wir vergleichen die Liste mit den Regeln oben und der Agentenantwort. Der letzte Befehl nutzt Modellzugriff und kann das Plankontingent belasten.

cd ~/work/product-api
pwd
git rev-parse HEAD
codex --version
printf 'CODEX_HOME=%s\n' "${CODEX_HOME:-$HOME/.codex}"
find . -type d -name .git -prune -o -type f \
  \( -name AGENTS.md -o -name AGENTS.override.md \) -print
codex exec --sandbox read-only \
  "Do not edit files or execute project commands. List the instruction sources you loaded and summarize the verification and review boundaries."

Kontoweite Dateien separat prüfen, ohne ihren Inhalt in gemeinsame Protokolle zu kopieren. Auch konfigurierte Ersatznamen beachten: find listet oben bewusst nur die zwei Standardnamen auf. Die Zusammenfassung des Modells ist ein nützlicher Plausibilitätstest, kein formelles Audit und keine Sicherheitsgarantie.

Gehört die Aufgabe in einen verschachtelten Dienst, wiederholen wir die Prüfung dort. Nach Änderungen an den Anweisungsdateien einen neuen Lauf starten: Die dokumentierte Kette wird einmal pro Lauf aufgebaut, nicht laufend in eine bestehende Sitzung nachgeladen.

Anweisungen und Durchsetzung trennen

Der Satz „nicht bereitstellen“ in AGENTS.md ist keine Zugriffskontrolle. Zugangsdaten und Werkzeuge separat beschränken und passende Sandbox- und Freigabeeinstellungen verwenden. Ein Nacht-Runner sollte keine Produktionszugänge erhalten, nur weil seine Anweisungen deren Verwendung untersagen.

Vor unbeaufsichtigter Arbeit erfassen wir Commit, Codex-Version, Arbeitsverzeichnis und Revision der Anweisungsdateien. Bei parallelen Agenten prüfen wir jeden Checkout, statt die Verteilung einer lokalen Änderung vorauszusetzen. Bei Abweichungen zuerst Konto-Home, CODEX_HOME, Overrides, Ersatznamen und Startverzeichnis prüfen, dann erst den Aufgaben-Prompt ändern.

Office Claws betreibt Codex-Agenten auf dem eigenen Contabo VPS mit CLI und Pixel-Art-Desktop. Repository-Anweisungen und Ergebnisprüfung bleiben unsere Verantwortung. Office Claws beginnt bei $4.99/Monat für den ersten Agenten; VPS und unterstützter ChatGPT-Plan kommen separat hinzu. Nutzungslimits gelten weiterhin. Mehr dazu unter Codex-Abokosten.

Unsere Empfehlung: einen kleinen Arbeitsvertrag versionieren, unter dem tatsächlichen Runner-Konto prüfen und die menschliche Freigabe behalten. Dauerbetrieb soll den Ablauf reproduzierbar machen, nicht eine Textdatei zur Berechtigungsgrenze erklären.

Autor

Office Claws Team

Wir gestalten die Zukunft des KI-Agenten-Managements bei Office Claws. Einblicke in Infrastruktur, Sicherheit und Entwicklererfahrung.

Starte deinen ersten Agenten in etwa 3 Minuten

Installiere die Office Claws CLI, verbinde dein Contabo-Konto und dein Codex-Abo – dein Agent bekommt einen eigenen VPS und einen Schreibtisch im Büro.

curl -fsSL https://officeclaws.com/downloads/install.sh | sh

$4.99/Monat + dein eigener Contabo-VPS · Schlüssel bleiben in deinem Schlüsselbund