콩콩 컴퍼니 출판사

AMD 내장 그래픽 + nvidia 외장 그래픽 카드 조합 에서 자주 발생하는 문제 

그래픽 카드를 큰맘 먹고 교체했는데, 혹은 업데이트를 진행했는데 갑자기 게임이 튕기거나 모니터가 깜빡거리는 경험, 정말 스트레스받으시죠? 특히 AMD 라데온에서 NVIDIA 지포스로, 혹은 그 반대로 넘어갈 때 이런 드라이버 충돌 에러가 잦은 편입니다.

🛠️ AMD ↔ NVIDIA 그래픽 드라이버, 도대체 왜 충돌할까?

새 그래픽 카드를 꽂고 새 드라이버를 설치했다고 해서 기존 드라이버가 완전히 사라지는 것은 아닙니다. 제어판에서 단순히 '프로그램 추가/제거'로 삭제하더라도 다음과 같은 문제들이 남습니다.

1. 레지스트리 찌꺼기: 윈도우의 핵심 설정인 레지스트리에 이전 그래픽 카드의 설정값이 남아있어 새 그래픽 카드와 시스템 주도권을 두고 싸우게 됩니다.
2. DLL 파일 충돌: 시스템 폴더 깊숙한 곳에 남은 이전 드라이버의 라이브러리(DLL) 파일들을 윈도우가 잘못 읽어 들이면서 화면 멈춤이나 블루스크린을 유발합니다.
3. 윈도우 자동 업데이트의 방해: 사용자가 드라이버를 설치하는 도중에, 윈도우가 백그라운드에서 구버전의 범용 드라이버를 마음대로 덮어씌워 버리면서 파일이 꼬이게 됩니다.

이러한 문제를 원천 차단하기 위해 'DDU(Display Driver Uninstaller)'를 사용하여 안전 모드에서 기존 드라이버를 뿌리 뽑는 과정이 반드시 필요합니다.

🚀 완벽 해결! DDU로 그래픽 드라이버 클린 설치하기

성공적인 클린 설치를 위해서는 인터넷을 연결하지 않은 상태에서 작업하는 것이 핵심입니다. (윈도우 자동 업데이트 방지) 따라서 작업 전 필요한 파일들을 미리 다운로드해 두어야 합니다.

1단계: 필수 파일 미리 다운로드 받기 (★매우 중요)

바탕화면에 새 폴더를 하나 만들고, 아래의 공식 링크에서 본인의 시스템에 맞는 파일 3가지를 모두 다운로드하여 모아둡니다.

• 1) DDU (Display Driver Uninstaller) 다운로드
  • 찌꺼기 제거 전용 프로그램입니다.
  • 🔗 공식 사이트: https://www.wagnardsoft.com/ (사이트 접속 후 최신 버전의 DDU 다운로드 링크를 클릭하세요)
• 2) AMD 칩셋 (메인보드) 드라이버 다운로드
  • AMD CPU를 사용 중이시라면 칩셋 드라이버도 최신화해 주는 것이 시스템 안정성에 좋습니다.
  • 🔗 AMD 공식 홈페이지: https://www.amd.com/ko/support/download/drivers.html
• 3) NVIDIA (또는 AMD) 그래픽 드라이버 다운로드
  • 새로 장착한(또는 사용할) 그래픽 카드의 최신 드라이버입니다.
  • 🔗 NVIDIA 공식 홈페이지: https://www.nvidia.com/ko-kr/drivers/

2단계: 인터넷 연결 해제 및 안전 모드 부팅

1. 랜선을 PC에서 아예 뽑거나, 와이파이 연결을 끕니다. (윈도우 업데이트 통해서 자동 드라이버 설치를 막기 위함)
2. 윈도우를 '안전 모드'로 부팅합니다.
   • 안전 모드 진입 방법: 키보드의 Shift 키를 누른 상태로 윈도우 [시작] -> [전원] -> [다시 시작] 클릭. 이후 파란 화면에서 [문제 해결] -> [고급 옵션] -> [시작 설정] -> [다시 시작]을 누르고, 숫자 4번을 눌러 안전 모드로 진입합니다.

3단계: DDU로 기존 드라이버 밀어버리기

1. 미리 다운받아둔 DDU 압축을 풀고 Display Driver Uninstaller.exe를 실행합니다.
2. 우측 상단 옵션에서 장치 유형을 'GPU'로 선택합니다.
3. 그 아래 장치 선택에서 지우고자 하는 제조사(NVIDIA, AMD, Intel 중 택 1)를 선택합니다. (만약 AMD에서 NVIDIA로 넘어왔다면, AMD를 먼저 지우고, 혹시 모를 찌꺼기를 위해 NVIDIA도 한 번 더 지워주는 것이 좋습니다)
4. 좌측 상단의 '지우고 다시 시작 (정상 권장)' 버튼을 클릭합니다.
5. 프로그램이 알아서 찌꺼기를 삭제한 후 PC를 재부팅합니다.

4단계: 새 드라이버 설치 (순서 준수)

PC가 일반 모드로 재부팅되면 해상도가 낮아져 아이콘이 크게 보일 텐데 정상입니다. 아직 인터넷은 연결하지 마세요!

1. AMD 칩셋 드라이버 설치: (AMD CPU 사용자만 해당) 미리 받아둔 칩셋 드라이버를 가장 먼저 설치합니다. 시스템 뼈대를 먼저 잡아주는 과정입니다.
2. NVIDIA 그래픽 드라이버 설치: 다운받아둔 그래픽 드라이버 설치 파일을 실행하여 설치를 완료합니다.
3. 모든 설치가 끝나면 PC를 한 번 더 재부팅합니다.
4. 이제 인터넷(랜선/와이파이)을 다시 연결하고 정상적으로 게임이나 작업을 즐기시면 됩니다!

💡 핵심 요약 파일 미리 받기 ➔ 인터넷 끊기 ➔ 안전 모드 ➔ DDU로 밀기 ➔ 칩셋/그래픽 드라이버 재설치 ➔ 인터넷 연결

