Gå til hovedinnhold

Claude Code

Claude Code er Anthropics kodeassistent for kommandolinjen. Den trenger to ting fra fremforge: Git-tilgang over HTTPS for å klone repositoryer, og et Git-tilgangstoken for operasjoner på issues og pull requests. fremforges MCP-server er valgfri og tar imot et eget API-token for fremforge (ffp_…): Git-tilgangstokenet er for repositoryer, issues og pull requests, API-tokenet for fremforges egne data som funn og komponenter.

Oppsett i ett steg

# 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>"

MCP-serveren trenger et API-token for fremforge med lese-scopene til verktøyene du bruker. Se Ekstern MCP-server for listen over verktøy, scopene og andre klienter. (Denne siden nevnte tidligere en npm-pakke som het @fremforge/mcp-server. Den pakken ble aldri publisert; den eksterne serveren erstatter den.)

Hvis du heller vil at Claude Code skal bruke REST-API-et direkte uten en MCP-server, legger du en CLAUDE.md i roten av repositoryet:

# 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 leser CLAUDE.md som prosjektkontekst.

Kontroller

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

Dette skal skrive ut <org>/<repo>. Får du 401 eller 404, kontrollerer du tokenet og scopene på nytt.

Hva du kan gjøre fra Claude Code

HandlingToken og scope
Lese filer i repositoryer, søke på tvers av repositoryerGit-tilgangstoken: read:repository
Opprette / oppdatere pull requests, pushe brancherGit-tilgangstoken: write:repository
Lese / søke i / kommentere issuesGit-tilgangstoken: read:issue, write:issue
Lese revisjonsloggen til organisasjonen dinAPI-token for fremforge: audit:read
Opprette eller tilbakekalle dine egne API-tokenerAPI-token for fremforge: tokens:manage

Om suverenitet

Når Claude Code leser koden din og sender den til Anthropics API, er det en sak mellom deg og Anthropic; fremforge er ikke en del av den veien. Git-tilgangstokenet og API-tokenet for fremforge brukes bare til Git og REST-tilgang, og gir aldri Claude Code fullmakt til å kalle noen AI-leverandør på vegne av fremforge.

Vil du ha AI-funksjonene på serversiden (PR-gjennomgang ved hver push, /ai/complete fra workflower), er det et eget oppsett; se tillitssiden om AI-integrasjoner.