Course

Claude 과정

기본 사용법부터 프롬프트·아티팩트·스킬·협업·연동·자동화·코딩·실전 사례·고급 운영까지 — Claude를 단계별로 익히는 커리큘럼입니다. 총 10개 모듈을 6페이지로 나눴습니다.

1. 시작하기

1 / 6

클로드코드 개발환경 설정

STEP 1

Claude Code는 macOS라면 별도 준비 없이 그대로 쓸 수 있지만, Windows라면 WSL(Windows Subsystem for Linux)을 설치하고 우분투 환경에서 실행하는 쪽이 압도적으로 유리합니다.

macOS는 이미 Unix 기반이라 추가 설치 없이 터미널에서 바로 Claude Code를 쓸 수 있다
Windows는 기본 제공되는 PowerShell·CMD보다 WSL2(Windows Subsystem for Linux) 위에서 실행하는 편이 훨씬 낫다
설치는 관리자 권한 PowerShell에서 wsl --install 한 줄이면 끝난다 — WSL2와 기본 배포판(Ubuntu)이 함께 깔린다
왜 WSL인가 — git·ripgrep·bash·ssh 같은 CLI 도구는 리눅스 환경에서 연동될 때 100% 성능을 낸다. PowerShell·CMD는 경로 표기(\ vs /)와 환경변수 처리 방식이 달라 명령어 오류가 잦다
Node.js·Python·Docker 같은 개발 패키지·권한(permission) 관리도 Windows보다 우분투 쪽이 훨씬 깔끔하게 작동한다
프로젝트 파일은 Windows 쪽 경로가 아니라 WSL의 리눅스 파일시스템(\\wsl$\Ubuntu\...) 안에 두고 작업해야 탐색 속도가 빠르고 인코딩·권한 버그가 거의 없다
결론 — Windows 사용자에게는 WSL2 + Ubuntu + VS Code(WSL 연동) 조합이 사실상의 모범 구성(Best Practice)이다

우분투에서 Claude Code 단계별 설치 방법

STEP 2

Claude Code는 터미널 안에서 곧바로 Claude와 대화하며 코드를 생성하고 여러 작업을 처리하는 Anthropic의 커맨드라인 도구(CLI)입니다. 브라우저를 오가지 않고 지금 쓰던 셸 안에서 바로 이어 쓸 수 있어, 터미널 중심으로 작업하는 우분투 사용자에게 특히 잘 맞습니다.

하던 작업 흐름을 벗어나지 않고 터미널에서 바로 코드 스니펫을 만든다
에러가 나면 그 자리에서 AI의 도움을 받아 원인을 좁혀간다
README·커밋 메시지 같은 문서화 작업을 자동화한다
아이디어를 빠르게 동작하는 코드로 옮겨 프로토타이핑한다

사전 준비물

Ubuntu 20.04 LTS 이상(24.04까지 확인됨) — 다른 데비안 계열 배포판도 대체로 그대로 따라 할 수 있다
Node.js 18 이상과 npm
Anthropic API 키(Anthropic 사이트에서 가입 후 발급)
git · ripgrep — 필수는 아니지만 있으면 파일 검색이 훨씬 빨라진다
여유 디스크 공간 100MB 이상

Node.js가 이미 깔려 있다면 버전만 확인하면 된다.

설치 단계

1. 시스템 패키지 업데이트

새 소프트웨어를 깔기 전에 기존 패키지 목록과 설치본을 최신으로 맞춘다.

2. Node.js · npm 설치(아직 없다면)

공식 NodeSource 저장소를 등록해 LTS 18.x 버전을 받아온다.

설치가 끝나면 버전을 확인한다.

시작하기