이 방법대로만 하시면 지긋지긋한 그래픽 드라이버 충돌이나 알 수 없는 프레임 드랍, 블랙스크린 현상의 90% 이상은 깔끔하게 해결하실 수 있습니다.

1. 윈도우의 영원한 불청객, 블루스크린 (BSoD)

가장 악명 높고 흔하게 볼 수 있는 '블루 스크린 오브 데스(Blue Screen of Death)'입니다. 윈도우가 시스템을 계속 작동시킬 수 없을 만큼 치명적인 오류를 만났을 때 시스템을 보호하기 위해 스스로 작동을 멈추고 띄우는 화면입니다.

• 주요 원인: 대부분 하드웨어 문제나 기기 드라이버의 충돌 때문에 발생합니다. 램(RAM) 접촉 불량, 하드디스크 손상, 혹은 최근 설치한 프로그램이나 윈도우 업데이트가 기존 시스템과 꼬였을 때 자주 나타납니다.
• 대처 방법: 화면 하단에 나오는 '중지 코드(Stop Code)'(예: CRITICAL_PROCESS_DIED, MEMORY_MANAGEMENT 등)를 스마트폰으로 사진 찍어두거나 메모해 두는 것이 가장 중요합니다. 이 코드를 검색하면 정확한 원인과 해결책을 찾을 수 있습니다.

2. 아무것도 안 보여서 더 답답한, 블랙스크린

파란 화면 대신 화면이 아예 새까맣게 먹통이 되거나, 까만 화면에 마우스 커서만 덩그러니 움직이는 증상입니다. 시스템 자체가 완전히 죽은 블루스크린과는 원인이 조금 다릅니다.

• 주요 원인: 주로 그래픽 카드(GPU)나 디스플레이 드라이버에 문제가 생겼을 때 발생합니다. 또는 윈도우의 바탕화면을 띄워주는 프로그램인 '윈도우 탐색기(explorer.exe)'가 제대로 실행되지 않았을 때도 나타납니다.
• 대처 방법: 그래픽 드라이버의 일시적인 오류라면 마법의 단축키 Windows 키 + Ctrl + Shift + B를 눌러보세요. 삐- 소리와 함께 화면이 깜빡이며 그래픽 드라이버가 초기화되어 화면이 돌아올 수 있습니다. 마우스 커서만 보인다면 Ctrl + Alt + Del을 눌러 작업 관리자를 실행한 뒤, explorer.exe를 다시 실행해 주는 방법이 있습니다.

3. "어라? 왜 파란색이 아니지?" 그린스크린 (GSoD)

블루스크린과 똑같이 생겼는데 배경색만 초록색인 화면을 보셨다면, 조금 특별한(?) 윈도우를 사용하고 계신 것입니다.

• 주요 원인 및 대상: 이 화면은 일반 사용자에게는 나타나지 않습니다. 마이크로소프트의 베타 테스트 프로그램인 '윈도우 참가자 프로그램(Windows Insider Program)' 사용자에게만 나타나는 오류 화면입니다.
• 존재 이유: 마이크로소프트 개발진이 오류 보고를 받았을 때, 이것이 정식 버전 윈도우에서 발생한 오류인지, 아니면 아직 개발 중인 테스트 버전에서 발생한 오류인지 색깔만 보고 한눈에 구분하기 위해 도입했습니다. 해결 방법은 블루스크린과 동일하게 중지 코드를 확인하는 것입니다.

💡 요약하자면!

• 블루스크린: 치명적인 시스템/하드웨어 오류 (중지 코드 확인 필수!)
• 블랙스크린: 그래픽 드라이버나 디스플레이, 바탕화면 표시 오류
• 그린스크린: 윈도우 베타 테스터 전용 블루스크린

컴퓨터 오류 화면은 당황스럽지만, 내 PC가 어디가 아픈지 알려주는 중요한 단서이기도 합니다. 오류 코드를 잘 확인해 두시면 수리하거나 원인을 찾을 때 큰 도움이 됩니다. 평소에 중요한 자료는 꼭 이중으로 백업해 두는 습관을 들이는 것이 가장 좋습니다!

컴퓨터에 문제가 생겼을 때, 마우스로 메뉴를 이리저리 찾는 것보다 명령어 한 줄을 입력하는 게 훨씬 빠르고 정확할 때가 많습니다. 포맷 전 필수 백업부터 윈도우 최적화, 네트워크 오류 해결까지! 알아두면 컴맹도 '컴잘알' 소리를 듣게 해주는 마법의 윈도우 명령어 15가지를 총망라했습니다.

💡 사용 전 꿀팁: 아래 명령어들은 명령 프롬프트(cmd) 또는 Windows PowerShell을 '관리자 권한으로 실행'해야 완벽하게 작동합니다. (시작 메뉴에서 'cmd' 검색 후 우클릭 -> 관리자 권한으로 실행)

1. 내 컴퓨터 드라이버 통째로 백업 (포맷 전 필수!)

포맷 후 드라이버를 하나하나 다시 잡는 귀찮음을 덜어줍니다. 현재 설치된 모든 드라이버를 원하는 폴더에 쏙 빼놓습니다.

dism /online /export-driver /destination:D:\WinDrivers

• 활용 팁: D:\WinDrivers를 원하는 경로로 바꿔 사용하세요. 포맷 후 장치 관리자에서 이 폴더만 지정해주면 드라이버 설치가 끝납니다.

2. 가벼운 윈도우 오류가 뜰 때: 시스템 파일 복구

블루스크린이 뜨거나 윈도우가 꼬였을 때 가장 먼저 시도하는 기본 복구 명령어입니다.

sfc /scannow

• 활용 팁: 100% 완료될 때까지 기다리세요. 손상된 시스템 파일을 찾아 자동으로 치료해 줍니다.

3. 심각한 윈도우 오류가 뜰 때: 윈도우 이미지 복구

sfc /scannow로도 해결되지 않는 깊은 오류가 났을 때, 윈도우 업데이트 서버에서 원본 파일을 내려받아 시스템을 뜯어고칩니다.

DISM /Online /Cleanup-Image /RestoreHealth

