Available on all plans including Free. All Claude integrations are currently in beta.
Adding GitHub repositories
In chats
- Click the ”+” button in the lower left corner of the chat interface
- Select “Add from GitHub” from the dropdown menu
- Use the file browser to select specific files and folders
- When sending your message, Claude accesses and processes the selected content
In projects
- Click the ”+” button in your project knowledge section
- Select “GitHub” from the dropdown
- Search accessible repositories or paste a repository URL
- Use the file browser to select specific files and folders
- Your selected content is added to project knowledge
- Use the “Sync” icon to ensure you’re working with the latest codebase
- Use the “Configure files” icon to modify which files Claude analyzes
If you’re not authenticated with GitHub, you’ll be redirected to authenticate before using the integration.
Connecting to private repositories
If you see a warning after entering a valid URL, you’re likely attempting to connect to a private repository. Follow the link to the GitHub App where you can:- Grant access yourself: Choose between allowing Claude access to all repos or specific ones
- Request access: GitHub organization administrators receive an email notification. Once approved, you can sync and access the repository
Best practices
- Start small: Begin with a small codebase subset to understand how Claude interprets your code
- Iterate and refine: Ask follow-up questions if initial responses need clarification
- Combine with human expertise: Use Claude’s insights as a starting point for team discussion
- Thoughtful file selection: Include key files central to your task while staying within token limits
- Regular updates: Refresh GitHub sync periodically, especially before new analysis or major repo changes
What information is retrieved
| Retrieved | Not Retrieved |
|---|---|
| File names | Commit history |
| File contents | Pull requests |
| Branch content | Issues |
| Repository metadata |
Frequently asked questions
What if my repository updates after adding it?
What if my repository updates after adding it?
Click “Sync now” to fetch the latest changes from your repository.
Can I add multiple repositories?
Can I add multiple repositories?
Yes, add multiple repositories to provide comprehensive context, provided they fit within Claude’s context window.
What happens if I lose repository access?
What happens if I lose repository access?
You won’t be able to view its contents in projects where it was previously added. The repository preview is removed, but conversation history remains.