Zum Hauptinhalt springen
How-to

Codex verbinden

Codex startet einen lokalen LightNow-Proxy-Eintrag. LightNow stellt dahinter das ausgewählte Runtime Profile und den Runtime-Kontext bereit.

Vor dem Sync​

Installiere CLI und Proxy, melde dich an und entscheide, ob bestehende Codex-MCP-Einträge übernommen werden müssen.

Installieren und anmelden
brew tap lightnow-ai/tap
brew install lightnow-cli lightnow-proxy
lightnow login
lightnow whoami --json
Optionale Migration
lightnow import-config --client codex --dry-run
lightnow import-config --client codex

Codex synchronisieren​

Empfohlener Local-Proxy-Sync
lightnow sync --client codex --profile default --local-proxy

Die CLI listet direkte MCP-Einträge vor dem Ersetzen auf und fragt nach Bestätigung. Nutze --yes nur in einem bereits geprüften Automationspfad. Starte Codex nach einem erfolgreichen Write neu.

Dateien, die LightNow berührt​

Codex-Config
~/.codex/config.toml
LightNow-Proxy-Config
~/.lightnow/lightnow-proxy/codex.yaml
Backup bei bestehender Codex-Config
~/.codex/config.toml.lightnow.bak

Der verwaltete Codex-Eintrag hat diese Form; der generierte Config-Pfad ist auf dem aktuellen Rechner absolut:

~/.codex/config.toml
[mcp_servers.lightnow]
command = "lightnow-proxy"
args = ["--config", "/Users/you/.lightnow/lightnow-proxy/codex.yaml", "--transport", "stdio"]
default_tools_approval_mode = "approve"

Andere Codex-Einstellungen bleiben in der TOML-Datei. Direkte [mcp_servers.*]-Einträge werden im Local-Proxy-Modus entfernt; Codex' internes node_repl-Plumbing wird bei Posture-Checks ignoriert.

Client-Posture prüfen​

Codex-Datei prüfen, ohne Secrets auszugeben
lightnow config-status --client codex
lightnow config-status --client codex --json
  • managed: LightNow-Eintrag und Proxy-Config sind vorhanden, ohne unerwartete direkte Server.
  • mixed: LightNow ist vorhanden, aber direkte MCP-Einträge können das verwaltete Profil umgehen.
  • missing, invalid oder unreadable: Repariere die Client-Datei, bevor du fortfährst.
  • proxy_config_missing oder eine Warnung zum Executable: Stelle die YAML-Datei wieder her oder installiere lightnow-proxy und wiederhole den Sync.

Runtime Health prüfen​

Profil ohne Codex testen
lightnow-proxy --config ~/.lightnow/lightnow-proxy/codex.yaml --health --json

Healthy bedeutet, dass das ausgewählte Profil geladen wurde und Tool Discovery funktioniert. Degraded oder failed nennt einen Upstream, der untersucht werden muss. Der Check beweist nicht, dass eine laufende Codex-Session ihre Tools neu geladen hat; starte danach eine neue Session.

Organisationsweit verwalteter Sync​

Nach einem erfolgreichen Pilot kann eine Organisation ihre aktive LightNow- Config-Policy Profil, Proxy-Modus, Telemetriepräferenz und den Umgang mit unmanaged Entries wählen lassen:

Aktive Organisations-Policy anwenden
lightnow context --tenant acme
lightnow sync --client codex --from-settings
lightnow config-status --client codex --json

Nutze --from-settings allein; es kann nicht mit --local-proxy oder --runner kombiniert werden.

Troubleshooting​

ReloadCodex zeigt keine LightNow Tools

Starte Codex neu und führe Proxy Health aus, wenn auch die neue Session keine Tools sieht.

DriftStatus ist mixed

Importiere oder entferne den verbleibenden direkten Server und synchronisiere erneut.

PATHProxy-Executable fehlt

Installiere lightnow-proxy, öffne eine neue Shell und wiederhole den Sync.

UpstreamHealth nennt einen fehlerhaften Server

Folge LightNow Proxy debuggen mit diesem Server als engem Ziel.

Verwandte Guides​