Claude Code 설치

얻어갈 것

• Windows와 macOS에서 Claude Code를 설치합니다.
• 설치 후 claude 명령 실행과 로그인까지 확인합니다.

설치 전에 확인할 것

• Claude Code는 코딩 에이전트입니다. 자세한 사용법은 뒤의 Claude Code 챕터에서 따로 다룹니다.
• 요금제와 사용량 제한은 바뀔 수 있으므로, 수업 직전에 Claude pricing에서 현재 플랜을 확인합니다.
• Claude Code 결제는 미리 진행해 주셔야 합니다.

Windows 설치 흐름

1. Git for Windows를 먼저 설치합니다. 설치 옵션은 기본값으로 진행합니다.
2. PowerShell을 새로 열고 Claude Code 설치 명령을 실행합니다.
3. 설치가 끝나면 환경 변수에 Claude Code 실행 경로를 추가합니다.
4. PowerShell을 완전히 닫고 새로 엽니다.
5. 새 PowerShell에서 claude 명령을 실행해 설치를 확인합니다.

Windows에서는 먼저 Git을 설치합니다. Claude Code 자체를 쓰기 위한 준비이기도 하고, 이후 코드 변경 내역을 다루는 기본 도구가 되기 때문입니다.

확대

설치 마법사가 열리면 특별히 바꿀 옵션은 거의 없습니다. 처음 설치라면 기본값으로 진행하는 편이 안전합니다.

확대

Git 설치가 끝나면 PowerShell을 엽니다. 앞으로 설치 명령이나 Claude Code 실행 명령은 이런 터미널 창에 입력하게 됩니다.

확대

아래 명령은 PowerShell에서 Claude Code 설치 스크립트를 실행하는 단계입니다. 명령어는 한 글자만 틀려도 실패할 수 있으니 직접 타이핑하기보다 복사해서 붙여넣는 편이 좋습니다.

PS>irm https://claude.ai/install.ps1 | iex

설치가 진행되는 동안에는 터미널에 여러 줄의 로그가 지나갑니다. 에러가 아니라면 중간에 닫지 말고, 완료 메시지가 나올 때까지 기다립니다.

확대

설치가 된 후에는 환경 변수 작업을 진행합니다. 아래 명령어를 PowerShell에서 실행하면 Claude Code 실행 파일이 있는 폴더를 사용자 Path에 추가합니다.

PS>[Environment]::SetEnvironmentVariable("Path", [Environment]::GetEnvironmentVariable("Path", "User") + ";$env:USERPROFILE\.local\bin", "User")

이 명령까지 실행한 뒤에는 PowerShell 창을 완전히 닫고 새로 열어야 합니다. 이미 열려 있던 PowerShell에는 방금 바꾼 환경 변수가 바로 반영되지 않을 수 있습니다.

새 PowerShell을 열고 claude 명령이 인식되는지 확인합니다. 여기서 명령을 찾을 수 없다고 나오면 PowerShell을 닫고 새로 열었는지부터 다시 확인합니다.

PS>claude

확대

macOS 설치 흐름

macOS에서는 흐름이 더 단순합니다. 터미널을 열고 설치 명령을 실행한 뒤, 새 터미널에서 claude 명령이 되는지만 확인하면 됩니다.

1. macOS에서는 Cmd + Space로 Spotlight를 열고, Terminal을 실행합니다
2. 터미널에서 아래 명령어를 실행해주세요

$curl -fsSL https://claude.ai/install.sh | bash
$claude

로그인과 완료 확인

• claude 명령이 실행되면 브라우저 로그인 또는 터미널 안내를 따라 계정을 연결합니다.
• 다음 레슨에서는 Claude Code를 VS Code 안의 터미널과 함께 쓰기 위한 화면 구성을 잡습니다.

처음 실행하면 로그인 안내가 나옵니다. 여기서는 코딩을 바로 시작하는 것이 아니라, 내 Claude 계정과 터미널의 Claude Code를 연결하는 단계라고 보면 됩니다.

확대

로그인이 끝나고 Claude Code 화면이 정상적으로 뜨면 설치 확인은 끝입니다. 이 화면까지 왔다면 다음 레슨에서 VS Code 터미널 안에 Claude Code를 배치할 수 있습니다.

확대