直接將您的 GitHub 儲存庫連接到 Claude,為您的軟體開發任務提供全面的背景資訊。您可以透過從清單中選擇儲存庫來輕鬆新增儲存庫,幫助 Claude 更好地理解和協助您的程式碼庫。
如需有關在您的帳戶中啟用 GitHub 的詳細資訊,請參閱 使用連接器擴展 Claude 的功能。
如何新增 GitHub 儲存庫
注意: 如果您目前未使用 GitHub 進行身份驗證,您將被重新導向到 GitHub 進行身份驗證,然後才能使用此整合。
聊天
點擊聊天介面左下角的「+」按鈕。
從下拉式選單中選擇「從 GitHub 新增」。
使用檔案瀏覽器選擇特定的檔案和資料夾。
當您傳送訊息時,Claude 將存取並處理內容以告知其回應。
專案
點擊您的專案知識部分右上角的「+」按鈕。
從下拉式選單中選擇「GitHub」。
搜尋您可存取的儲存庫,或貼上儲存庫 URL。
使用檔案瀏覽器選擇特定的檔案和資料夾。
您選擇的內容將被新增到專案知識中,供 Claude 存取和處理。
您可以使用「同步」圖示來確保您使用的是程式碼庫的最新版本。
您可以使用「設定檔案」圖示來修改 Claude 分析的檔案和資料夾。
連接到私人儲存庫
如果 Claude 在您輸入有效 URL 後無法存取儲存庫,這很可能表示您正在嘗試將 Claude 連接到私人儲存庫:請按照連結前往我們的 GitHub App,如果您是 GitHub 管理員,可以授予對儲存庫的存取權限,或向您的 GitHub 組織管理員發送請求。
如果可以,請自行授予存取權限:您可以選擇讓 Claude 存取所有儲存庫或特定儲存庫。
如果您沒有必要的權限,請要求存取權限:您的 GitHub 組織管理員將收到有關您的請求的電子郵件通知。一旦他們批准該請求,您將能夠在 Claude 中同步和存取儲存庫。
最佳實踐
從小處開始:首先選擇程式碼庫的一個小子集進行分析。這將幫助您熟悉 Claude 如何解釋和討論您的程式碼。
反覆迭代和改進:如果 Claude 的初始回應沒有完全解決您的問題,請毫不猶豫地提出後續問題或要求澄清。
結合人類專業知識:使用 Claude 的見解作為進一步調查和與您的團隊討論的起點。請檢查 Claude 的工作。
深思熟慮的檔案選擇:使用「設定檔案」時,請策略性地進行選擇。包括對您目前任務或專案至關重要的關鍵檔案和目錄,但避免選擇不必要的檔案以保持在代幣限制內並保持焦點。
定期更新:記得定期重新整理您的專案 GitHub 同步,以確保 Claude 使用的是程式碼庫的最新版本,特別是在開始新分析之前或當您知道儲存庫有重大變更時。
疑難排解
連接後,來自組織的儲存庫未出現
如果您的 GitHub 連接顯示為已連接,但來自特定組織的私人儲存庫未出現,該組織可能需要單一登入 (SSO)。當需要 SSO 時,每個使用者必須分別為該組織授權 Claude 應用程式。在您這樣做之前,GitHub 會從您的檢視中篩選該組織的私人儲存庫,即使您的連接在其他方面正常運作。
當 Claude 偵測到此狀態時,儲存庫選擇器會顯示一個橫幅,提示您授權 SSO。若要為您的組織授權 Claude 應用程式:
前往 github.com/settings/applications 並開啟 Claude 項目。
在 組織存取下,點擊相關 GitHub 組織旁的「授予」。
如果按鈕顯示「要求」而不是「授予」,您沒有權限自行授權應用程式。GitHub 組織管理員必須從組織的 OAuth 應用程式原則設定中批准您的請求。
重要:在您的 Claude 設定中斷開連接並重新連接 GitHub 不會解決此問題。新的連接不會自動授權需要 SSO 的組織,因此您需要完成上述授權步驟。
如果您的組織使用具有企業受管使用者 (EMU) 的 GitHub Enterprise Cloud,請在使用您的受管帳戶登入並具有有效 SSO 工作階段時連接 GitHub。組織擁有者可以在您的 GitHub 組織中的「設定」>「第三方存取」>「GitHub 應用程式」下檢查 Claude 應用程式,並確認它可以存取您需要的儲存庫,並且沒有待處理的權限請求。
無法將 GitHub 連結到零資料保留的組織
如果您的組織為 Claude Code 啟用了零資料保留 (ZDR),您無法將 Claude GitHub 應用程式連結到您的 Claude 組織。這是 ZDR 的限制,而不是 GitHub 權限問題:連結需要 Anthropic 儲存您的組織 GitHub 連接,而 ZDR 不允許這樣做。
當您嘗試在 組織設定 > Git 提供者中連結 GitHub 時,您可能會看到一條錯誤訊息,說您需要是 GitHub 組織的擁有者,即使您已經是。
重要:在 GitHub 上變更角色或應用程式權限,或斷開連接並重新連接 GitHub,都不會解決此問題。由於相同的原因,Claude Code 分析中的貢獻指標對 ZDR 組織不可用。
如果您的組織需要 GitHub 連結,請聯絡您的 Anthropic 帳戶團隊以討論您的 ZDR 設定。深入瞭解 Claude Code 的零資料保留。
常見問題
從 GitHub 檢索了哪些資訊?
只有特定分支上儲存庫中的檔案(名稱和內容)會被同步。我們不檢索提交歷史、PR 或其他中繼資料。
如果我的儲存庫在新增到專案後被更新,會發生什麼?
您可以點擊「立即同步」以從您的儲存庫擷取最新變更。這將更新所有先前選擇的檔案和資料夾。
我可以將多個儲存庫新增到單個專案或聊天嗎?
是的,您可以新增多個儲存庫,為 Claude 提供開發任務的全面背景資訊。儲存庫必須符合 Claude 的背景視窗。
如果我失去對儲存庫的存取權限,會發生什麼?
如果您失去對儲存庫的存取權限,您將無法在先前新增它的專案中檢視其內容。儲存庫預覽將被移除,但對話歷史記錄將被保留。
在 連接器目錄中瀏覽所有可用的連接器。
