Claude Code 설치와 첫 사용법: 10분 안에 첫 작업 맡기기 (2026년 기준)

핵심 요약: 2026년 기준 Claude Code 설치는 네이티브 인스톨러(공식 권장, Node.js 불필요)로 명령어 한 줄이면 끝납니다. 과거의 npm 설치(@anthropic-ai/claude-code)도 아직 동작하지만 2026년 1월부터 공식적으로는 네이티브 방식을 권장합니다. 설치 후 순서는 셋입니다: `claude` 실행 → 브라우저로 계정 로그인(Pro 이상 구독 필요) → 프로젝트 폴더에서 `/init`으로 CLAUDE.md 생성. 여기까지 10분이면 첫 작업을 맡길 수 있습니다.

이 글에서 다루는 내용: 요구사항, OS별 설치, 로그인과 초기 설정, 첫 작업 예시, 초반에 알아두면 좋은 명령어.

설치 전 확인

요구사항: macOS 13 이상, Ubuntu 20.04+/Debian 10+, Windows 10 이상(WSL 권장), RAM 4GB 이상(8GB 권장), 그리고 Claude Pro 이상 구독 계정(또는 API 계정). 구독이 없다면 요금 선택 기준을 Pro vs Max 글에서 먼저 확인하세요.

설치: 네이티브 인스톨러 (권장)

공식 문서(code.claude.com/docs)의 설치 명령을 터미널에 붙여넣으면 됩니다. Node.js 같은 사전 의존성이 필요 없고, 업데이트도 자체적으로 처리됩니다. 참고로 npm 방식(`npm install -g @anthropic-ai/claude-code`)은 2026년 1월부터 deprecated 상태입니다 — 아직 동작하지만 신규 설치라면 네이티브 방식을 쓰세요. 기존 npm 설치 사용자는 제거 후 네이티브로 갈아타면 됩니다.

로그인과 시작

터미널에서 프로젝트 폴더로 이동한 뒤 `claude`를 실행하면 첫 실행 시 브라우저가 열리며 계정 로그인을 요청합니다. Pro/Max 구독 계정으로 로그인하면 끝. 이후 터미널에 대화형 프롬프트가 뜨고, 여기에 자연어로 지시하면 됩니다.

필수 초기 설정: /init으로 CLAUDE.md 만들기

프로젝트에서 처음 쓸 때 /init을 실행하세요. 코드베이스를 분석해 빌드 명령, 코드 관례, 아키텍처 요약이 담긴 CLAUDE.md 초안을 만들어줍니다. 이 파일은 매 세션에 로드되는 "프로젝트 사용 설명서"로, Cursor Rules에 해당하는 역할입니다. 초안을 그대로 두지 말고 팀 관례("테스트는 pytest", "커밋은 내가 직접" 등)를 추가하면 결과물 품질이 확 달라집니다. 작성 요령은 별도 글로 다룰 예정입니다.

첫 작업으로 좋은 것들

처음부터 수정 작업을 맡기기보다 읽기 작업으로 시작하는 걸 권합니다. ① "이 프로젝트 구조와 주요 모듈을 설명해줘" — 코드베이스 이해도를 확인 ② "이 함수가 어디서 쓰이는지 찾아줘" — 탐색 능력 확인 ③ 그다음 작은 수정: "이 파일의 타입힌트를 보강하고 테스트 돌려줘". 수정·명령 실행 전에 승인을 요청하는 기본 동작을 이 과정에서 자연스럽게 익히게 됩니다.

초반에 유용한 명령어

/init CLAUDE.md 생성 · /help 명령 목록 · /clear 대화 컨텍스트 초기화(새 작업 시작 시) · /compact 긴 대화 요약으로 컨텍스트 절약 · Esc 진행 중 작업 중단. 이 다섯 개면 초반 운용에 충분합니다.

설치하며 겪은 소소한 것들

제 경우 설치 자체는 몇 분이었고, 시간을 쓴 건 CLAUDE.md였습니다. /init이 만들어준 초안이 생각보다 충실해서 놀랐는데, 거기에 "마이그레이션은 직접 실행하지 말 것" 같은 우리 프로젝트의 금기 몇 줄을 추가하고 나서야 진짜 내 도구가 된 느낌이었습니다. 하나 팁을 주자면, 첫날 너무 큰 작업을 맡기지 마세요. 저는 첫날 의욕적으로 리팩토링을 통째로 맡겼다가 승인 요청의 의미도 모른 채 Enter만 연타했는데, 돌아보면 도구를 익히는 순서가 거꾸로였습니다. 읽기 → 작은 수정 → 덩어리 위임 순서가 맞습니다.

자주 묻는 질문 (FAQ)

Q. Windows에서 WSL 없이 쓸 수 있나요?

A. Windows 네이티브 지원이 제공되지만 WSL 환경이 더 매끄러운 경우가 많습니다. 개발 환경이 이미 WSL이라면 그 안에 설치하는 것을 권합니다.

Q. 로그인에 API 키가 필요한가요?

A. 구독(Pro/Max) 사용자는 계정 로그인만으로 됩니다. API 키 방식은 종량제(API) 결제로 쓸 때의 선택지입니다.

Q. 회사 프록시 환경에서 설치가 막혀요.

A. 네트워크 정책으로 설치 스크립트나 API 접속이 차단된 경우입니다. 프록시 환경 변수 설정을 확인하고, 조직 정책상 허용 여부를 먼저 확인하세요.

Q. 업데이트는 어떻게 하나요?

A. 네이티브 설치는 자동 업데이트됩니다. 버전 확인은 `claude --version`으로 할 수 있습니다.

한눈에 보는 요약

네이티브 인스톨러로 설치 → `claude` 실행 후 로그인 → `/init`으로 CLAUDE.md 생성 → 읽기 작업부터 시작. npm 설치는 deprecated이니 신규는 네이티브로. 첫날의 목표는 큰 성과가 아니라 승인 흐름과 CLAUDE.md에 익숙해지는 것입니다.

함께 보면 좋은 글

Claude Code 완전 정리 (2026년 기준)
Claude Code 요금: Pro vs Max
Claude Code란? 터미널 에이전트가 뭐가 다른가

참고 자료

Claude Code 공식 설치 문서
Claude 헬프센터 (설치·인증 문제 해결)