Интеграция локального проекта Claude Code с репозиторием кода SourceCraft

В этом руководстве мы пошагово разберем, как с нуля создать пустой репозиторий в организации на SourceCraft, правильно инициализировать Git на локальном компьютере, настроить SSH-ключи для безопасного доступа и научить локального ИИ-помощника Claude Code делать коммиты строго по вашему запросу.

Шаг 1. Создание удаленного репозитория на SourceCraft

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

1. Перейдите на страницу репозиториев вашей организации:
   https://sourcecraft.dev/<ваша-организация>/repos
2. В верхней правой части страницы нажмите Создать репозиторий (Create repository) — создавайте пустой репозиторий.
3. Укажите параметры проекта:
   • Название (Name): имя вашего проекта.
   • Приватность (Visibility): выберите подходящую область видимости (Приватный, Внутренний или Публичный).
4. Важно: в подразделе настроек инициализации не устанавливайте флажки для файлов README.md, .gitignore или файла лицензии. Нам нужен пустой репозиторий.
5. Нажмите Создать репозиторий. На экране отобразятся инструкции и адрес для подключения.

Шаг 2. Генерация и добавление SSH-ключей в SourceCraft

Для безопасной отправки кода без постоянного ввода паролей SourceCraft использует SSH-ключи. Если ключ не настроен, терминал выдаст ошибку Permission denied (publickey).

Настроим ключ в терминале (PowerShell в Windows или Bash в macOS/Linux):

1. Проверка наличия существующего ключа

Выполните команду в консоли:

# Для Windows (PowerShell):
Get-Content $env:USERPROFILE\.ssh\id_ed25519.pub

# Для macOS / Linux (Terminal):
cat ~/.ssh/id_ed25519.pub

Если терминал выдал ошибку «Не удается найти путь…» или аналогичную, ключа нет. Переходите к следующему пункту. Если вывелась длинная строка, начинающаяся с ssh-ed25519 ... — скопируйте ее и переходите сразу к пункту 3.

2. Генерация нового SSH-ключа

Если ключа нет, создайте его командой:

ssh-keygen -t ed25519

На все вопросы утилиты (куда сохранить файл, пароль) просто нажимайте клавишу Enter, оставляя настройки по умолчанию.

После завершения выведите публичный ключ на экран и скопируйте всю строку:

# Для Windows (PowerShell):
Get-Content $env:USERPROFILE\.ssh\id_ed25519.pub

3. Добавление ключа в профиль SourceCraft

1. Откройте главную страницу SourceCraft.
2. На панели слева нажмите Домой и перейдите в раздел Доступ → SSH-ключи (или откройте настройки вашего профиля в правом верхнем углу).
3. Нажмите кнопку Новый SSH ключ (Добавить ключ).
4. В поле Название ключа укажите любое имя (например, Work-Laptop).
5. В поле Значение (или Ключ) вставьте скопированную строку.
6. Нажмите Создать ключ.

Шаг 3. Инициализация локального Git-репозитория

Попытка привязать удаленный адрес командой git remote add в обычной папке без Git приведет к ошибке fatal: not a git repository (or any of the parent directories): .git. Исправим это.

Откройте консоль, перейдите в папку вашего проекта (например, cd C:\<папка_проекта>) и выполните инициализацию:

# 1. Инициализируем локальный репозиторий (создается скрытая папка .git)
git init

# 2. Добавляем все файлы текущей папки в индекс Git
git add .

# 3. Делаем первый локальный коммит, фиксируя текущее состояние кода
git commit -m "initial commit"

# 4. Переименовываем дефолтную ветку в main (стандарт для SourceCraft)
git branch -M main

Шаг 4. Связывание репозиториев и первая отправка кода

Теперь, когда у нас есть и локальный Git-репозиторий, и добавленный в профиль SSH-ключ, мы можем без ошибок связать их и загрузить код в облако.

1. Привяжите созданный на Шаге 1 репозиторий в качестве удаленного источника (origin):

git remote add origin ssh://ssh.sourcecraft.dev/<ваша-организация>/<название-репозитория>.git

2. Отправьте ветку main на сервер:

git push -u origin main

Примечание: Если терминал спросит, доверяете ли вы хосту (Are you sure you want to continue connecting?), введите yes и нажмите Enter.

Шаг 5. Настройка коммитов в Claude Code по запросу

После успешного пуша вы можете запустить CLI-помощник командой claude прямо в корневой папке репозитория.

По умолчанию агент Claude Code выполняет только те операции с Git, которые вы подтверждаете или запрашиваете сами. Чтобы он не делал коммиты автоматически без вашего ведома, а фиксировал изменения строго по вашей команде, настройте правила взаимодействия.

1. Команда на создание коммита в чате

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

«Добавь обработку исключений в класс получения акций и, если тесты пройдут успешно, сделай коммит с описанием изменений».

Claude самостоятельно напишет код, проверит его работоспособность и вызовет команды Git локально, показав вам готовый коммит.

2. Безопасность при отправке изменений (Push)

Даже если вы попросите Claude отправить изменения в облако, утилита обязательно выведет в терминал интерактивный запрос на подтверждение операции (Y/n). Ни один пуш в репозиторий организации <ваша-организация> не уйдет без вашего ручного согласия.

3. Фиксация регламента в CLAUDE.md

Для надежности создайте в корне вашего проекта файл CLAUDE.md. Этот файл считывается Claude Code при каждом запуске сессии. Запишите туда следующее правило:

# Инструкции для Claude Code

## Правила работы с Git:
- Не создавай коммиты автоматически в фоновом режиме.
- После выполнения задачи всегда спрашивай: "Хотите, чтобы я подготовил коммит для этих изменений?".
- Создавай коммиты только после моего прямого согласия.
- Для оформления сообщений используй формат Conventional Commits.
- Никогда не делай `git push` без явного подтверждения в интерфейсе.

Такой подход позволяет полностью контролировать историю изменений, сохраняя высокую скорость написания кода с помощью ИИ-ассистента.