• 활용 팁: 인터넷이 연결되어 있어야 작동하며, 2번(sfc) 명령어를 쓰기 전에 먼저 실행해주면 효과가 더 좋습니다.

4. 까먹은 와이파이(Wi-Fi) 비밀번호 알아내기

현재 연결된, 혹은 예전에 연결했던 와이파이의 비밀번호가 가물가물할 때 사용합니다.

netsh wlan show profile name="와이파이이름" key=clear

• 활용 팁: "와이파이이름"에 와이파이 이름을 정확히 입력하세요. 결과창의 '키 콘텐츠' 항목에서 비밀번호를 확인할 수 있습니다.

5. 내 노트북 배터리 수명/상태 확인 (중고 거래 필수!)

배터리 설계 용량 대비 현재 얼마나 충전되는지, 사이클은 몇 번인지 상세 리포트를 뽑아줍니다.

powercfg /batteryreport

• 활용 팁: C:\Windows\System32\battery-report.html 경로에 파일이 생성됩니다. 브라우저로 열어보세요.

6. C드라이브 용량 쥐어짜기 (최대 절전 모드 끄기)

노트북이 아닌 데스크탑이라면 잘 쓰지 않는 '최대 절전 모드'를 꺼서 C드라이브 용량을 수 기가바이트(GB) 확보할 수 있습니다.

powercfg -h off

• 활용 팁: 다시 켜고 싶다면 off 대신 on을 입력하면 됩니다.

7. 인터넷이 갑자기 느리거나 안 들어갈 때

네트워크 설정이 꼬여 특정 사이트가 안 열릴 때, 불필요한 DNS 캐시를 싹 청소해 인터넷을 쾌적하게 만듭니다.

ipconfig /flushdns

• 활용 팁: 이 명령어를 치고 브라우저를 껐다 켜보세요.

8. 우리 집 인터넷 끊김 현상 확인하기

인터넷이 자꾸 끊기는 것 같을 때 구글 서버(8.8.8.8)로 계속 신호를 보내 연결 상태를 체크합니다.

ping -t 8.8.8.8

• 활용 팁: 요청 시간이 만료되었습니다.라는 메시지가 자주 뜬다면 인터넷 회선에 문제가 있는 것입니다. 중지하려면 Ctrl + C를 누르세요.

9. 디스크(HDD/SSD) 물리적 오류 검사 및 치료

디스크에 배드섹터나 문제가 생겼을 때 오류를 검사하고 수정합니다.

chkdsk C: /f /r

• 활용 팁: Y를 누르고 컴퓨터를 재부팅하면 부팅 전 꼼꼼하게 디스크를 검사합니다.

10. 1초 만에 확인하는 내 디스크 건강 상태

내 하드디스크나 SSD가 당장 고장 날 위험이 있는지 S.M.A.R.T. 상태를 빠르게 체크합니다.

wmic diskdrive get status

• 활용 팁: 결과에 OK가 뜬다면 정상입니다. 만약 다른 단어가 뜬다면 당장 데이터를 백업하세요!

11. 컴퓨터 사양 및 윈도우 설치 날짜 확인

내 컴퓨터의 세부 정보와 윈도우를 언제 설치했는지, 부팅된 지 얼마나 지났는지 한눈에 봅니다.

systeminfo

• 활용 팁: 중고 PC를 샀을 때, 시스템이 언제 세팅되었는지 확인할 때 아주 유용합니다.

12. 원하는 시간에 컴퓨터 자동 종료하기

밤에 대용량 다운로드를 걸어놓고 잘 때 유용합니다. (아래는 1시간(3600초) 뒤 종료 명령어입니다.)

shutdown -s -t 3600

• 활용 팁: 숫자를 원하는 '초' 단위로 바꿔주세요. 만약 예약을 취소하고 싶다면 shutdown -a를 입력하면 됩니다.

13. 절대 안 꺼지는 '렉 먹은' 프로그램 강제 종료

작업 관리자로도 안 꺼지고 멈춰버린 악질 프로그램을 강제로 죽입니다.

taskkill /f /im "프로그램명.exe"

• 활용 팁: 예컨대 크롬이 멈춰서 안 꺼진다면 taskkill /f /im "chrome.exe"를 입력하면 즉시 강제 종료됩니다.

14. 내 컴퓨터에 설치된 모든 프로그램 한 방에 업데이트 (Win10/11)

스마트폰 앱 업데이트하듯, 컴퓨터에 깔린 각종 프로그램(크롬, 카카오톡, 줌 등)을 최신 버전으로 한 번에 업데이트합니다.

winget upgrade --all

• 활용 팁: 약관 동의를 묻는다면 Y를 누르세요. (일부 윈도우 버전에서는 winget이 미리 설치되어 있어야 작동할 수 있습니다.)

15. 중고로 PC 팔기 전, 내 개인정보 영구 삭제(Shred)

파일을 휴지통에서 비워도 복구 프로그램으로 살릴 수 있다는 사실, 아시나요? 이 명령어는 빈 공간에 더미 데이터를 덮어씌워 예전에 지웠던 파일들의 복구를 원천 차단합니다.

cipher /w:C:\

• 활용 팁: C:\는 드라이브 문자입니다. 시간이 꽤 오래 걸리지만, 컴퓨터나 저장 매체를 중고로 팔 때 내 개인정보를 지키는 가장 확실한 방법입니다.

마치며 명령 프롬프트의 까만 화면이 처음엔 낯설게 느껴질 수 있지만, 이 명령어들을 복사/붙여넣기 하다 보면 윈도우의 숨겨진 기능을 100% 활용하는 자신을 발견하게 될 것입니다. 스크랩해 두시고 필요할 때마다 유용하게 꺼내 쓰세요!

1. 첫 번째 관문: 낡은 패키지 버리기 (Git & Node.js 업그레이드)

우분투를 처음 설치하고 sudo apt install git이나 nodejs를 치면 설치는 됩니다. 하지만 버전이 너무 낮아서 최신 도구들이 작동하지 않는 에러를 뿜어냅니다. 기초 공사부터 튼튼히 다시 해봅시다.

1-1. Git 최신 버전으로 올리기

