사전 준비
- Ubuntu 24.04 LTS
sudo권한 계정- 인터넷 연결
권장 설치 순서
- Git
- Visual Studio Code
- Node.js
- uv + Python
- NVIDIA Driver
- CUDA Toolkit
- cuDNN
- PyTorch CUDA
- Docker Engine
- Ollama
- Claude Code
기본 점검
Description에 Ubuntu 24.04가 출력되면 문서 기준 환경과 일치합니다.
설치 점검 목록
- 관리자 권한/필수 도구 등 사전 요구사항을 먼저 확인했습니다.
- 설치 후 버전 확인 명령어(
--version)를 실행해 정상 설치를 검증했습니다. - PATH/환경변수 변경이 필요한 경우 터미널을 다시 열어 적용 여부를 확인했습니다.
- 문제가 생겼을 때를 대비해 설치 로그 또는 스크린샷을 남겼습니다.
문제 해결 가이드
- 설치 파일이 실행되지 않으면 관리자 권한으로 다시 실행합니다.
- 명령어가 인식되지 않으면 터미널을 새로 열고 PATH 반영 여부를 확인합니다.
- 버전이 맞지 않으면 기존 설치를 정리한 뒤 권장 버전으로 재설치합니다.
- 설정 변경 후 동작이 이상하면 시스템 재시작 후 다시 확인합니다.

