Claude Code 설치는 명령어 한 줄이면 끝납니다. 이 글은 클로드 코드 사용법의 첫걸음으로, 설치부터 첫 실행·로그인·자연어 지시까지 입문자가 그대로 따라 할 수 있게 정리했습니다. Claude Code는 터미널에서 도는 AI 코딩 에이전트라, 채팅앱과 달리 내 프로젝트 파일을 직접 읽고 고칩니다.
1. Claude Code란?
Claude Code는 터미널(명령창)에서 실행되는 코딩 에이전트입니다. 프로젝트 전체 맥락을 이해하고 여러 파일을 직접 수정하며, 자연어로 지시하면 스스로 작업을 이어갑니다(파일을 바꾸기 전에는 권한을 물어봅니다). 사용하려면 Claude Pro 이상 구독이 필요합니다. (플랜 차이는 앱·Claude Code·API 비교 글 참고.)
2. 설치하기 (운영체제별)
2026년 현재 권장 방식은 네이티브 설치입니다. Node.js 같은 별도 설치 없이 한 줄로 끝나고 자동 업데이트됩니다.
macOS / Linux — 터미널에 입력:
curl -fsSL https://claude.ai/install.sh | bashWindows (PowerShell):
irm https://claude.ai/install.ps1 | iexWindows (CMD):
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd이미 Node.js가 있고 npm이 익숙하다면 대안으로 이렇게도 됩니다(Node.js 18+ 필요):
npm install -g @anthropic-ai/claude-code요구 사양은 macOS 13+, Windows 10(1809)+, Ubuntu 20.04+ 정도이고, 네이티브 Windows 설치에는 Git for Windows가 필요합니다. (최신 명령·요건은 공식 설치 문서에서 확인 — 최종 확인일 2026-05-26.)
3. 첫 실행 & 로그인
설치가 끝나면 작업할 프로젝트 폴더로 이동한 뒤 claude 를 입력합니다.
cd 내-프로젝트-폴더
claude처음 실행하면 브라우저가 자동으로 열려 로그인(또는 인증)을 진행합니다. 로그인하면 터미널에 대화 프롬프트가 뜨고, 여기에 한국어로 지시하면 됩니다. 예: “이 프로젝트가 무슨 일을 하는지 요약해줘”, “로그인 폼에 입력값 검증을 추가해줘”.
4. ‘권한 요청’을 이해하자
Claude Code는 파일을 수정하거나 명령을 실행하기 전에 권한을 묻습니다. 무엇을 바꾸려는지 보여주고 승인을 기다리므로, 내용을 확인한 뒤 허용하세요. 처음에는 변경 사항을 하나씩 확인하며 진행하는 습관이 안전합니다(특히 삭제·전체 수정 같은 작업).
5. 자주 막히는 점
- “claude: command not found” — 설치 후 터미널을 새로 열거나, 설치 안내에 나온 PATH 적용을 따릅니다.
- 로그인이 안 됨 — Pro 이상 구독 계정인지, 브라우저에서 같은 계정으로 로그인했는지 확인.
- Windows에서 오류 — Git for Windows 설치 여부를 확인하세요.
- 회사 보안/프록시 — 사내 네트워크에서 설치가 막히면 공식 문서의 고급 설정을 참고합니다.
다음 단계
설치를 마쳤다면, 다음은 Claude Code를 제대로 쓰는 법(CLAUDE.md·권한·기본 워크플로우)입니다(순차 발행). 전체 로드맵은 개발자를 위한 클로드 활용법에서 볼 수 있습니다.
본 글은 정보 제공을 목적으로 하며, 설치 명령·요금·사양은 변동될 수 있습니다. 실행 전 공식 문서를 확인하시기 바랍니다.
출처
함께 읽기