요즘 나오는 편리한 Git 도구(Lazygit 등)는 최소 2.32.0 이상의 Git 버전을 요구합니다. 공식 저장소(PPA)를 추가해서 최신 버전을 당겨옵니다.

# 1. 최신 Git을 받을 수 있는 주소(PPA)를 시스템에 추가합니다.
sudo add-apt-repository ppa:git-core/ppa

# 2. 우분투에게 "새로운 주소록을 읽어와!" 라고 명령합니다.
sudo apt update

# 3. 최신 버전의 Git을 설치합니다.
sudo apt install git

# 4. 2.3x.x 이상으로 잘 설치되었는지 확인!
git --version

1-2. Node.js 설치 (NVM 사용 필수!)

나중에 설치할 Claude Code는 Node.js 기반으로 돌아갑니다. 우분투 기본 노드는 10.x 버전이라 너무 낡았고, 권한 문제(EACCES 에러)를 일으킵니다. 이를 해결하기 위해 **NVM(Node Version Manager)**이라는 도구를 씁니다.

# 1. NVM 설치 (우분투 시스템 전체가 아닌 내 계정 폴더에만 안전하게 설치됩니다)
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash

# 2. 터미널을 껐다 켜거나, 아래 명령어로 환경을 바로 적용합니다.
source ~/.bashrc

# 3. 최신 안정화(LTS) 버전의 Node.js를 설치합니다. (이때 npm도 같이 설치됩니다!)
nvm install --lts

# 4. 버전 확인 (v18 이상이면 성공입니다)
node -v

2. 두 번째 관문: GitHub 프라이빗 저장소 인증 해결하기 (gh)

내 소중한 코드가 담긴 비공개(Private) 저장소를 가져오거나 수정본을 올리려면 권한이 필요합니다. 매번 복잡한 토큰을 복사하는 대신, GitHub CLI(gh)를 설치해 한 번의 로그인으로 끝내봅시다.

🚨 초보자 주의: 에러 창에서 snap install gh를 추천한다고 그대로 치시면 안 됩니다! WSL은 snap 기능을 제대로 지원하지 않습니다.

가장 확실한 방법은 설치 파일(.deb)을 직접 받아서 까는 것입니다.

# 1. GitHub CLI 최신 설치 파일을 다운로드합니다.
wget https://github.com/cli/cli/releases/download/v2.45.0/gh_2.45.0_linux_amd64.deb

# 2. 다운받은 파일을 설치합니다.
sudo apt install ./gh_2.45.0_linux_amd64.deb

-- 위방식으로 진행이 안될때 (아래 공식 설치 가이드 방식으로)

# 1. 키링을 저장할 폴더 생성
sudo mkdir -p -m 755 /etc/apt/keyrings

# 2. 공식 GitHub CLI 키 다운로드
wget -qO- https://cli.github.com/packages/githubcli-archive-keyring.gpg | sudo tee /etc/apt/keyrings/githubcli-archive-keyring.gpg > /dev/null

# 3. 권한 설정
sudo chmod go+r /etc/apt/keyrings/githubcli-archive-keyring.gpg

# 4. 저장소 리스트에 추가
echo "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/githubcli-archive-keyring.gpg] https://cli.github.com/packages stable main" | sudo tee /etc/apt/keyrings/github-cli.list > /dev/null

# 5. 업데이트 및 설치
sudo apt update
sudo apt install gh -y

설치가 끝났다면 대망의 로그인을 진행합니다.

gh auth login

터미널에서 영어로 질문이 나오면 키보드 화살표와 엔터를 이용해 아래처럼 답해주세요.

• What account do you want to log into? GitHub.com
• What is your preferred protocol for Git operations? HTTPS (가장 간편합니다)
• Authenticate Git with your GitHub credentials? Yes
• How would you like to authenticate GitHub CLI? Login with a web browser
• 화면에 나타난 8자리 코드(예: ABCD-1234)를 복사한 뒤 엔터를 누르면 웹 브라우저가 열립니다. 그곳에 코드를 입력하고 Authorize를 누르면 끝!

⚠️ WSL 브라우저 에러 대처법: WSL 터미널에서 윈도우 브라우저를 띄우지 못해 에러(Exec format error)가 날 수 있습니다. 당황하지 마시고 터미널에 뜬 https://github.com/login/device 주소를 직접 복사해서 크롬 등 브라우저에 붙여넣으세요. 그리고 터미널에 나온 8자리 영문/숫자 코드를 입력하면 권한 승인이 완료됩니다!

3. 세 번째 관문: 마우스 없이 Git을 시각적으로 다루기 (Lazygit)

이제 인증도 뚫렸으니 Git을 써야 하는데, git add, git commit 같은 명령어를 매번 치기 어렵죠. 터미널 안에서 그래픽(GUI)처럼 Git을 조작할 수 있게 해주는 Lazygit을 설치해 봅시다.

# Lazygit 최신 버전을 다운로드하고 설치하는 마법의 명령어 모음입니다. 그대로 복사해 붙여넣으세요.
LAZYGIT_VERSION=$(curl -s "https://api.github.com/repos/jesseduffield/lazygit/releases/latest" | grep -Po '"tag_name": "v\K[^"]*')
curl -Lo lazygit.tar.gz "https://github.com/jesseduffield/lazygit/releases/latest/download/lazygit_${LAZYGIT_VERSION}_Linux_x86_64.tar.gz"
tar xf lazygit.tar.gz lazygit
sudo install lazygit /usr/local/bin

설치 후 프로젝트 폴더에서 lazygit이라고 타이핑하면 멋진 화면이 뜹니다. 초보자라면 이 3가지 단축키만 기억하세요!

1. Space: 수정한 파일 선택하기 (git add)
2. c: 저장할 메시지 적기 (git commit)
3. P (Shift+p): GitHub로 쏘아 올리기 (git push)

방금 gh로 인증을 마쳐두었기 때문에, P를 눌러도 아이디나 비밀번호를 묻지 않고 쾌적하게 쑥쑥 올라갑니다.

4. 최종 관문: 내 터미널에 AI 비서 고용하기 (Claude Code)

