Add Claude Code GitHub Workflow

[rayopavri]

🤖 Installing Claude Code GitHub App

This PR adds a GitHub Actions workflow that enables Claude Code integration in our repository.

What is Claude Code?

Claude Code is an AI coding agent that can help with:

• Bug fixes and improvements
• Documentation updates
• Implementing new features
• Code reviews and suggestions
• Writing tests
• And more!

How it works

Once this PR is merged, we'll be able to interact with Claude by mentioning @claude in a pull request or issue comment.
Once the workflow is triggered, Claude will analyze the comment and surrounding context, and execute on the request in a GitHub action.

Important Notes

• This workflow won't take effect until this PR is merged
• @claude mentions won't work until after the merge is complete
• The workflow runs automatically whenever Claude is mentioned in PR or issue comments
• Claude gets access to the entire PR or issue context including files, diffs, and previous comments

Security

• Our Anthropic API key is securely stored as a GitHub Actions secret
• Only users with write access to the repository can trigger the workflow
• All Claude runs are stored in the GitHub Actions run history
• Claude's default tools are limited to reading/writing files and interacting with our repo by creating comments, branches, and commits.
• We can add more allowed tools by adding them to the workflow file like:

allowed_tools: Bash(npm install),Bash(npm run build),Bash(npm run lint),Bash(npm run test)

There's more information in the Claude Code action repo.

After merging this PR, let's try mentioning @claude in a comment on any PR to get started!

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
design-md	Ready	Preview, Comment	May 28, 2026 12:13am

[chatgpt-codex-connector]

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: a65d1c8cf8

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

• Open a pull request for review
• Mark a draft as ready
• Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

[chatgpt-codex-connector]

Grant write scopes to handle @claude requests

When an @claude request asks for a reply or code changes, this job's explicitly read-only GITHUB_TOKEN prevents the action from creating/updating comments, branches, commits, or PRs. I checked the new Claude Code workflow plus the Anthropic v1 and GitHub Actions permission docs: Anthropic's examples require contents: write, pull-requests: write, and issues: write, and GitHub caps the token to the values declared in permissions. As written, the run can start and spend tokens but fail at the first write operation.

Useful? React with 👍 / 👎.

[chatgpt-codex-connector]

Grant write scopes so reviews can be posted

On pull_request events this workflow invokes the code-review plugin, which needs to publish PR feedback, but the job token is capped to read-only repository/PR/issue access here. I checked the claude-code-review.yml flow and the Anthropic v1 permission guidance; without at least the documented write scopes for PR/issues (and contents if the action needs to create commits), the review action can analyze the PR but cannot submit or update the review comments it was added to produce.

Useful? React with 👍 / 👎.