Claude Code

Claude Code ist der CLI-Coding-Assistent von Anthropic. Von fremforge braucht er zwei Dinge: Git-Zugriff über HTTPS, um Repositorys zu klonen, und ein Git-Zugriffstoken für Issues und Pull Requests. Der MCP-Server von fremforge ist optional und nimmt ein separates fremforge-API-Token (ffp_…) an: Das Git-Zugriffstoken ist für Repositorys, Issues und Pull Requests, das API-Token für die eigenen Daten von fremforge wie Befunde und Komponenten.

Einrichtung in einem Schritt

# 1. Mint a Git access token at frem.sh/user/settings#ff-git-pats with these scopes:
#      read:repository  write:repository  read:issue  write:issue
#    Copy the token.

# 2. Tell Git Credential Manager about it so HTTPS clones don't prompt:
export FREMFORGE_GIT_TOKEN='<your-git-token>'
git config --global credential.https://frem.sh.helper '!f() { echo username=token; echo password=$FREMFORGE_GIT_TOKEN; }; f'

# 3. Connect Claude Code to fremforge's remote MCP server (fremforge API token, not the Git access token):
claude mcp add --transport http fremforge https://frem.sh/_app/mcp \
  --header "Authorization: Bearer ffp_<your-token>"

Der MCP-Server braucht ein fremforge-API-Token mit den Lese-Scopes der Tools, die du verwendest. Die Tool-Liste, die Scopes und weitere Clients findest du unter Remote-MCP-Server. (Früher nannte diese Seite ein npm-Paket @fremforge/mcp-server. Dieses Paket wurde nie veröffentlicht; der Remote-Server ersetzt es.)

Soll Claude Code stattdessen ohne MCP-Server direkt die REST-API nutzen, lege eine CLAUDE.md im Wurzelverzeichnis deines Repositorys ab:

# fremforge config

Repositories, issues, PRs: https://frem.sh/api/v1 (Forgejo API)
Auth header:   Authorization: token $FREMFORGE_GIT_TOKEN
fremforge API: https://frem.sh/_app/api/v1 (findings, components, policies)
OpenAPI spec:  https://docs.frem.sh/api/openapi.yaml
Auth header:   Authorization: Bearer $FREMFORGE_TOKEN (an ffp_… API token)

Claude Code liest CLAUDE.md als Projektkontext ein.

Prüfen

curl -sf https://frem.sh/api/v1/repos/<org>/<repo> -H "Authorization: token $FREMFORGE_GIT_TOKEN" | jq .full_name

Das sollte <org>/<repo> ausgeben. Kommt eine 401 oder 404 zurück, prüfe das Token und seine Scopes.

Was du mit Claude Code tun kannst

Aktion	Token und Scope
Dateien im Repository lesen, über Repositorys hinweg suchen	Git-Zugriffstoken: `read:repository`
Pull Requests anlegen und aktualisieren, Branches pushen	Git-Zugriffstoken: `write:repository`
Issues lesen, durchsuchen und kommentieren	Git-Zugriffstoken: `read:issue`, `write:issue`
Das Audit-Log deiner Organisation lesen	fremforge-API-Token: `audit:read`
Eigene API-Token erstellen oder widerrufen	fremforge-API-Token: `tokens:manage`

Hinweis zur Souveränität

Wenn Claude Code deinen Code liest und an die API von Anthropic sendet, ist das eine Sache zwischen dir und Anthropic – fremforge ist nicht beteiligt. Dein Git-Zugriffstoken und dein fremforge-API-Token dienen ausschließlich dem Zugriff auf Git und die REST-API; sie berechtigen Claude Code nie, im Namen von fremforge einen KI-Anbieter aufzurufen.

Die serverseitigen KI-Funktionen (PR-Review bei jedem Push, /ai/complete aus Workflows) richtest du separat ein, siehe die Trust-Seite zu KI-Integrationen.

Cursor