기반 시설이 모두 갖춰졌으니, 이제 방점을 찍어보겠습니다. Anthropic사에서 만든 터미널용 AI 비서 Claude Code를 설치합니다. (아까 NVM을 깔아둔 덕분에 권한 에러 없이 깔끔하게 설치됩니다!)

npm install -g @anthropic-ai/claude-code

설치가 완료되면 내 프로젝트 폴더에서 claude를 입력해 보세요. 첫 실행 시 계정 연동 창이 뜨고, 연동 후에는 터미널이 AI 채팅창으로 변합니다.

이렇게 활용해 보세요!

• "지금 이 프로젝트 구조 좀 설명해 줄래?"
• "app.js 파일에 로그인 기능을 추가해 줘."
• "방금 내가 수정한 내용들 확인해서, 알아서 커밋 메시지 쓰고 git push까지 해줘."

Claude Code는 단순히 코드만 짜주는 게 아닙니다. 우리가 2단계에서 설정해 둔 gh 인증을 공유받아, 내 명령 한마디에 파일 수정부터 Git 커밋, GitHub 푸시까지 모든 과정을 자동으로 수행합니다.

리눅스 기본 명령어표 2026: AI·데이터·서버 작업에 필요한 핵심

AI 개발 환경(서버, GPU, Docker, 데이터 처리, 로그 분석)에서 리눅스는 이제 선택이 아니라 기본이다.
특히 “자주 쓰는 명령어”를 빠르게 꺼내 쓰는 능력만으로도 생산성이 확 올라간다.

이 글은 AI·데이터·서버 작업에서 실제로 많이 쓰는 리눅스 핵심 명령어를 치트시트(명령어표) 형식으로 정리했다.

1) 리눅스 기본 문법 3가지만 먼저

리눅스 명령어는 대체로 아래 패턴이 많다.

명령어 옵션 대상

자주 쓰는 옵션 감각

• -h : 도움말(Help)
• -a : all (숨김 포함)
• -l : 자세히 보기(long)
• -r : 재귀(recursive)
• -f : 강제(force)
• -n : 실행 없이 미리보기/줄번호 등(명령마다 의미 다름)

파이프 & 리다이렉션

A | B      # A 결과를 B 입력으로 전달
A > file   # 덮어쓰기 저장
A >> file  # 이어붙이기 저장

2) 파일/디렉토리 관리 (기본 중의 기본)

AI 프로젝트는 파일이 많고, 디렉토리도 복잡해지기 쉬워서 파일 탐색 속도가 체감 차이를 만든다.

실무에서 진짜 많이 쓰는 조합

✅ 로그 실시간 보기

tail -f train.log

✅ 용량 큰 디렉토리 찾기

du -sh * | sort -h

✅ 실수 방지 팁 (삭제 전 확인)

rm -i file.txt

3) 텍스트 검색/필터링 (로그 분석 필수)

AI 서버에서 가장 많이 하는 일 중 하나가 로그에서 에러 찾기다.

로그에서 에러만 뽑기

grep -n "ERROR" train.log

가장 최근 로그 300줄에서 warning만 보기

tail -n 300 train.log | grep -i "warning"

특정 키워드 포함 파일 찾기(폴더 전체)

grep -r "API_KEY" .

4) 권한/소유권 (서버에서 자주 터지는 문제)

“Permission denied”가 뜨면 대부분 여기서 해결된다.

chmod 숫자 뜻(빠른 기억)

• 7 = 읽기(4) + 쓰기(2) + 실행(1)
• 755 = 소유자(7), 그룹(5), 기타(5)

✅ 실행 권한 주기

chmod +x run.sh

5) 프로세스/자원 모니터링 (서버 필수)

훈련 돌릴 때, 프로세스가 살아있는지/CPU가 터지는지 확인이 중요하다.

특정 프로세스 찾기

ps aux | grep python

강제 종료(최후의 수단)

kill -9 12345

백그라운드 실행 + 로그 저장

nohup python train.py > train.log 2>&1 &

6) 네트워크/서버 점검 (원격 작업 핵심)

원격 서버에 붙어서 작업하는 경우가 많아서 필수다.

API 서버가 살아있는지 확인

curl -I http://localhost:8000

포트 점유 확인

ss -lntp

7) 압축/해제 (데이터 다룰 때 매일 씀)

데이터셋 다운로드하면 대부분 압축되어 있다.

✅ 폴더를 tar.gz로 압축

tar -czvf backup.tar.gz myfolder/

8) 환경변수/경로/셸 (AI 개발자 필수)

CUDA 경로, Python path, 토큰 같은 것들이 여기에 걸린다.

GPU 선택해서 실행

export CUDA_VISIBLE_DEVICES=0
python train.py

9) Python/가상환경 (AI 작업용 베스트)

conda, venv, pip는 거의 기본이다.

pip 기본

pip install -U pip
pip install -r requirements.txt
pip list
pip show torch

venv 예시

python -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt

conda 예시

conda create -n ai python=3.11 -y
conda activate ai
conda install numpy -y

10) GPU/디바이스 체크 (AI 서버에서 가장 자주)

NVIDIA GPU 서버라면 거의 국룰.

✅ 1초마다 GPU 상태 확인

watch -n 1 nvidia-smi

11) Docker (AI 배포/실험 환경에서 필수)

AI 시대에는 “내 PC에서는 됐는데 서버에서 안 됨”을 없애려면 컨테이너가 답일 때가 많다.

✅ 컨테이너 로그 실시간 보기

docker logs -f myapp

✅ 컨테이너 내부 접속

docker exec -it myapp bash

12) “AI·데이터·서버 실무” 자주 쓰는 상황별 레시피

(1) 학습 실행 + 로그 저장 + 백그라운드

nohup python train.py --config config.yaml > train.log 2>&1 &

(2) 에러 발생 지점 빠르게 찾기

grep -n "Traceback" train.log
grep -n "CUDA out of memory" train.log

(3) 용량 부족할 때 top 범인 찾기

df -h
du -sh * | sort -h

(4) 포트 충돌 해결(서버 실행이 안 될 때)

lsof -i :8000
kill -9 PID

