06/02/2026 · zyss

Claude Code 설치 방법: 계정 로그인으로 시작하는 터미널 코딩 도우미

Claude Code 공식 홈페이지에 소개된 Claude Code는 Anthropic이 만든 터미널용 AI 코딩 도우미입니다. 명령어 창에서 Claude에게 코드 설명, 오류 찾기, 수정 계획 작성을 부탁할 수 있습니다.

처음 쓰는 사람도 따라 할 수 있도록 사용 가능 조건, 설치, 계정 로그인, API 키 사용 상황, 첫 프롬프트 순서로 정리했습니다.

1. 사용 가능 조건 확인하기

Claude Code는 설치 명령어를 실행한다고 해서 모든 무료 계정에서 바로 사용할 수 있는 도구는 아닙니다. Claude Pro 또는 Max 같은 구독, Team 또는 Enterprise 같은 조직 권한, 또는 Anthropic API 키가 필요할 수 있습니다.

무료 계정으로 시도하면 로그인은 되더라도 사용량이나 권한 문제로 실행이 제한될 수 있습니다. 설치 전에 내 계정이 Claude Code 사용을 지원하는지 먼저 확인하는 것이 좋습니다.

Claude Code를 설치하려면 Node.js와 npm이 필요합니다. 아래 명령어로 설치되어 있는지 확인합니다.

node -v
npm -v

버전 번호가 나오면 준비가 된 것입니다. Claude Code 공식 문서는 Node.js 18 이상을 요구합니다.

Claude Code 설치 매뉴얼 기준으로, 터미널을 열고 아래 명령어를 실행합니다.

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

공식 문서는 권한 문제와 보안 위험 때문에 sudo npm install -g 방식은 권장하지 않습니다.

설치가 끝나면 아래 명령어로 Claude Code를 실행합니다.

claude

처음 실행하면 브라우저 로그인이나 인증 안내가 나올 수 있습니다. 기본은 Claude 계정으로 로그인하는 방식입니다. 전체 기능 개요는 Claude Code 한글 개요 문서에서 확인할 수 있습니다.

일반 사용자는 계정 로그인으로 시작하면 됩니다. API 키는 서버 자동화, CI/CD, 백엔드 연동처럼 사람이 직접 로그인하기 어려운 환경에서 필요할 수 있습니다.

필요한 경우 Anthropic API 키 발급 페이지에서 API 키를 만들 수 있습니다. API 키는 비밀번호처럼 중요한 값이므로 글이나 채팅에 그대로 붙여넣지 않습니다.

고치고 싶은 코드가 있는 폴더로 이동한 뒤 Claude Code를 실행합니다.

cd my-project
claude

설치 상태를 점검하고 싶으면 아래 명령어를 사용할 수 있습니다.

claude doctor

처음에는 코드를 바로 고치게 하기보다 설명을 먼저 부탁하는 것이 안전합니다.

이 프로젝트의 폴더 구조를 보고, 어떤 기능을 하는지 초등학생도 이해할 수 있게 설명해줘.

수정을 맡기고 싶다면 먼저 계획을 세우게 합니다.

오류 원인을 먼저 분석하고, 수정 계획을 단계별로 설명한 뒤 필요한 파일만 수정해줘.