# Codex

Codex läuft als CLI, Desktop-App oder VS-Code-Extension, liest die AGENTS.md aus local-configuration direkt und bekommt das Agent-Plugin über seinen Marketplace.

> Source: https://www.application-platform.com/de/docs/codex/

Codex ist der KI-Agent von OpenAI. Du kannst ihn auf drei Wegen nutzen: als CLI im Terminal, als Desktop-App oder als ChatGPT-/Codex-Extension in VS Code, die die Welcome-Seite der Application-Platform-Extension direkt verlinkt. Die [Setup-App]({{< relref "local-app" >}}) installiert CLI und Desktop-Variante im Entwickler-Setup.

## Starten

Für die CLI wechselst du in den Projektordner und rufst `codex` auf. Wie bei jedem Agenten gilt: Öffne den übergeordneten Projektordner, damit alle Repositories und die gemeinsame Konfiguration sichtbar sind.

```bash
cd ~/Documents/application-platform/<organisations-slug>/<projekt-slug>
codex
```

## Vorkonfiguration

Anders als Claude Code braucht Codex keine eigene Anweisungsdatei, sondern liest die `AGENTS.md` direkt. Im Projektordner ist sie ein Symlink auf `local-configuration/AGENTS.md`, dazu kommt das Verzeichnis `.codex/` mit Codex-spezifischer Konfiguration aus demselben Repository. Codex kennt damit von Anfang an die Plattform-Konventionen, etwa dass Anwendungen über `ap run-local` starten, dass `.gitlab-ci.yml` und `env/*.generated.env` von der Plattform verwaltet werden und dass eigene Werte in `env/*.custom.env` gehören. Weil die `AGENTS.md` für alle Agenten gilt, landen eigene Ergänzungen für Codex an derselben Stelle; wie das geht, steht unter [Eigene Regeln für KI-Agenten]({{< relref "ai-instructions" >}}).

## Agent-Plugin über den Marketplace

Codex verwaltet Plugins über Marketplaces und den Dialog `/plugins`. Registriere zuerst den Marketplace des Plugins:

```bash
codex plugin marketplace add doppelt-digital/application-platform-plugin
```

Öffne danach in Codex `/plugins`, wähle **Application Platform** und installiere es. Das Plugin verbindet den MCP-Server `application-platform`, der über `ap mcp serve` läuft, und stellt die Skills für Anmeldung, Projektanlage, Import und lokalen Start bereit. Ist die ap CLI noch nicht angemeldet, führst du `ap login` aus und startest Codex neu. Alle anderen Installationswege, die Liste der MCP-Werkzeuge und die typischen Fehlerbilder stehen unter [CLI und Agent-Plugin]({{< relref "cli-and-agent-plugin" >}}).

Ein Prompt wie „Lege ein neues Application-Platform-Projekt mit einer Flutter-App und einem FastAPI-Backend an und klone es.“ reicht danach; den Ablauf dahinter beschreibt [Neues Projekt anlegen]({{< relref "create-project" >}}).