How can open source maintainers use Claude Code?
Open source maintainers use Claude Code to triage issues, reproduce bug reports, review contributor pull requests, write release notes and keep docs in step with code. It runs locally in your terminal or desktop app, and it can also run in your repository through GitHub Actions when someone with write access mentions @claude.
The goal is not to hand the project to an agent. It is to take the repetitive work off your plate so your attention goes to design decisions and people. Anthropic's overview lists exactly this kind of work: "writing tests for untested code, fixing lint errors across a project, resolving merge conflicts, updating dependencies, and writing release notes."
Can maintainers get Claude Code for free?
Possibly. Anthropic's Claude for Open Source program offers "6 months of free Claude Max 20x" to eligible maintainers and contributors, and Claude Max includes Claude Code. The page lists five groups, with its exact wording in quotes:
| Category | Criteria on Anthropic's page |
|---|---|
| Maintainers and library authors | "500 or more dependent repos, 100 or more dependent packages" or "200,000 or more combined monthly downloads across any registry" |
| Core contributors | A listed committer or maintainer on a recognized foundation or language project |
| Active contributors | "100 or more pull requests merged into repos you don't own in the last 12 months" |
| Community builders | A repo with "20 or more unique external contributors with merged pull requests in the last 12 months" |
| Critical infrastructure | A repo with "an OpenSSF criticality score of 0.4 or above" |
If you don't fit, the page says: "If you maintain something the ecosystem quietly depends on, apply anyway and tell us about it." When the six months end, a previous paid plan resumes at your prior rate unless you cancel, and otherwise the account returns to the free plan.
OpenAI runs a similar Codex for Open Source program, offering "Six months of ChatGPT Pro with Codex" plus API credits for projects that use Codex in pull request review, maintainer automation, release workflows or other core open source work.
What maintainer work can Claude Code take on?
- Issue triage. Install the
ghCLI. Anthropic's best practices say Claude "knows how to use it for creating issues, opening pull requests, and reading comments." Ask Claude to read new issues, find duplicates, reproduce bugs and draft replies. - Reproducing bug reports. Ask for a failing test that matches the report before anyone writes a fix. The testing guide covers this loop.
- Reviewing contributor PRs. Run
/code-review 1234to review a pull request by number in your own session. It works on any plan and checks for correctness bugs./security-reviewchecks your branch's changes for vulnerabilities such as injection and auth issues. - Release notes and changelogs. Pipe history into Claude, for example
git log --oneline -20 | claude -p "summarize these recent commits", an example from Anthropic's common workflows. - Dependency updates and merge conflicts. Both appear in Anthropic's list of tedious tasks Claude Code handles.
- Keeping ports in sync. Anthropic's scheduled tasks page (a research preview feature) describes a "Library port" example: a GitHub trigger on merged PRs in one SDK repository ports each change to a parallel SDK in another language and opens a matching PR.
Anthropic's best practices also include a sample skill that turns issue fixing into one command. This is their example:
---
name: fix-issue
description: Fix a GitHub issue
disable-model-invocation: true
---
Analyze and fix the GitHub issue: $ARGUMENTS.
1. Use `gh issue view` to get the issue details
2. Understand the problem described in the issue
3. Search the codebase for relevant files
4. Implement the necessary changes to fix the issue
5. Write and run tests to verify the fix
6. Ensure code passes linting and type checking
7. Create a descriptive commit message
8. Push and create a PR
Save it as .claude/skills/fix-issue/SKILL.md and run /fix-issue 1234. The disable-model-invocation: true line means only you can start it, which suits a workflow that pushes code.
How do you set up @claude in your repository?
Run /install-github-app in your repo. According to Anthropic's GitHub Actions docs, it installs the Claude GitHub App, saves your credential as a repository secret, pushes a branch with the workflow files and opens GitHub with a pull request ready to create. You need admin access, and it works only with github.com repositories. After merging, anyone with write access can comment @claude on an issue or PR.
Points that matter for public projects:
- Write access is required. On issue and pull request events, the triggering user must have write access. Drive-by commenters can't start runs.
- Bots are blocked by default. The action rejects bot actors unless listed in
allowed_bots, which stops loops. - Fork PRs don't get secrets. On public repositories, GitHub withholds secrets from runs triggered by fork pull requests, so the review workflow runs only on PRs from branches in the same repository. Review fork PRs locally with
/code-review. - Costs come from two places. Each run uses GitHub Actions minutes and model tokens. The docs suggest setting
--max-turnsinclaude_args, workflow timeouts and concurrency limits. - Managed Code Review is a team product. Anthropic's automatic Code Review service is for Team and Enterprise plans. Individual maintainers can use the review workflow or
/code-reviewinstead. The Claude Code review guide compares them.
How do you handle untrusted contributions safely?
Every issue, comment and pull request from a stranger is input you didn't write, and some of it may be written to steer an agent. The action's security documentation says: "Beware of potential hidden markdown when tagging Claude on untrusted content." It strips some hidden content, but adds: "We recommend reviewing the raw content of all input coming from external contributors before allowing Claude to process it."
- Avoid
allowed_non_write_users. The security docs call it "a significant security risk" that should only be used for workflows with extremely limited permissions, such as issue labeling. - Filter who reaches Claude.
include_comments_by_actorallowlists whose comments are passed to Claude on public repos. - Keep full output off. If you turn on
show_full_output, the docs warn: "These logs are publicly visible in GitHub Actions for public repositories!" - Keep humans on merge. By default the action commits to a branch and gives a link, and "The user must click the link and create the PR themselves."
- Locally, keep prompts on. Anthropic's security page recommends reviewing suggested commands before approval and avoiding piping untrusted content directly to Claude. Check out unfamiliar PRs in a container; see the devcontainer guide and the prompt injection guide.
Which prompts work well for maintainers?
These are example prompts written for this guide.
Use gh to list issues opened in the last 7 days. For each, say whether it is a bug, a feature request, a question or a duplicate (link the original), and draft a short, friendly reply. Do not post anything.
Issue 812 reports a crash when the config file is empty. Reproduce it with a failing test, then propose the smallest fix. Show me the test output before and after.
/code-review 1234
Read the commits since the last tag and draft release notes grouped into Features, Fixes and Breaking changes. Credit each contributor by GitHub username and flag anything that needs a migration note.
Which skills and tools help?
| Need | Skill or tool | Notes |
|---|---|---|
| Issue triage | triage skill | Moves issues and PRs through labelled states |
| PR review | code review skill, find bugs | Community review skills |
| Security review | differential review | Trail of Bits' security-focused review |
| Commits | git commit skill | Conventional Commits from your diff |
| Decisions | documentation and ADRs | Records why a change was made |
| Automation | Claude Code GitHub Actions | @claude in issues and PRs |
| Recurring jobs | scheduled tasks | Nightly triage or weekly docs checks |
Other agents have equivalents. OpenAI's Codex GitHub Action can post reviews from CI; see the Codex GitHub Action guide. Cursor's Bugbot "reviews pull requests and identifies bugs, security issues, and code quality problems," covered in the Bugbot guide.
How do you share maintainer prompts with co-maintainers?
Triage replies, review checklists and release note prompts get better as the project grows, so keep them versioned. Kipt stores prompts and Agent Skills as Markdown in a private GitHub repo you own, with {{name}} blanks for the issue number or version, and installs your skills into Claude Code or Codex with npx skills add. The free SKILL.md generator turns a prompt into a skill folder you can commit to the project's .claude/skills/.