К основному содержимому

Использование интеграции GitHub

Подключите свои репозитории GitHub напрямую к Claude, чтобы предоставить полный контекст для задач разработки программного обеспечения. Вы можете легко добавлять репозитории, выбирая их из списка, что помогает Claude лучше понимать и помогать с вашей кодовой базой.

Для получения дополнительной информации о включении GitHub в вашей учётной записи см. Использование соединителей для расширения возможностей Claude.

Как добавить репозитории GitHub

Примечание: Если вы в настоящее время не аутентифицированы в GitHub, вы будете перенаправлены на GitHub для аутентификации перед использованием этой интеграции.

Чаты

  1. Нажмите кнопку "+" в нижнем левом углу интерфейса чата.

  2. Выберите "Добавить из GitHub" из раскрывающегося меню.

  3. Используйте браузер файлов для выбора конкретных файлов и папок.

  4. Когда вы отправляете сообщение, Claude получает доступ к содержимому и обрабатывает его, чтобы информировать свой ответ.

Проекты

  1. Нажмите кнопку "+" в верхнем правом углу раздела знаний вашего проекта.

  2. Выберите "GitHub" из раскрывающегося меню.

  3. Выполняйте поиск по доступным вам репозиториям или вставьте URL репозитория.

  4. Используйте браузер файлов для выбора конкретных файлов и папок.

  5. Выбранное содержимое будет добавлено в знания проекта, чтобы Claude мог получить доступ и обработать его.

  6. Вы можете использовать значок "Синхронизация", чтобы убедиться, что вы работаете с самой актуальной версией вашей кодовой базы.

  7. Вы можете использовать значок "Настроить файлы", чтобы изменить, какие файлы и папки анализирует Claude.

Подключение к приватным репозиториям

  • Если Claude не может получить доступ к репозиторию после ввода действительного URL, это, скорее всего, означает, что вы пытаетесь подключить Claude к приватному репозиторию: перейдите по ссылке на наше приложение GitHub, где вы можете предоставить доступ к репозиториям, если вы администратор GitHub, или отправьте запрос администраторам вашей организации GitHub.

  • Предоставьте доступ самостоятельно, если можете: вы можете выбрать, разрешить ли Claude доступ ко всем репозиториям или только к определённым.

  • Запросите доступ, если у вас нет необходимых разрешений: администраторы вашей организации GitHub получат уведомление по электронной почте о вашем запросе. После одобрения запроса вы сможете синхронизировать и получить доступ к репозиторию в Claude.


Лучшие практики

  1. Начните с малого: начните с выбора небольшого подмножества вашей кодовой базы для анализа. Это поможет вам понять, как Claude интерпретирует и обсуждает ваш код.

  2. Итерируйте и совершенствуйте: если первоначальный ответ Claude не полностью решает вашу проблему, не стесняйтесь задавать дополнительные вопросы или запрашивать уточнения.

  3. Комбинируйте с человеческой экспертизой: используйте идеи Claude как отправную точку для дальнейшего исследования и обсуждения с вашей командой. Пожалуйста, проверьте работу Claude.

  4. Продуманный выбор файлов: при использовании "Настроить файлы" будьте стратегичны в своём выборе. Включайте ключевые файлы и каталоги, которые являются центральными для вашей текущей задачи или проекта, но избегайте выбора ненужных файлов, чтобы оставаться в пределах лимита токенов и сохранять фокус.

  5. Регулярные обновления: помните о необходимости периодически обновлять синхронизацию GitHub вашего проекта, чтобы убедиться, что Claude работает с самой актуальной версией вашей кодовой базы, особенно перед началом нового анализа или когда вы знаете, что произошли значительные изменения в вашем репозитории.


Устранение неполадок

Репозитории организации не отображаются после подключения

Если ваше подключение GitHub отображается как подключённое, но приватные репозитории определённой организации не отображаются, эта организация может требовать единого входа (SSO). Когда требуется SSO, каждый пользователь должен отдельно авторизовать приложение Claude для этой организации. До этого GitHub фильтрует приватные репозитории этой организации из вашего представления, хотя ваше подключение в остальном работает.

Когда Claude обнаруживает это состояние, средство выбора репозитория показывает баннер, предлагающий вам авторизовать SSO. Чтобы авторизовать приложение Claude для вашей организации:

  1. Перейдите на github.com/settings/applications и откройте запись Claude.

  2. В разделе Доступ организации нажмите "Предоставить" рядом с соответствующей организацией GitHub.

  3. Если кнопка читает "Запрос" вместо "Предоставить", у вас нет разрешения на авторизацию приложения самостоятельно. Администратор организации GitHub должен одобрить ваш запрос из параметров политики приложения OAuth организации.

Важно: отключение и повторное подключение GitHub в параметрах Claude не решит эту проблему. Новое подключение не авторизует автоматически организации, требующие SSO, поэтому вам нужно выполнить описанные выше шаги авторизации.

Если ваша организация использует GitHub Enterprise Cloud с управляемыми пользователями (EMU), подключите GitHub, пока вы вошли в систему с вашей управляемой учётной записью и имеете активный сеанс SSO. Владелец организации может проверить приложение Claude в разделе Параметры > Доступ третьих сторон > GitHub Apps в вашей организации GitHub и подтвердить, что оно имеет доступ к нужным вам репозиториям и не имеет ожидающих запросов разрешений.

Не удаётся связать GitHub с организацией с нулевым хранением данных

Если ваша организация имеет нулевое хранение данных (ZDR), включённое для Claude Code, вы не можете связать приложение Claude GitHub с вашей организацией Claude. Это ограничение ZDR, а не проблема разрешений GitHub: связывание требует, чтобы Anthropic хранила подключение GitHub вашей организации, что ZDR не позволяет.

Когда вы пытаетесь связать GitHub в Параметры организации > Поставщики Git, вы можете увидеть ошибку, говорящую, что вам нужно быть владельцем организации GitHub, даже если вы уже являетесь одним.

Важно: изменение ролей или разрешений приложения на GitHub, или отключение и повторное подключение GitHub не решит эту проблему. Метрики вклада в аналитике Claude Code недоступны для организаций ZDR по той же причине.

Если вашей организации требуется связывание GitHub, обратитесь к команде вашего аккаунта Anthropic, чтобы обсудить конфигурацию ZDR. Узнайте больше о нулевом хранении данных для Claude Code.


Часто задаваемые вопросы

Какая информация извлекается из GitHub?

Синхронизируются только файлы (имена и содержимое) в репозитории на определённой ветке. Мы не извлекаем историю коммитов, PR или другие метаданные.

Что происходит, если мой репозиторий обновляется после добавления его в проект?

Вы можете нажать "Синхронизировать сейчас", чтобы получить последние изменения из вашего репозитория. Это обновит все ранее выбранные файлы и папки.

Могу ли я добавить несколько репозиториев в один проект или чат?

Да, вы можете добавить несколько репозиториев, чтобы предоставить Claude полный контекст для ваших задач разработки. Репозитории должны соответствовать контекстному окну Claude.

Что происходит, если я потеряю доступ к репозиторию?

Если вы потеряете доступ к репозиторию, вы не сможете просмотреть его содержимое в проектах, где он был ранее добавлен. Предпросмотр репозитория будет удалён, хотя история разговора будет сохранена.

Просмотрите все доступные соединители в Каталоге соединителей.

Нашли ответ на свой вопрос?