> ## Documentation Index
> Fetch the complete documentation index at: https://docs.baeum.ai.kr/llms.txt
> Use this file to discover all available pages before exploring further.

# Ubuntu 24.04 개발 환경

Ubuntu 24.04 LTS에서 AI/머신러닝 개발 환경을 구성하는 순서입니다. Windows 문서와 동일한 형식으로 단계별 안내를 제공합니다.

## 사전 준비

* Ubuntu 24.04 LTS
* `sudo` 권한 계정
* 인터넷 연결

## 권장 설치 순서

1. [Git](/setup/ubuntu/git)
2. [Visual Studio Code](/setup/ubuntu/vscode)
3. [Node.js](/setup/ubuntu/nodejs)
4. [uv + Python](/setup/ubuntu/uv-python)
5. [NVIDIA Driver](/setup/ubuntu/nvidia-driver)
6. [CUDA Toolkit](/setup/ubuntu/nvidia-cuda-toolkit)
7. [cuDNN](/setup/ubuntu/nvidia-cudnn)
8. [PyTorch CUDA](/setup/ubuntu/pytorch-cuda)
9. [Docker Engine](/setup/ubuntu/docker)
10. [Ollama](/setup/ubuntu/ollama)
11. [Claude Code](/setup/ubuntu/claude-code)

## 기본 점검

```bash theme={null}
lsb_release -a
uname -r
```

`Description`에 `Ubuntu 24.04`가 출력되면 문서 기준 환경과 일치합니다.

## 설치 점검 목록

* 관리자 권한/필수 도구 등 사전 요구사항을 먼저 확인했습니다.
* 설치 후 버전 확인 명령어(`--version`)를 실행해 정상 설치를 검증했습니다.
* PATH/환경변수 변경이 필요한 경우 터미널을 다시 열어 적용 여부를 확인했습니다.
* 문제가 생겼을 때를 대비해 설치 로그 또는 스크린샷을 남겼습니다.

## 문제 해결 가이드

* 설치 파일이 실행되지 않으면 관리자 권한으로 다시 실행합니다.
* 명령어가 인식되지 않으면 터미널을 새로 열고 PATH 반영 여부를 확인합니다.
* 버전이 맞지 않으면 기존 설치를 정리한 뒤 권장 버전으로 재설치합니다.
* 설정 변경 후 동작이 이상하면 시스템 재시작 후 다시 확인합니다.

## 관련 문서

<CardGroup cols={2}>
  <Card title="Setup 홈" icon="house" href="/setup/index">
    운영체제별 설치 흐름을 다시 확인합니다.
  </Card>

  <Card title="다음: Git" icon="arrow-right" href="/setup/ubuntu/git">
    다음 설치 단계를 이어서 진행합니다.
  </Card>
</CardGroup>