如需了解如何在帳戶中啟用 GitHub 的詳細資訊,請參閱 使用連接器擴展 Claude 的功能。
將您的 GitHub 儲存庫直接連接到 Claude,為您的軟體開發任務提供全面的背景資訊。您可以透過從清單中選擇儲存庫來輕鬆新增儲存庫,幫助 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,Claude 應用程式也必須在企業級別獲得批准。在 設定 Claude Code 的程式碼審查中了解更多資訊。
常見問題
從 GitHub 檢索了哪些資訊?
只有特定分支上儲存庫中的檔案(名稱和內容)會被同步。我們不檢索提交歷史記錄、PR 或其他中繼資料。
將儲存庫新增到專案後,如果儲存庫被更新會發生什麼?
您可以按一下「立即同步」以從儲存庫中擷取最新變更。這將更新所有先前選擇的檔案和資料夾。
我可以將多個儲存庫新增到單個專案或聊天嗎?
是的,您可以新增多個儲存庫,為 Claude 提供開發任務的全面背景資訊。儲存庫必須符合 Claude 的背景視窗。
如果我失去對儲存庫的存取權限會發生什麼?
如果您失去對儲存庫的存取權限,您將無法在先前新增它的專案中檢視其內容。儲存庫預覽將被移除,但對話歷史記錄將被保留。
在 連接器目錄中瀏覽所有可用的連接器。
