Все вопросы про сервис SourceCraft

Общие вопросы

Я работаю в Облаке в своей организации, а SourceCraft создал новую. Как ее удалить?

Аккаунту SourceCraft нужна персональная организация — рабочее пространство, где вы являетесь владельцем. При регистрации сервис ищет подходящую организацию в Yandex Cloud: если находит — делает ее персональной, если нет — создает новую.

Удалить персональную организацию напрямую — нельзя. Чтобы ее удалить:

  1. Обратитесь в поддержку, чтобы сделать персональной другую свою организацию.
  2. Удалите ненужную организацию.

Для смены персональной организации вы должны быть владельцем новой.

Я создал в SourceCraft организацию, а она оказалась мне не нужна. Как ее удалить?

Каждая организация SourceCraft связана с облачной организацией Yandex Cloud, поэтому ими можно управлять в Cloud Center. При наличии соответствующих прав можно удалить облачную организацию и организация SourceCraft удалится вместе с ней.

SourceCraft Sites

Какие ограничения безопасности действуют в SourceCraft Sites?

В SourceCraft Sites по соображениям безопасности нельзя:

  • Использовать сервис-воркеры (Service Worker) — код JavaScript, который выполняется в браузере отдельно от веб-страницы и может перехватывать сетевые запросы и кешировать ресурсы. Используются, например, для работы PWA-приложений в офлайн-режиме.
  • Встраивать опубликованный сайт во фреймы, например с помощью HTML-элемента <iframe>.

Ограничения связаны с размещением сайтов на общем домене и заданы HTTP-заголовком Content-Security-Policy: frame-ancestors 'none'; worker-src 'none';. Изменить или ослабить эту политику с помощью кода сайта или HTML-разметки нельзя.

Как подтвердить владение сайтом на SourceCraft Sites в Яндекс Вебмастере?

Чтобы подтвердить владение сайтом на SourceCraft Sites в Яндекс Вебмастере:

  1. Создайте в организации репозиторий с именем, совпадающим с именем организации.

  2. В репозитории создайте сайт SourceCraft Sites. Он будет доступен по адресам:

    • https://<имя_организации>.sourcecraft.site/
    • https://<имя_организации>.sourcecraft.site/<имя_организации>/

  3. Добавьте метатег подтверждения на главную страницу сайта:

    • Зарегистрируйте сайт в Яндекс Вебмастере.
    • Выберите подтверждение по метатегу.
    • Добавьте полученный метатег в HTML-код главной страницы:
    <meta name="yandex-verification" content="<код_подтверждения>" />

После этого все репозитории и сайты в организации будут подтверждены. Подробнее о настройке хостинга — в руководстве Хостинг статического сайта из репозитория с помощью SourceCraft Sites.

Технические вопросы про Code Assistant

Общие вопросы

Как сейчас называется сервис?

Сервис стал частью платформы SourceCraft. В связи с этим полное наименование сервиса Yandex Code Assistant изменено на SourceCraft Code Assistant. При этом текущая функциональность сервиса осталась прежней.

Также Code Assistant теперь доступен во встроенном редакторе кода SourceCraft.

Есть ли ограничения при использовании сервиса?

Подробнее об ограничениях на странице Квоты в SourceCraft Code Assistant.

Какие IDE поддерживаются?

Плагин Code Assistant доступен для Visual Studio Code, VSCodium и IDE от JetBrains версий 2026.2, 2026.1, 2025.3, 2025.2, 2025.1, 2024.3, 2024.2 и 2024.1.

Нужен ли для работы с Code Assistant платежный аккаунт в Yandex Cloud?

Платежный аккаунт не нужен.

Логируются ли мои запросы при использовании Code Assistant в плагинах для IDE и SourceCraft CLI?

При подключении к предустановленной модели SourceCraft ваши запросы не логируются.

