docs: document insteadOf git config for private-repo marketplace access

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
This commit is contained in:
sko
2026-07-08 03:32:38 +02:00
co-authored by Claude Opus 4.8
parent 1afb1f58af
commit 239e613100
+17 -6
View File
@@ -5,21 +5,32 @@ und kann einzeln installiert werden — niemand bekommt alles auf einmal.
## Einrichtung (einmalig)
Vollständige Git-URL angeben — die Kurzform `owner/repo` wird von Claude Code
immer als GitHub interpretiert und schlägt bei Gitea fehl.
`/plugin marketplace add` akzeptiert nur `owner/repo` (immer GitHub!), `https://…`
oder einen lokalen `./path`**kein** `ssh://`. Da dieses Repo privat ist und der
Plugin-Clone nicht interaktiv nach Zugangsdaten fragen kann, muss git HTTPS-Zugriffe
auf das Gitea transparent auf SSH umleiten. Einmalig pro Rechner:
```bash
# SSH (empfohlen, für private Repos nötig)
/plugin marketplace add ssh://gitea@gitea.inmedias.it:2222/inmedias.it/claude-plugins.git
# 1. git so konfigurieren, dass https auf dieses Gitea über SSH (Key) läuft
git config --global url."ssh://gitea@gitea.inmedias.it:2222/".insteadOf "https://gitea.inmedias.it/"
# oder HTTPS (nur wenn Repo öffentlich lesbar)
# 2. Marketplace mit der HTTPS-URL hinzufügen (klont real über SSH)
/plugin marketplace add https://gitea.inmedias.it/inmedias.it/claude-plugins.git
```
Voraussetzung: dein Gitea-SSH-Key ist auf Port 2222 eingerichtet.
> Hinweis: Die `insteadOf`-Regel gilt für **alle** git-Operationen auf
> `gitea.inmedias.it`, nicht nur für Plugins.
>
> Alternative ohne git-Config: Repo `inmedias.it/claude-plugins` intern/öffentlich
> lesbar machen — dann reicht die HTTPS-URL direkt (SSH-Key trotzdem für Push nötig).
## Plugin installieren
```bash
/plugin install gitea-tea
/plugin install gitea-tea@inmedias-claude-plugins
/reload-plugins
```
Verfügbare Plugins listet `/plugin` bzw. `marketplace.json`.