(5) 데이터 서버에서 로컬로 가져오기

scp user@server:/data/result.csv .

13) 리눅스 명령어표 치트시트(요약)

이 섹션만 저장해도 일단 실무 커버 가능

파일/탐색

pwd
ls -al
cd /path
mkdir -p dir
cp -r a b
mv a b
rm -rf dir
du -sh *
df -h

로그/검색

tail -f app.log
grep -n "ERROR" app.log
tail -n 300 app.log | grep -i warning

프로세스

ps aux | grep python
top
kill -9 PID
nohup cmd > out.log 2>&1 &

네트워크

ssh user@ip
scp file user@ip:/path
curl http://localhost:8000
ss -lntp

GPU

nvidia-smi
watch -n 1 nvidia-smi

Docker

docker ps
docker exec -it name bash
docker logs -f name

마무리

리눅스 명령어는 “완벽하게 외우는 것”보다,
자주 쓰는 것만 빠르게 꺼내 쓰는 습관이 더 중요하다.

이 글을 북마크해두고 아래 흐름만 익숙해져도 실무에서 크게 편해진다.

• 파일 탐색(du/df)
• 로그 확인(tail/grep)
• 프로세스 점검(ps/top/kill)
• 서버 통신(ssh/scp/curl)
• GPU 체크(nvidia-smi)
• Docker 운영(docker ps/exec/logs)

컨테이너를 다루다 보면 Docker는 익숙한데, 어느 순간부터 containerd라는 이름이 계속 등장합니다.
특히 Kubernetes 환경에서는 “Docker 대신 containerd 쓰세요” 같은 말을 자주 듣게 되죠.

오늘은 containerd가 정확히 뭘 하는지, Docker와 관계가 뭔지, Kubernetes에서 왜 중요한지를 포스팅용으로 깔끔하게 정리합니다.

✅ 한 줄 정의

🧩 containerd = 컨테이너를 “다운로드하고 실행하고 관리하는” 경량 런타임

즉, 컨테이너를 직접 실행하는 엔진 역할만 집중해서 수행하는 구성 요소입니다.

📌 containerd가 하는 일 (역할 정리)

containerd는 “컨테이너 운영에 필요한 핵심 기능”을 담당합니다.

👉 핵심 포인트는 이거예요:

✅ “컨테이너 실행과 운영” 에만 집중한 Low-level 엔진

🧱 containerd는 어디서 쓰일까?

실제로 containerd는 다양한 곳에서 기본 런타임으로 쓰입니다.

🔄 Docker와 containerd 관계 (제일 많이 헷갈리는 부분)

많은 사람이 “Docker = 컨테이너 런타임”이라고 생각하지만, 실제로는 구조가 이렇게 됩니다.

✅ Docker는 “고수준 도구(High-level)”

• 이미지 빌드 (docker build)
• 네트워크/볼륨
• Dockerfile 기반 개발 경험 제공
• 사용하기 편한 UX 제공

✅ containerd는 “저수준 엔진(Low-level)”

• 실제로 컨테이너를 실행하고 관리하는 역할

🧩 구조로 보면 이렇게 이해하면 끝

Docker CLI
↓ 
Docker Engine
↓ 
containerd
↓ 
runc (실제로 리눅스 컨테이너 프로세스를 실행)

✅ 결론:

Docker는 사용자 편의 도구(껍데기)
containerd는 컨테이너 실행 엔진(본체)

⚙️ containerd 직접 설치 (Ubuntu)

Docker 없이도 containerd만 설치해서 컨테이너를 운영할 수 있습니다.

sudo apt update sudo apt install -y containerd

기본 설정 파일 생성:

sudo mkdir -p /etc/containerd 
containerd config default | sudo tee /etc/containerd/config.toml 
sudo systemctl restart containerd

🧪 containerd 실사용 예시 (nerdctl)

containerd를 직접 쓰려면 nerdctl이 거의 필수입니다.
(느낌이 “도커 클론 CLI”라고 보면 됩니다)

예시: nginx 띄우기

nerdctl run -d -p 80:80 nginx

상태 확인

nerdctl ps

이미지 목록 확인

nerdctl images

✅ 핵심:

Docker 없이도 containerd + nerdctl로 컨테이너 운영이 가능하다

✅ containerd 요약 (포스팅용 결론 표)

💡 왜 containerd가 중요해졌을까?

• Docker는 개발 경험(빌드/UX)에 강함
• Kubernetes는 런타임 표준(CRI) 기반으로 더 가볍고 범용적인 엔진을 선호
• 그래서 “K8s = containerd” 흐름이 자연스러워졌습니다.

✅ 특히 운영 관점에서는:

Docker의 많은 기능이 필요 없는 서버 환경에서는
containerd가 더 “딱 필요한 만큼만” 제공해서 효율적입니다.

쿠버네티스(Kubernetes)를 쓴다는 것은 단순히 도커 컨테이너를 돌리는 것이 아닙니다. 핵심은 "사람이 수동으로 하던 일을 시스템이 알아서 하게 만드는 것" 즉, 자동화(Automation)에 있습니다.

쿠버네티스가 제공하는 자동화 기능은 생각보다 광범위합니다. 배포, 스케일링, 복구, 보안까지, K8s가 어디까지 자동으로 처리해 줄 수 있는지 영역별로 정리해 보았습니다.

1. 애플리케이션 수명주기 (Lifecycle) 자동화

애플리케이션이 태어나서(배포), 업데이트되고(롤링), 문제가 생기면 되살아나는(복구) 과정입니다. 개발자가 가장 피부로 느끼는 자동화 영역입니다.

• 배포 (Deployment Strategies):
  • 새로운 버전의 앱을 중단 없이 배포합니다.
  • Rolling Update: 구버전을 하나씩 줄이고 신버전을 늘려가는 기본 방식.
  • Canary/Blue-Green: 일부 트래픽만 신버전으로 보내거나(Canary), 전체를 교체하여(Blue-Green) 리스크를 최소화.
