단원 목차 · 설치와 첫 세션
- 설치
- 첫 세션
↑ 먼저 — 클로드가 뭔가요
설치 설치
설치
Desktop 앱, VS Code 확장, 터미널 CLI 중 뭘 먼저 깔아야 할지 고민되지 않나요? 하는 일에 맞는 창구 하나만 고르면 충분합니다.
Claude Code는 파일을 직접 열고 고치는 도구입니다. 같은 엔진을 세 창구에서 쓸 수 있다 보니, 막상 설치하려 하면 어디서부터 시작할지 막막해집니다. 답은 셋을 다 아는 것이 아니라 지금 하는 일에 맞는 하나를 고르는 것입니다.
일에 맞는 창구를 고르는 기준은 단순합니다. 터미널을 쓰면 CLI, 코드 편집기를 쓰면 VS Code 확장, 둘 다 낯설면 Desktop 앱입니다. 디자이너라면 시안 폴더를 열어 둔 VS Code에서 확장으로 바로 붙이는 편이 손에 익습니다. 기획자와 마케터는 터미널 없이 시작할 수 있는 Desktop 앱이나 VS Code 확장이 진입 장벽이 낮고, 반복 작업을 자동화까지 이어 붙이려는 경우에만 CLI로 넘어갑니다.
처음이라면 지금 하는 일에 가장 가까운 하나만 고릅니다. 셋을 다 깔 필요는 없고, 나중에 다른 창구가 필요해지면 그때 더합니다. 다만 Claude Code는 무료 claude.ai 플랜에서는 열리지 않습니다. Pro 이상 구독이나 Console 계정으로 로그인해야 하며, 회사 계정으로 팀 안에서 쓴다면 Team·Enterprise 구독 여부를 먼저 확인합니다.
설치 창구 세 개를 전부 까는 것은 안티패턴입니다. 계정 로그인 상태와 접근 권한을 창구마다 따로 확인해야 해서 관리 부담만 늘어납니다. 하나로 시작해 실제로 부족할 때 다음 창구를 더하는 편이 낫습니다.
설치 명령은 위 단계에 정리해 두었습니다. 설치를 마쳤다면 아래 실습으로 Claude Code가 이 폴더를 얼마나 볼 수 있는지 바로 확인해 보세요.
순서
- 일에 맞는 창구를 고릅니다. 터미널을 쓰면 CLI, 코드 편집기를 쓰면 VS Code 확장, 둘 다 낯설면 Desktop 앱입니다.
- CLI는 터미널에서 설치 명령을 실행합니다. macOS·Linux는 curl -fsSL https://claude.ai/install.sh | bash, Windows PowerShell은 irm https://claude.ai/install.ps1 | iex 입니다.
- VS Code 확장은 Extensions 뷰에서 Claude Code를 검색해 설치하고, Desktop 앱은 운영체제에 맞는 설치 파일을 내려받아 실행합니다.
- 설치가 끝나면 터미널에서 claude --version으로 설치를 확인합니다.
- claude를 실행해 브라우저에서 로그인하고, 다른 계정으로 바꿔야 하면 세션 안에서 /login을 입력합니다.
연습
지금 이 폴더에서 네가 접근할 수 있는 범위를 알려줘. 읽기·쓰기 권한이 있는지, 상위 폴더까지 보이는지 3줄 이내로 정리해 줘.
지금 작업할 폴더는 [폴더 이름]이야. 이 폴더 안에 어떤 파일·폴더가 있는지 훑어보고, 시작하기 좋은 파일을 하나 추천해 줘.
위 프롬프트를 실제로 입력해 Claude Code가 폴더 정보를 정확히 답하는지 확인해 보세요.
설치한 Claude Code를 열어 계정으로 로그인된 상태를 확인하면 통과입니다.
막히는 지점
npm으로 설치하면 Node.js 22 이상이 필요합니다. 이 조건이 번거로우면 네이티브 설치 스크립트(curl 또는 irm)를 씁니다. 로그인은 회사 계정과 개인 계정이 섞여 있으면 다른 계정으로 붙는 경우가 있는데, 이때는 세션 안에서 /login으로 다시 인증합니다.
2026-07-13 기준 · 출처 · Setup