Connect GitHub to Claude Code

Watch the step-by-step walkthrough below, then follow along with the guide to link your GitHub account to Claude Code so you can build and push projects directly from your sessions.

Follow the Steps Book Coaching
Step by Step

Connect GitHub to Claude Code

Follow these steps alongside the video to link your GitHub account to Claude Code.

1

Navigate to Settings

2

Select Connectors

3

Find GitHub, select Configure, login and authorise

Need 1-on-1 help with Claude AI?

Book a 90-minute coaching session and we'll build your AI-powered workflow together!

Book a Coaching Session
FAQ

Frequently Asked Questions

Common questions about connecting GitHub to Claude Code.

Why do I need to connect GitHub to Claude Code?

Connecting GitHub lets Claude Code read your existing repositories and push new code and commits directly from a session. Without the GitHub connection, Claude Code can still write code in a temporary Cloud environment, but it cannot persist changes to your repositories or deploy to services like GitHub Pages. The connection is required to build and ship real projects.

What permissions does Claude Code request when I connect GitHub?

Claude Code requests OAuth access to your GitHub account to read repository contents and push commits. During the authorisation step on GitHub, you can choose to grant access to all repositories or restrict it to specific repositories only. Restricting to specific repos is recommended if you want to limit Claude Code's access to just the projects you are actively working on.

Do I need a paid GitHub account to use Claude Code?

No. A free GitHub account is sufficient to connect to Claude Code and host public repositories on GitHub Pages. Paid GitHub plans are only needed if you want private repositories (though GitHub's free tier now includes unlimited private repos) or advanced team features. For most website-building and personal projects, the free tier is all you need.

Can I disconnect GitHub from Claude Code later?

Yes. You can revoke Claude Code's access to GitHub at any time from two places: in Claude Code's Settings → Connectors (remove the connection), and on the GitHub side under Settings → Applications → Authorized OAuth Apps (revoke access). Either approach immediately removes Claude Code's ability to read or push to your repositories.

What happens if I connect GitHub to a new Claude Code session?

Once GitHub is connected at the account level in Settings, the connection is available across all your Claude Code sessions. When you start a new session and select a Cloud environment, you can choose an existing GitHub repository as the working directory. Claude Code will clone it, make changes, and push commits back to GitHub as the session progresses.

Can I use Claude Code with a GitHub organisation repository?

Yes, provided the GitHub organisation allows OAuth app access. During authorisation, you will see an option to grant access to organisations you belong to. Some organisations require an admin to approve third-party OAuth apps — if access is blocked, contact your GitHub organisation admin to approve the Claude Code OAuth application.

Keep Learning

Related Claude AI Tutorials

More step-by-step guides to build and ship projects with Claude Code.

Get Personal Help

Book a 1-on-1 Coaching Session

Need a hands-on walkthrough tailored to your account? Book a 90-minute coaching session and we'll set it up together.