설치와 초기 설정

요구 사항

• Node.js 18 이상 (npm 설치 방식일 때)
• Git (권장 — 변경 이력 추적과 되돌리기가 쉬워집니다)
• Claude 계정 (Pro / Max 구독 또는 API 크레딧)

설치

npm install -g @anthropic-ai/claude-code

설치 후 확인합니다.

claude --version

Windows에서는 PowerShell을 관리자 권한으로 열거나, WSL2 환경을 쓰는 편이 경로 문제를 덜 겪습니다.

첫 실행

작업할 프로젝트 폴더로 이동한 다음 실행합니다.

cd ~/projects/my-app
claude

처음 실행하면 브라우저가 열리며 로그인을 요구합니다. 인증이 끝나면 자격 증명이 로컬에 저장되고, 이후에는 바로 세션이 시작됩니다.

초기에 해두면 좋은 두 가지

1. 프로젝트 지침 파일 만들기

세션 안에서 다음을 실행하면 저장소를 훑어 CLAUDE.md 초안을 만들어 줍니다.

/init

이 파일에는 빌드 명령, 코드 컨벤션, 하지 말아야 할 일 등을 적습니다. 자세한 내용은 CLAUDE.md 작성법을 참고하세요.

2. 권한 모드 이해하기

기본값은 파일 수정이나 명령 실행 전에 매번 확인을 요청하는 모드입니다. 익숙해지기 전까지는 이 기본값을 유지하는 편이 안전합니다. 반복 확인이 번거로우면 자주 쓰는 읽기 전용 명령만 허용 목록에 넣으세요.

자주 겪는 문제

• **command not found** — npm 전역 설치 경로가 PATH에 없습니다. npm bin -g 결과를 셸 설정 파일에 추가하세요.
• 로그인 창이 안 열림 — 원격 서버라면 터미널에 출력된 URL을 로컬 브라우저에 직접 붙여넣으면 됩니다.
• 응답이 느림 — 저장소가 크면 첫 탐색에 시간이 걸립니다. 관련 폴더를 지정해 범위를 좁히세요.

다음은 첫 세션 실전입니다.