# Claude Code

Claude Code arbeitet im Terminal oder als Desktop-App, liest CLAUDE.md und .claude aus local-configuration und bekommt das Agent-Plugin über seinen Marketplace.

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

Claude Code ist der KI-Agent von Anthropic. Er liest dein Projekt, schreibt Änderungen und führt Befehle aus, wahlweise als CLI im Terminal oder als Desktop-App mit derselben Konfiguration. Die [Setup-App]({{< relref "local-app" >}}) installiert beide Varianten im Entwickler-Setup und öffnet Projekte per Klick darin.

## Starten

Starte Claude Code im übergeordneten Projektordner, nicht in einem einzelnen Repository. Nur dort liegen `CLAUDE.md` und `AGENTS.md`, und nur dort kennt der Agent Backend, App und Konfiguration gleichzeitig.

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

## Vorkonfiguration

Claude Code liest beim Start automatisch die `CLAUDE.md` aus dem aktuellen Ordner. Im Projektordner ist sie ein Symlink aus `local-configuration` und verweist auf die zentrale `AGENTS.md`, ergänzt um Hinweise, die nur Claude Code betreffen. Dazu kommt das Verzeichnis `.claude/` mit Claude-spezifischer Konfiguration, ebenfalls aus `local-configuration`. Dadurch hält sich der Agent ohne weiteres Zutun an die Plattform-Regeln: Anwendungen über `ap run-local` starten, `.gitlab-ci.yml` und `env/*.generated.env` nicht anfassen, eigene Werte in `env/*.custom.env`, keine Secrets in Commits oder Antworten. Wenn du diese Regeln um eigene ergänzen willst, tust du das in `local-configuration`, wie unter [Eigene Regeln für KI-Agenten]({{< relref "ai-instructions" >}}) beschrieben; die `CLAUDE.md` selbst bleibt der Verweis.

## Agent-Plugin über den Marketplace

Damit Claude Code Projekte in deinem Account anlegen und bestehende Ordner importieren kann, installierst du das Agent-Plugin über den Marketplace von Claude Code:

```bash
claude plugin marketplace add doppelt-digital/application-platform-plugin
claude plugin install application-platform@application-platform --scope user
```

Das Plugin registriert den MCP-Server `application-platform` über die ap CLI und bringt die Skills und Slash-Commands für Anmeldung, Projektanlage und Import mit. Nach der Installation startest du Claude Code neu und meldest dich mit `ap login` an, falls das noch nicht passiert ist. Die weiteren Installationswege, die MCP-Werkzeuge und die Fehlerbilder stehen unter [CLI und Agent-Plugin]({{< relref "cli-and-agent-plugin" >}}).

Danach genügt im Projektordner ein Prompt wie „Importiere dieses Projekt in meinen Application-Platform-Account.“ oder „Starte das Backend lokal.“ Was der Agent beim Import genau tut, steht unter [Bestehendes Repository importieren]({{< relref "agent-project-import" >}}).