# Codex

Codex läuft als CLI, Desktop-App oder VS-Code-Extension und bekommt Skills, Regeln und MCP über mp agent install.

> Source: https://www.mainpath.ai/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 MainPath-Extension direkt verlinkt. Die [MainPath Toolbox]({{< 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 sichtbar sind.

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

## Vorkonfiguration

MainPath-Regeln kommen aus dem Agent-Plugin der mp CLI. `mp agent install` legt Plugin und Skills unter `~/.codex/` ab und schreibt den MCP-Server `application-platform` in `~/.codex/mcp.json`. Codex kennt damit von Anfang an die Plattform-Konventionen: Anwendungen starten über `mp run-local`, `.gitlab-ci.yml` und `env/*.generated.env` verwaltet MainPath, eigene Werte gehören in `env/*.custom.env`. Projekt-eigene Ergänzungen landen in einer `AGENTS.md` im Anwendungs-Repository, siehe [Eigene Regeln für KI-Agenten]({{< relref "ai-instructions" >}}).

## Agent-Plugin installieren

```bash
mp agent install
mp login
```

Ein eigener Marketplace-Eintrag ist nicht nötig. Ist die mp CLI noch nicht angemeldet, führst du `mp login` aus und startest Codex neu. Alle 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 MainPath-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" >}}).