Если вы используете сторонние модели, настройте для них передачу заголовка x-data-logging-enabled со значением false:

  • В SourceCraft CLI и плагине для IDE от JetBrains — в файле конфигурации OpenCode:

    • Глобально для всех репозиториев:
      • /Users/<имя_пользователя>/Library/Application Support/sourcecraft/opencode/opencode.json в macOS;
      • /home/<имя_пользователя>/.config/sourcecraft/opencode/opencode.json в Linux;
      • C:\Users\<имя_пользователя>\AppData\Roaming\sourcecraft\opencode\opencode.json в Windows.
    • Локально — в файле .opencode/opencode.json в директории репозитория.

    Подробнее о настройке пользовательских заголовков в параметре options.headers провайдера в документации OpenCode.

  • В плагине для Visual Studio Code — в настройках профиля модели.

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

Нет. Для работы Code Assistant требуется постоянный доступ в интернет.

Как изменить пользователя, аутентифицированного в плагине Code Assistant?

Чтобы аутентифицироваться в плагине Code Assistant как другой пользователь SourceCraft, выйдите из профиля и затем повторно аутентифицируйтесь, как это описано в п. 3 раздела Установите и настройте плагин.

Ошибка получения refresh-токена

Текст ошибки:

Error refreshing token: no refresh token found

В вашей организации запрещен выпуск refresh-токенов, которые используются Code Assistant для аутентификации. Чтобы работать с Code Assistant, зарегистрируйтесь в SourceCraft с помощью личного аккаунта на Яндексе.

Ошибки токена

Выйдите из профиля и затем повторно аутентифицируйтесь, как это описано в п. 3 раздела Установите и настройте плагин.

Ошибка 400 при аутентификации

Текст ошибки:

Authorization error: Request failed with status code 400

Ошибка может возникать, если на компьютере установлено неверное системное время. Проверьте системное время и повторите аутентификацию.

Как получить логи работы IDE?

Если для решения проблем с Code Assistant вы хотите обратиться в техническую поддержку, заранее подготовьте файл с логом IDE:

  1. В правом нижнем углу IDE нажмите .
  2. В открывшемся меню выберите Export Logs.
  3. Откроется окно проводника с архивом logs.zip. Приложите архив к обращению в техническую поддержку.

Если для решения проблем с Code Assistant вы хотите обратиться в техническую поддержку, заранее подготовьте файл с логом IDE:

  1. В верхнем меню IDE нажмите Help и выберите Show Log in Explorer (Show Log in Finder на macOS).
  2. В открывшемся окне скопируйте файл idea.log и приложите его к обращению в техническую поддержку.

К каким интернет-ресурсам нужен доступ для работы Code Assistant?

Список интернет-ресурсов, к которым нужен доступ, представлен на странице FQDN ресурсов SourceCraft Code Assistant.

Работа в Visual Studio Code

Работа в Visual Studio Code

Ошибка при аутентификации в Visual Studio Code

Текст ошибки:

crypto is not defined

Ошибка от внутренней библиотеки IDE, которая используется для аутентификации в SourceCraft. Чтобы устранить ошибку, обновите Visual Studio Code.

Пример сборки Visual Studio Code, совместимой с плагином
Version: 1.92.2 (system setup)
Commit: fee1edb8d6d72a0ddff41e5f71a671c23ed924b9
Date: 2024-08-14T17:29:30.058Z
Electron: 30.1.2
ElectronBuildId: 9870757
Chromium: 124.0.6367.243
Node.js: 20.14.0
V8: 12.4.254.20-electron.0
OS: Windows_NT x64 10.0.19045

Также читайте статью Как узнать версию IDE.

Как изменить язык интерфейса плагина в Visual Studio Code?

Язык интерфейса плагина зависит от установленного языка интерфейса IDE.

Работа в IDE от JetBrains

Работа в IDE от JetBrains

Ошибка SourceCraft Code Authentication Failed или 404 Not Found при аутентификации

При аутентификации плагина в браузере может отобразиться одна из ошибок:

SourceCraft Code Authentication Failed

404 Not Found

Чтобы устранить ошибку:

  1. Удалите плагин и перезапустите IDE.
  2. Установите плагин повторно, но не запускайте аутентификацию.
  3. Временно назначьте браузером по умолчанию другой браузер, например Firefox.
  4. В новом браузере перейдите на страницу аутентификации и войдите с помощью личного аккаунта на Яндексе вида login@yandex.ru, а не доменного аккаунта.
  5. В консоли управления убедитесь, что выбран нужный аккаунт.
  6. Вернитесь в IDE, нажмите , введите SourceCraft Code Assistant и выберите SourceCraft Code Assistant: Login.