• 자가 치유 (Self-healing):
  • Pod가 메모리 부족이나 에러로 죽으면, ReplicaSet이 이를 감지하고 즉시 새 Pod를 생성합니다. "꺼졌다 켜기"의 자동화입니다.
• 롤백 (Rollback):
  • 배포 후 심각한 버그가 발견되면 undo 명령 하나로 이전 버전의 안정적인 상태로 자동 원복됩니다.
• 설정 관리 (ConfigMap/Secret):
  • 이미지 빌드 없이 설정값만 바꿔서 앱 동작을 변경합니다. Pod가 재시작될 때 변경된 설정을 자동 로드하게 구성할 수 있습니다.

2. 스케일링 및 리소스 관리 자동화

트래픽이 폭주하거나 노드 자원이 부족할 때, 사람의 개입 없이 시스템 크기를 조절합니다.

• 스케일링 (Scaling):
  • HPA (Horizontal Pod Autoscaler): CPU 사용량이 늘어나면 Pod 개수를 늘립니다 (가로 확장).
  • VPA (Vertical Pod Autoscaler): Pod가 더 많은 자원을 필요로 하면 CPU/Memory 할당량을 늘립니다 (세로 확장).
  • CA (Cluster Autoscaler): Pod를 띄울 공간(노드)이 부족하면 클라우드 인스턴스를 추가해 노드를 늘립니다.
• 노드 관리 (Node Management):
  • 노드에 장애가 생기거나 점검이 필요할 때(Drain), 해당 노드의 Pod를 다른 건강한 노드로 자동 이사시킵니다.
• 리소스 제어 (Namespace Quota):
  • 특정 팀이나 프로젝트가 클러스터 자원을 독점하지 못하도록 사용량을 자동으로 제한합니다.

3. 운영 및 인프라 자동화 (Ops)

시스템 운영에 필요한 반복적인 작업과 네트워크, 백업 등을 담당합니다.

• 네트워크 라우팅 (Ingress Controller):
  • 외부에서 들어오는 복잡한 트래픽을 도메인이나 경로(Path)에 따라 적절한 서비스로 자동 라우팅합니다 (L7 로드밸런싱).
• 배치 작업 (CronJob):
  • 매일 밤 데이터 집계, 임시 파일 삭제 등 주기적인 작업을 리눅스 Crontab처럼 스케줄링하여 자동 실행합니다.
• 백업 및 복구 (Velero):
  • 클러스터의 리소스 설정(YAML)과 영구 볼륨(PV) 데이터를 주기적으로 스냅샷 떠서 자동 백업하고, 재해 시 복구합니다.
• CI/CD (GitOps - ArgoCD/Flux):
  • Git 저장소에 코드가 푸시되면, 클러스터 상태를 Git과 동일하게 **자동 동기화(Sync)**하여 배포합니다.

4. 보안 및 정책 자동화 (Security)

보안은 '지키는 것'이 아니라 '시스템에 녹이는 것'입니다.

• 인증/인가 (RBAC & OPA):
  • 누가 어떤 API를 호출할 수 있는지 권한을 제어합니다.
  • OPA Gatekeeper: "특정 레지스트리의 이미지만 허용", "LoadBalancer 생성 금지" 등 정책 위반 요청을 자동으로 차단합니다.
• 보안 스캔 (Trivy/Kyverno):
  • 배포되는 이미지에 보안 취약점(CVE)이 있는지 스캔하거나, 파드가 보안 컨텍스트(Root 실행 등)를 위반했는지 자동 감지합니다.

5. 고급 자동화 (Advanced)

쿠버네티스의 기능을 확장하여 나만의 로직을 구현합니다.

• 이벤트 대응 (Event & Operator):
  • 단순한 리소스 관리를 넘어, "DB 스키마 마이그레이션", "장애 조치(Failover)" 등 복잡한 애플리케이션 운영 지식을 코드로 만들어 자동 수행합니다. (Operator 패턴)

쿠버네티스에서 문제 원인을 파악하거나 간단한 테스트를 하려는데, 매번 긴 YAML 파일을 작성하고 계신가요?

kubectl run 명령 한 줄이면 충분합니다. 상황에 딱 맞는 초경량/전문가용 이미지와 명령어 조합을 정리했습니다.

Tip: 디버깅이 끝나면 Pod가 남지 않도록 --rm -i --tty 옵션을 자주 활용하게 되지만, 아래 예시들은 프로세스를 유지시켜(sleep 3600 등) 접속해서 테스트하기 좋은 형태를 기준으로 정리했습니다.

1. 기본 접속 및 네트워크 종합 진단

가장 범용적으로 쓰이는 도구들입니다. 셸 접속이 필요하거나 트래픽 덤프를 떠야 할 때 사용합니다.

🛠 기본 셸 접속 (가벼운 확인)

가장 가벼운 이미지로 빠르게 파드를 띄워 셸(sh)에 접속합니다. 기본적인 ping, wget 등이 포함되어 있습니다.

kubectl run test --image=busybox --restart=Never -- sleep 3600
# 접속: kubectl exec -it test -- sh

🩺 네트워크 심층 디버깅 (강력 추천)

네트워크 엔지니어의 스위스 아미 나이프입니다. tcpdump, dig, curl, nmap 등 거의 모든 네트워크 툴이 포함되어 있습니다.

kubectl run netshoot --rm -i --tty --image=nicolaka/netshoot -- bash

2. HTTP 및 DNS 연결 테스트

API 호출이 잘 되는지, 도메인 주소가 올바른 IP로 떨어지는지 확인할 때 사용합니다.

🌐 Curl 전용 (API 테스트)

OS 라이브러리 없이 깔끔하게 curl만 필요할 때 적합합니다.

kubectl run curl-pod --image=curlimages/curl --restart=Never -- sleep 3600
# 사용: kubectl exec -it curl-pod -- curl http://target-service

🔍 DNS 조회 (DNS Tools)

CoreDNS 문제인지, 외부 도메인 문제인지 헷갈릴 때 nslookup, dig, host 명령어로 명확히 진단합니다.

kubectl run dnstools --image=infoblox/dnstools --restart=Never -- sleep 3600
# 사용: kubectl exec -it dnstools -- dig google.com

