Claude Code на Ubuntu: установка, права доступа и первая задача в репозитории
Claude Code поддерживает Ubuntu 20.04 и новее. Для первого запуска нужен обычный пользователь, интернет и локальный Git-репозиторий. Не запускайте агента через sudo: тогда созданные файлы могут принадлежать root, а агент получит лишний доступ.
Проверьте систему
Узнайте версию Ubuntu, доступную память и свободное место. В официальных требованиях указано не менее 4 ГБ RAM. Для больших репозиториев и сборки понадобится больше.
Откройте актуальную инструкцию Anthropic и используйте рекомендованный нативный установщик. Копируйте команду только с официального домена. После установки откройте новый shell и проверьте, что claude доступен в PATH.
Авторизуйтесь обычным пользователем
Запустите Claude Code и войдите в учетную запись. Проверьте /status, чтобы увидеть активный способ авторизации. Если в окружении задан ANTHROPIC_API_KEY, убедитесь, что хотите использовать API, а не подписку.
Не записывайте ключ в .bashrc, если этот файл синхронизируется или доступен другим пользователям. Предпочтите менеджер секретов или ограниченную конфигурацию.
Исправьте права до работы
Клонируйте учебный репозиторий в каталог своего пользователя. Выполните git status и проверьте владельца файлов. Если проект когда-то собирали через sudo, сначала исправьте конкретные права, не давая агенту полный доступ к системе.
Запустите тесты вручную. Затем откройте Claude Code из корня проекта.
Дайте небольшую задачу
Найди функцию форматирования даты и ее тесты. Ничего не меняй. Предложи минимальный план, чтобы пустое значение возвращало пустую строку вместо ошибки. Не меняй зависимости и публичный формат остальных дат.
После проверки плана разрешите правку. Не подтверждайте установку системных пакетов и команды с sudo. Для одной функции они не нужны.
Проверьте Git и тесты
Откройте diff, запустите тесты и проверьте владельца измененных файлов. Они должны принадлежать вашему пользователю. Затем сделайте отдельный коммит.
На Linux можно дополнительно включить sandboxing Claude Code. Он снижает риск, но не заменяет review команд и разумные права пользователя.
Работа с агентом, Git и безопасным окружением более подробно разбирается в ИИ-лаборатории Глеба Кудрявцева.
Установка завершена, если Claude запускается без sudo, авторизация ожидаемая, файлы принадлежат обычному пользователю, а маленькая правка проходит тесты.