После успешной аутентификации в браузере появится сообщение SourceCraft Code Assistant Authenticated Successfully.

Плагин не запускается в IDE от JetBrains, сообщение об ошибке 404, не появляются предложения от Code Assistant

Попробуйте перезапустить IDE.

Ошибка при установке плагина: No plugins found. Check the log file for errors

Ошибка возникает, если версия IDE от JetBrains не поддерживается плагином Code Assistant. Проверьте список поддерживаемых версий и используйте IDE соответствующей версии.

Плагин в IDE от JetBrains устанавливается некорректно

Плагин устанавливается в IDE в виде архива в формате ZIP. Не распаковывайте скачанный архив.

Некоторые браузеры, например Safari на macOS, автоматически распаковывают загружаемые архивы. Чтобы загрузить файл плагина именно в виде архива, нажмите на ссылку с плагином правой кнопкой, выберите Загрузить файл по ссылке как... (Download Linked File As...) и нажмите Сохранить (Save).

Ошибка аутентификации с прокси в IDE от JetBrains

Текст ошибки:

Failed to authenticate with proxy

Проверьте, не включен ли прокси-сервер в IDE. Если включен — отключите и попробуйте аутентифицироваться еще раз.

SSH-доступ

Как проверить подключение по SSH?

О том, как добавить SSH-ключ и получить доступ к репозиторию, читайте в разделе Получить доступ к репозиторию с помощью SSH-ключа.

После добавления SSH-ключа выполните команду:

ssh -T ssh://ssh.sourcecraft.dev

Если аутентификация прошла успешно, вы увидите сообщение:

Hi <username>! You've successfully authenticated, but SourceCraft does not provide shell access.

Как использовать SSH через порт HTTPS?

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

Чтобы проверить возможность SSH-соединения через порт HTTPS, выполните команду:

ssh -T -p 443 ssh.sourcecraft.dev

Если аутентификация прошла успешно, вы увидите сообщение:

Hi <username>! You've successfully authenticated, but SourceCraft does not provide shell access.

Примечание

Для порта 443 используйте имя хоста ssh.sourcecraft.dev, а не sourcecraft.dev.

Чтобы клонировать репозиторий через порт 443, выполните команду:

git clone ssh://ssh.sourcecraft.dev:443/<имя_пользователя>/<название_репозитория>.git

Как настроить SSH-соединение через HTTPS?

Если подключение к ssh.sourcecraft.dev через порт 443 работает, можно настроить SSH так, чтобы все соединения с sourcecraft.dev автоматически использовали этот хост и порт.

Для этого отредактируйте файл ~/.ssh/config и добавьте в него следующий блок:

Host sourcecraft.dev
    Hostname ssh.sourcecraft.dev
    Port 443
    User git

Чтобы проверить, что настройки применились, подключитесь к sourcecraft.dev еще раз:

ssh -T sourcecraft.dev

Если подключение прошло успешно, вы увидите сообщение:

Hi <username>! You've successfully authenticated, but SourceCraft does not provide shell access.

Как обновить список известных хостов?

При первом подключении к SourceCraft появится предупреждение о неизвестном хосте:

The authenticity of host '[ssh.sourcecraft.dev]:443 ([<IP-адрес>]:443)' can't be established.
ED25519 key fingerprint is SHA256:+DiY3wvvV6TuJJhbp********.
This host key is known by the following other names/addresses:
    ~/.ssh/known_hosts:32: sourcecraft.dev
Are you sure you want to continue connecting (yes/no/[fingerprint])?

Введите в терминале слово yes и нажмите Enter.

Git

Как начать работать с git?

Подробное руководство по работе с git читайте в разделе Как начать работать с git.

Ошибки в git при попытке отправить большой файл по протоколу HTTPS

Подробное руководство по работе с git читайте в разделе Как начать работать с git.

Предыдущая
SSH
Следующая
История изменений