Claude Code란? 설치부터 첫 사용까지 완벽 가이드

Claude Code란

Claude Code는 Anthropic이 만든 터미널 기반 AI 코딩 어시스턴트입니다. VS Code 확장 프로그램과 달리 CLI 도구로 실행되는 것이 핵심 특징입니다. 전체 코드베이스를 이해하며, 파일 편집, 새 파일 생성, 명령어 실행, Git 작업까지 한 곳에서 처리할 수 있습니다.

특정 에디터에 의존하지 않기 때문에 어떤 개발 환경에서도 사용할 수 있습니다.

설치

사전 요구 사항

• Node.js 18 이상 설치
• Anthropic 계정 (Max 플랜 또는 API 액세스)

npm으로 설치

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

설치 후 정상적으로 설치되었는지 확인합니다:

claude --version

최초 인증

첫 실행 시 인증이 필요합니다.

claude

명령어를 실행하면 브라우저가 열리고 Anthropic 계정으로 인증하게 됩니다. 인증이 완료되면 터미널로 돌아와 바로 사용할 수 있습니다.

기본 사용법

대화형 모드

프로젝트 루트 디렉토리에서 claude를 입력하면 대화형 세션이 시작됩니다.

cd my-project
claude

세션 내에서 자연어로 지시를 내릴 수 있습니다:

> 이 프로젝트의 구조를 설명해 줘
> src/utils/helper.ts에 유효성 검사 함수를 추가해 줘
> 테스트를 실행하고 모두 통과하는지 확인해 줘

원샷 모드

대화형 세션 없이 단일 명령만 실행하려면 -p 플래그를 사용합니다:

claude -p "package.json의 의존성을 확인하고 사용하지 않는 것을 나열해 줘"

파이프 입력

표준 입력을 통해 데이터를 Claude Code에 전달할 수도 있습니다:

cat error.log | claude -p "이 에러 로그를 분석하고 수정 방법을 제안해 줘"

git diff | claude -p "이 diff를 리뷰해 줘"

유용한 슬래시 명령어

세션 중에 사용할 수 있는 유용한 슬래시 명령어입니다:

명령어	설명
/help	도움말 표시
/clear	대화 기록 초기화
/compact	대화 요약 및 압축
/init	CLAUDE.md 파일 생성
/cost	현재 세션의 토큰 사용량 확인

먼저 해볼 것들

1. 프로젝트 파악하기

> 이 프로젝트의 아키텍처를 설명해 줘

Claude Code가 모든 파일을 분석하고 구조적인 개요를 제공합니다.

2. CLAUDE.md 생성하기

> /init

프로젝트의 규칙과 코딩 컨벤션을 Claude Code에 알려주는 설정 파일을 자동으로 생성합니다.

3. 버그 수정하기

> npm test를 실행하고, 실패하는 테스트를 찾아서 수정해 줘

Claude Code가 테스트 실행, 오류 파악, 코드 수정의 전체 과정을 자동으로 처리합니다.

권한 설정

Claude Code는 파일 편집과 명령어 실행이 가능하므로 각 작업마다 확인을 요청합니다. 신뢰할 수 있는 명령어를 미리 허용하면 확인 과정을 건너뛸 수 있습니다:

// .claude/settings.json
{
  "permissions": {
    "allow": [
      "Read",
      "Bash(npm test)",
      "Bash(npm run lint)"
    ]
  }
}

결론

Claude Code는 설치가 간단하며, 터미널에서 바로 AI 코딩 어시스턴트를 사용할 수 있게 해줍니다. 프로젝트 디렉토리에서 claude를 실행하고 코드 분석이나 리팩토링을 시도해 보세요. 후속 글에서는 다른 AI 도구와의 비교 및 고급 워크플로를 다룰 예정입니다.