Muốn hỏi Claude về một dự án code, bạn không cần chép từng file vào khung chat nữa. GitHub Integration cho phép bạn đưa cả kho mã (repository) vào cuộc trò chuyện, hoặc chọn từng file, thư mục vào Project, để Claude đọc code và trả lời dựa trên đúng mã nguồn của bạn. Bài này hướng dẫn cách kết nối, cách thêm repo, cách xử lý repo riêng tư và vài lỗi thường gặp.
GitHub Integration làm được gì?
Tích hợp này giúp Claude đọc mã nguồn để giải thích, tìm lỗi, gợi ý cải tiến hoặc trả lời câu hỏi phát triển phần mềm. Nó dùng được với repo công khai và repo riêng tư mà bạn đã cấp quyền. Claude chỉ lấy tên file và nội dung file trên một nhánh cụ thể:
| Claude lấy | Claude không lấy |
|---|---|
| Tên file | Lịch sử commit |
| Nội dung file | Pull request |
| Nội dung của nhánh | Issue |
| Metadata của repo |
Nói cách khác, đây là công cụ để đọc và phân tích. Nếu bạn muốn Claude sửa code, chạy lệnh hay mở pull request, công cụ phù hợp là Claude Code, được giới thiệu ở Module 11, bắt đầu từ bài Ngày đầu tiên với Claude Code.
Bước 1: Kết nối tài khoản GitHub
- Vào Customize → Connectors.
- Trong mục Your connectors, chọn GitHub Integration.
- Bấm Connect và đăng nhập GitHub khi được chuyển sang trang của GitHub.
Ở gói Team và Enterprise, mục GitHub Integration chỉ xuất hiện khi tổ chức đã bật GitHub. Nếu không thấy, hãy nhờ người quản lý cài đặt tổ chức bật nó trong Organization settings → Connectors.
Bước 2: Thêm repo vào cuộc trò chuyện
- Trong khung chat, bấm + ở góc dưới bên trái ô nhập tin nhắn.
- Chọn Add from GitHub. Lựa chọn này chỉ hiện sau khi bạn đã kết nối GitHub.
- Tìm trong danh sách repo bạn có quyền, hoặc dán đường link repo.
- Bấm Add repository, rồi gửi câu hỏi của bạn.
Prompt mẫu: “Đọc repo này và giải thích cho tôi luồng đăng nhập người dùng hoạt động thế nào, file nào xử lý phần kiểm tra
mật khẩu. Viết ngắn gọn, dành cho lập trình viên mới vào dự án.”
Hoặc: “Logic thử lại (retry) khi gọi API nằm ở đâu, và điều gì xảy ra khi hết số lần thử?”
Bước 3: Thêm code vào Project và giữ cho mới
Project hợp với dự án bạn hỏi đi hỏi lại nhiều lần. Lưu ý: chỉ thêm được code GitHub vào Project riêng tư (chưa chia sẻ cho ai). Ở Project dùng chung, lựa chọn GitHub bị làm mờ.
- Mở Project, trong phần project knowledge bấm +.
- Chọn GitHub (nếu chưa kết nối, bạn sẽ được chuyển sang GitHub để đăng nhập).
- Tìm repo hoặc dán link, rồi dùng trình duyệt file để chọn những file, thư mục cần đọc.
- Bấm Add files. Nội dung được thêm vào kiến thức của Project.
Cập nhật code: code trong Project không tự đổi theo GitHub. Hãy bấm Sync now trên repo trong project knowledge để lấy thay đổi mới, nhất là trước một lần phân tích mới hoặc sau khi repo thay đổi lớn. Muốn đổi danh sách file Claude đọc, chọn repo trong project knowledge, đánh dấu lại file/thư mục rồi bấm Update.
Bạn có thể thêm nhiều repo cùng lúc, miễn là tổng nội dung vừa cửa sổ ngữ cảnh của Claude. Vì vậy, hãy chọn những file trọng tâm thay vì cả kho.
Repo riêng tư, SSO và các trường hợp đặc biệt
Báo “Claude cannot access that resource”
Thường là repo riêng tư mà Claude chưa được cấp quyền. Bấm vào liên kết here trong thông báo để mở trang cài Claude GitHub App:
- Nếu bạn là quản trị viên GitHub: cấp quyền cho tất cả repo hoặc chỉ một số repo.
- Nếu repo thuộc tổ chức bạn không quản trị: gửi yêu cầu truy cập; quản trị viên tổ chức sẽ nhận email từ GitHub. Khi được duyệt, chọn lại repo.
Tổ chức GitHub bắt buộc SSO
Nếu GitHub đã kết nối mà repo riêng của một tổ chức vẫn không hiện, có thể tổ chức đó yêu cầu SSO. Mỗi người phải tự cấp quyền: vào github.com/settings/applications, mở mục Claude, ở Organization access bấm Grant cạnh tên tổ chức. Nếu nút ghi Request, bạn cần admin tổ chức duyệt. Ngắt rồi kết nối lại GitHub trong Claude không giải quyết được việc này.
Doanh nghiệp dùng EMU hoặc ZDR
Với GitHub Enterprise Cloud dùng Enterprise Managed Users, hãy kết nối khi đang đăng nhập tài khoản được quản lý và có phiên SSO còn hiệu lực. Còn nếu tổ chức bật Zero Data Retention cho Claude Code, Claude GitHub App không thể liên kết với tổ chức Claude; trường hợp này cần liên hệ đội ngũ tài khoản của Anthropic.
Mẹo dùng hiệu quả
- Bắt đầu nhỏ: thử với một phần codebase để xem Claude hiểu code của bạn thế nào.
- Chọn file có chủ đích: đưa vào những file cốt lõi cho câu hỏi, bỏ thư mục build, thư viện bên ngoài.
- Hỏi tiếp: câu trả lời đầu chưa đủ thì hỏi thêm để làm rõ.
- Kết hợp con người: coi phân tích của Claude là điểm khởi đầu để thảo luận với nhóm, không phải kết luận cuối cùng.
Những điều bạn học được trong bài này
- GitHub Integration có ở mọi gói và giúp Claude đọc tên, nội dung file của repo
- Claude không thấy commit, pull request, issue hay metadata của repo
- Kết nối tại Customize → Connectors → GitHub Integration, rồi dùng + → Add from GitHub trong chat
- Chỉ Project riêng tư mới thêm được code GitHub; nhớ bấm Sync now để lấy code mới
- Repo riêng tư cần cấp quyền qua Claude GitHub App; tổ chức có SSO cần bấm Grant riêng
Cần nhớ: Code trong Project là bản chụp tại lúc đồng bộ. Trước khi nhờ Claude phân tích, hãy Sync now để chắc Claude đang đọc bản mới nhất, và chỉ chọn những file thật sự cần để không vượt cửa sổ ngữ cảnh.
Nguồn tham khảo: Use the GitHub integration – Claude Help Center · GitHub integration – Claude Docs
Câu hỏi thường gặp
Gói Free có dùng được GitHub Integration không?
Có. Tài liệu chính thức ghi tích hợp này có ở mọi gói, kể cả Free, cho cả repo công khai và repo riêng tư bạn đã cấp quyền.
Vì sao tôi không thấy “Add from GitHub” trong menu +?
Bạn cần kết nối tài khoản GitHub trước tại Customize → Connectors → GitHub Integration → Connect. Ở gói Team/Enterprise, tổ chức cũng phải bật GitHub.
Claude có tự sửa code hay tạo pull request trên repo của tôi không?
Không. Tích hợp này chỉ đọc file. Muốn Claude sửa code, chạy lệnh và mở pull request, bạn dùng Claude Code.
Nếu tôi mất quyền truy cập repo thì sao?
Bạn không xem được nội dung repo trong các Project đã thêm nữa, bản xem trước bị gỡ, nhưng lịch sử trò chuyện vẫn được giữ.
