Claude Code 설치
Claude Code는 Anthropic의 공식 CLI 개발 도구입니다. 터미널에서 Claude AI를 활용하여 코드 작성, 오류 수정, 프로젝트 구조 개선 등의 개발 작업을 수행할 수 있습니다.사전 요구사항
시작하기 전에 아래 프로그램들이 모두 설치되어 있는지 확인하세요.| 필요 프로그램 | 최소 버전 | 설명 | 설치 가이드 |
|---|---|---|---|
| Windows | 10 이상 | 운영체제 | - |
| Node.js | 18 이상 | JavaScript 실행 환경. Claude Code를 설치하는 데 필요한 npm(패키지 관리자)이 함께 설치됩니다. | nodejs.org에서 LTS 버전 다운로드 |
| Git for Windows | 최신 버전 | 코드 버전 관리 도구. Claude Code가 프로젝트 파일을 다루는 데 필요합니다. | Git 설치 가이드 |
| Claude 계정 | - | Anthropic 계정 및 API 접근 권한 | claude.ai에서 가입 |
Node.js가 뭔가요? Node.js는 JavaScript라는 프로그래밍 언어를 컴퓨터에서 실행할 수 있게 해주는 프로그램입니다. Claude Code가 JavaScript로 만들어져 있기 때문에 Node.js가 필요합니다. Node.js를 설치하면 npm이라는 프로그램이 함께 설치되는데, npm은 다양한 도구를 쉽게 설치할 수 있게 해주는 패키지 관리자입니다.
설치 방법
터미널(PowerShell 또는 명령 프롬프트)을 열고 다음 명령어를 입력한 후 Enter 키를 누르세요.npm install: npm을 사용하여 프로그램을 설치합니다-g: “global”의 약자로, 컴퓨터 어디에서든 이 프로그램을 사용할 수 있게 설치합니다@anthropic-ai/claude-code: 설치할 프로그램의 이름입니다
claude 명령어를 입력하여 Claude Code를 실행할 수 있습니다.
Claude Code 첫 실행 및 Git 미설치 경고
설치 후 터미널에서 
claude를 입력하여 실행하면 Claude Code 화면이 나타납니다.“로컬 세션에는 Git이 필요합니다. Windows용 Git 다운로드하거나 CLAUDE_CODE_GIT_BASH_PATH 환경 변수를 git 실행 파일로 설정한 후 다시 시작하세요.”이 경고가 보인다면 Git for Windows 설치 가이드를 참고하여 Git을 먼저 설치한 후, 터미널을 닫았다가 다시 열어서
claude 명령어를 실행하세요.설치 확인
터미널에서 다음 명령어를 입력하여 Claude Code가 제대로 설치되었는지 확인할 수 있습니다.문제 해결
설치 중 문제가 발생했다면 아래 내용을 확인해보세요.| 문제 | 원인 | 해결 방법 |
|---|---|---|
| Git 미설치 경고 | Git이 설치되지 않았거나, 터미널이 Git을 찾지 못함 | Git for Windows를 설치한 후 터미널을 재시작하세요 |
| ’npm’을 찾을 수 없습니다 | Node.js가 설치되지 않았거나, PATH에 등록되지 않음 | nodejs.org에서 Node.js LTS 버전을 설치하세요. 설치 시 “Add to PATH” 옵션이 체크되어 있는지 확인하세요 |
| 권한 오류 (EACCES) | 설치 폴더에 쓰기 권한이 없음 | 터미널을 관리자 권한으로 실행하세요 (터미널 아이콘 우클릭 > “관리자 권한으로 실행”) |