3. 서버 포트 및 리스너 테스트

특정 포트가 열려 있는지, 혹은 내 서비스가 정상적으로 클러스터 내부에 노출되는지 확인합니다.

📡 TCP/UDP 서버 흉내 (Netcat)

간단하게 특정 포트(예: 1234)를 열어두고 통신이 도달하는지 테스트할 때 유용합니다.

kubectl run nc-server --image=appropriate/nc --restart=Never --command -- sh -c "nc -lkp 1234"

🐍 간단한 HTTP 서버 (Python/Flask)

직접 로직을 태워야 한다면 Python 이미지를 빌드하거나 사용합니다.

• Custom Build: Dockerfile (Python 3.12-slim + Flask) 작성 후 빌드/배포
• One-Liner (Tip): 이미지를 빌드하기 귀찮다면 Python 기본 이미지로 1초 만에 파일 서버를 띄울 수도 있습니다.

  kubectl run temp-web --image=python:3.12-slim --restart=Never -- python3 -m http.server 8000
  

📢 서비스 노출 (Service 생성)

위에서 띄운 서버 Pod를 클러스터 내부 다른 Pod들이 찾을 수 있도록 Service로 만듭니다.

kubectl expose pod myserver --type=ClusterIP --port=5000

4. 성능 및 부하 테스트 (Load & Stress)

서비스가 얼마나 버티는지, 리소스 제한(Limit) 설정이 잘 동작하는지 확인할 때 사용합니다.

💥 HTTP 부하 테스트 (Hey)

Apache Bench(ab)와 유사하지만 더 현대적인 도구입니다. 특정 엔드포인트에 대량의 요청을 쏘아봅니다.

kubectl run hey --image=rakyll/hey --restart=Never -- sleep 3600
# 사용: kubectl exec -it hey -- hey -n 1000 -c 50 http://my-service

🏋️ CPU/Memory 스트레스 테스트

Pod에 할당된 리소스 쿼터(Limit)가 찼을 때 OOMKilled가 발생하는지, HPA가 동작하는지 테스트합니다.

kubectl run stress --image=alpine/stress --restart=Never -- --cpu 1 --timeout 30s

요약 테이블

개발을 하다 보면 Hook(훅)과 Trigger(트리거)라는 용어를 정말 자주 접하게 됩니다. 둘 다 "어떤 일이 일어날 때 실행된다"는 점에서는 비슷해 보이지만, 작동 원리와 목적에는 분명한 차이가 있습니다.

이 두 가지 개념을 명확히 구분하여 적재적소에 사용하는 것이 시스템 설계의 핵심입니다. 이번 포스팅에서는 표와 예시를 통해 두 용어의 차이점을 확실히 정리해 보겠습니다.

1. 한눈에 보는 핵심 차이

가장 쉬운 비유로 시작해 볼까요?

• Hook (갈고리): 흐르는 물(프로세스)에 갈고리를 걸어 뭔가를 낚아채거나, 흐름 중간에 내 물건을 걸어두는 것.
• Trigger (방아쇠): 총의 방아쇠처럼, 특정 조건이 당겨지면 자동으로 총알(이벤트)이 발사되는 것.

2. 상세 비교표 (Hook vs Trigger)

3. Hook (훅): 흐름을 가로채다

Hook은 "라이프사이클(Lifecycle)"과 깊은 관련이 있습니다. 프로그램이 실행되는 일련의 과정(시작 → 처리 → 종료) 속에 개발자가 원하는 코드를 '끼워 넣는' 방식입니다.

• 특징:
  • 주로 Before(전) / After(후)의 개념이 강합니다.
  • 메인 프로세스가 진행되다가 Hook이 걸린 지점을 만나면, 잠시 멈추거나 해당 코드를 실행한 뒤 다시 원래 흐름으로 돌아갑니다.
  • 예: "회원가입 버튼 클릭" → (Hook: 비밀번호 암호화) → "DB 저장"
• 사용 사례:
  • Git Hook: 커밋하기 전에 코드 포맷을 검사 (pre-commit).
  • Web Hook: 결제가 완료되면 슬랙으로 알림을 보내기 위해 외부 API를 호출.
  • React Hooks: 컴포넌트가 렌더링 된 직후 데이터를 가져옴 (useEffect).

4. Trigger (트리거): 조건에 반응하다

Trigger는 "인과관계(Cause & Effect)"가 핵심입니다. A라는 사건이 터지면, B라는 행동이 무조건 뒤따라오는 구조입니다.

• 특징:
  • 시스템이 항상 감시하고 있다가(Monitoring), 조건이 충족되면 즉시 발동합니다.
  • 주로 데이터베이스나 이벤트 기반 아키텍처(EDA)에서 많이 사용됩니다.
  • 예: "창고 재고가 0이 됨(Event)" → (Trigger: 발주 넣기) → "재고 채움"
• 사용 사례:
  • DB Trigger: Users 테이블에 새 회원이 추가되면(Insert), 자동으로 Logs 테이블에 가입 시간을 기록.
  • Cloud Trigger: S3 버킷에 이미지가 업로드되면, AWS Lambda가 실행되어 썸네일을 생성.
  • Marketing Trigger: 사용자가 장바구니에 물건을 담고 1시간 동안 결제하지 않으면 할인 쿠폰 메일 발송.

5. 요약: 언제 무엇을 써야 할까?

• Hook을 쓰세요:
  • 기존 로직의 앞뒤에 기능을 추가하고 싶을 때.
  • 데이터가 저장되기 전에 검증하거나 수정해야 할 때.
  • 외부 시스템으로 데이터를 전송(Push)해주고 싶을 때 (Webhook).
• Trigger를 쓰세요:
  • 특정 사건 발생 시 보장된 후속 작업이 필요할 때.
  • 데이터베이스 내에서 데이터 무결성을 자동으로 맞추고 싶을 때.
  • 시스템 간의 비동기적인 연동 작업이 필요할 때.

결론적으로,

Hook은 개발자가 흐름을 커스터마이징 하는 도구이고,

Trigger는 시스템이 규칙에 따라 자동으로 일하게 만드는 도구입니다.