This is the manual setup you need to do once per repository so that Claude can respond to @claude mentions in GitHub issues, PR comments, and reviews. After this, you can collaborate with Claude from any browser without needing Claude Code running locally.

The workflow file .github/workflows/claude.yml is already committed in every project. This doc covers the GitHub-side configuration you need to do.

Repositories that need this

| Repo | App installed? | Workflow file present? | API key configured? | |------|----------------|------------------------|---------------------| | mahmoudholding/mahmoud-consultancy | ❓ | ✅ (committed by this audit) | ❓ | | mahmoudholding/europeLogin | ❓ | ✅ (committed by this audit) | ❓ | | mahmoudholding/auditPic | ❓ | ✅ (pre-existing) | ❓ | | mahmoudholding/claimio | ❓ | ✅ (committed by this audit) | ❓ | | mahmoudholding/valideerleeftijd | ❓ | ✅ (committed by this audit) | ❓ | | mahmoudholding/developer-portal | ❓ | ✅ (committed by this audit) | ❓ |

Tick each cell as you complete the steps below. Workflow files added by this audit run will appear once the audit branch is merged.

Step 1 — Install the Claude GitHub App

Go to https://github.com/apps/claude
Click Install (or Configure if already partially installed under your account)
Choose Only select repositories and tick all six repos above
Approve the requested permissions:
- Read & write access to: code, issues, pull requests, workflows
- Read access to: metadata, actions

You can also install at the organization level (mahmoudholding) to cover all repos in one shot — recommended.

Step 2 — Add the `ANTHROPIC_API_KEY` secret

The workflow uses your Anthropic API key (not a Claude Pro subscription).

Get an API key from https://console.anthropic.com/settings/keys (create one named github-actions if it doesn't exist)
Per repo OR once at the org level (recommended):
- Org level: https://github.com/organizations/mahmoudholding/settings/secrets/actions → New organization secret
  - Name: ANTHROPIC_API_KEY
  - Value: your key
  - Repository access: "Selected repositories" → tick all six
- Per repo: each repo → Settings → Secrets and variables → Actions → New repository secret with the same name/value

Step 3 — Verify

After installation:

Open any open issue in any of the six repos.
Comment @claude what is the current branch?
Within ~60 s the Claude GitHub App should react with an eyes 👀 emoji, then post a reply.
If nothing happens, check the Actions tab for the Claude Code workflow run — failures usually mean the secret is missing or the app lacks permissions.

How to use Claude from GitHub

Once set up, mention @claude in any of these contexts and Claude will pick up the work:

| Context | What you can ask | |---------|------------------| | New issue body | "@claude implement this" — Claude opens a PR with the change | | Issue comment | "@claude can you investigate this?" — Claude posts a reply | | PR comment | "@claude rebase onto develop" — Claude pushes the rebased branch | | PR review comment (line-level) | "@claude apply this suggestion" — Claude commits the fix | | PR review | "@claude address all comments" — Claude commits fixes for the whole review |

The workflow is intentionally limited to comments containing the literal string @claude — Claude will not respond unless you mention it.

Cost & limits

Each @claude invocation runs an agent that consumes Anthropic API credits from your account
The workflow has permissions: contents: write, pull-requests: write, issues: write — Claude can push to branches and edit PRs/issues, but not to protected branches (main/develop) without going through a PR
The official action documentation: https://github.com/anthropics/claude-code-action

Troubleshooting

Workflow runs but Claude says nothing: secret ANTHROPIC_API_KEY is missing or invalid. Check Actions log.
@claude mention doesn't trigger the workflow: the GitHub App isn't installed on the repo, or the workflow file isn't on the branch.
Claude pushes commits that fail CI: check the workflow's permissions: block and the branch protection rules — Claude can't bypass required status checks (which is good).
Resource not accessible by integration: the app needs additional permissions; re-install via Step 1 to refresh granted scopes.

Reacties

Nog geen reacties

Athena — claude-github-app-setup.md

Claude GitHub App — One-Time Setup per Repository