설치
Claude 데스크톱 앱과 Claude Code CLI를 설치하고 같은 프로젝트 폴더에서 시작할 수 있습니다
단계 1 / 7
페이지에 macOS용과 Windows용 다운로드 버튼이 보이고 누르면 내려받기 폴더에 설치 파일이 생깁니다.
단계 2 / 7
Claude 앱이 열리고 Code 화면으로 넘어갑니다.
단계 3 / 7
화면에 방금 고른 프로젝트 폴더 이름이 표시됩니다.
단계 4 / 7
macOS는 command와 스페이스를 함께 눌러 Spotlight 검색을 열고 Terminal을 입력한 뒤 엔터를 누르며, Linux는 control과 alt와 T를 함께 누릅니다. 창이 열리면 아래 명령어 토글을 펼쳐 설치 명령을 붙여넣고 엔터를 누릅니다.
글자가 한동안 흐른 뒤 Claude Code successfully installed! 문장이 나옵니다.
claude.ai에서 설치 파일을 내려받아 그대로 실행하는 명령입니다. macOS와 Linux에서 공식 문서가 권장하는 방식이며 Node.js를 미리 설치하지 않아도 됩니다.
curl -fsSL https://claude.ai/install.sh | bash
단계 5 / 7
윈도우 키와 X를 함께 누른 뒤 메뉴에서 Windows PowerShell 또는 터미널을 고릅니다. 창이 열리면 아래 명령어 토글을 펼쳐 설치 명령을 붙여넣고 엔터를 누릅니다.
글자가 한동안 흐른 뒤 Claude Code successfully installed! 문장이 나옵니다.
irm이 claude.ai에서 설치 파일을 가져오고 iex가 그 파일을 실행합니다. Windows PowerShell에서 공식 문서가 권장하는 명령입니다.
irm https://claude.ai/install.ps1 | iex
단계 6 / 7
첫 명령에서 2.1.211 (Claude Code)처럼 버전 번호가 나오고 둘째 명령에서 점검 결과가 나옵니다.
첫 줄은 설치된 버전을 출력합니다. 둘째 줄은 세션을 시작하지 않고 설치 상태와 설정 파일을 점검한 결과를 보여 줍니다.
claude --version claude doctor
단계 7 / 7
지금 선택한 프로젝트 폴더의 이름과 최상위 파일·폴더 이름만 보여 줘. 파일은 아직 고치지 마.
앱에서 본 것과 같은 프로젝트 이름과 최상위 목록이 나오고 파일은 하나도 바뀌지 않습니다.
첫 줄은 터미널이 보고 있는 위치를 그 폴더로 옮깁니다. cd를 입력하고 한 칸 띄운 다음 Finder나 파일 탐색기에서 폴더를 창 안으로 끌어다 놓으면 경로가 대신 입력됩니다. 둘째 줄은 그 폴더에서 Claude Code를 시작합니다.
cd 프로젝트-폴더-경로 claude